Add some more documentation after lint fixes

Author: sfackler

src/postgres/error.rs

@@ -1,3 +1,6 @@
+// Can't attach docs to enum variants in the macro
+#[allow(missing_doc)];
+
 macro_rules! make_errors(
     ($($code:pat => $error:ident),+) => (
         // TODO: Get rid of this module when mozilla/rust#4375 is fixed

src/postgres/lib.rs

@@ -141,12 +141,26 @@ impl PostgresNoticeHandler for DefaultNoticeHandler {
 /// Reasons a new Postgres connection could fail
 #[deriving(ToStr)]
 pub enum PostgresConnectError {
+    /// The provided URL could not be parsed
     InvalidUrl,
+
+    /// The URL was missing a user
     MissingUser,
+
+    /// DNS lookup failed
     DnsError,
+
+    /// There was an error opening a socket to the server
     SocketError,
+
+    /// An error from the Postgres server itself
     DbError(PostgresDbError),
+
+    /// A password was required but not provided in the URL
     MissingPassword,
+
+    /// The Postgres server requested an authentication method not supported
+    /// by the driver
     UnsupportedAuthentication
 }
 
@@ -157,7 +171,9 @@ pub enum PostgresErrorPosition {
     Position(uint),
     /// A position in an internally generated query
     InternalPosition {
+        /// The byte position
         position: uint,
+        /// A query generated by the Postgres server
         query: ~str
     }
 }

src/postgres/types.rs

@@ -106,7 +106,9 @@ impl PostgresType {
 
 /// The wire format of a Postgres value
 pub enum Format {
+    /// A user-readable string format
     Text = 0,
+    /// A machine-readable binary format
     Binary = 1
 }