Add docs for internal http modules

lib/proto/http/content_type.rs

@@ -1,3 +1,5 @@
+//! Common MIME types for HTTP responses.
+
 use crate::{headers::ContentType, Header};
 
 use super::mime::{self, Mime};

lib/proto/http/date.rs

@@ -1,3 +1,5 @@
+//! HTTP date formatting.
+
 const DAYS: [&str; 7] = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
 const MONTHS: [&str; 12] = [
     "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec",
@@ -15,7 +17,7 @@ fn days_in_month(month: u8, year: u16) -> u8 {
     }
 }
 
-/// Returns the current date in the IMF-fixdate format.
+/// Returns the specified epoch (seconds) in the IMF-fixdate format.
 /// Example: `Sun, 06 Nov 1994 08:49:37 GMT`
 pub fn imp_date(epoch: u64) -> String {
     let seconds = epoch % 60;

lib/proto/http/headers.rs

@@ -1,3 +1,5 @@
+//! Contains all the header structs that can be used with HTTP requests and responses.
+
 use std::{borrow::Cow, fmt::Display};
 
 use crate::{

lib/proto/http/method.rs

@@ -1,3 +1,5 @@
+//! HTTP Methods.
+
 use std::{fmt, str::FromStr};
 
 /// HTTP Methods.

lib/proto/http/mime.rs

@@ -1,5 +1,8 @@
+//! Mime types used in headers.
+
 use std::{borrow::Cow, fmt::Display};
 
+/// A MIME type.
 pub struct Mime {
     r#type: Cow<'static, str>,
     subtype: Cow<'static, str>,
@@ -34,7 +37,10 @@ macro_rules! mime {
 
 macro_rules! define_mimes {
     ($($name:ident => $_type:ident / $_subtype:ident),*) => {
-        $( pub const $name: Mime = mime!($_type / $_subtype); )*
+        $(
+            #[doc = concat!("The ", stringify!($name), " MIME type. (`", stringify!($_type), "/", stringify!($_subtype), "`)")]
+            pub const $name: Mime = mime!($_type / $_subtype);
+        )*
     };
 }
 

lib/proto/http/query.rs

@@ -1,3 +1,5 @@
+//! Query parameters for HTTP requests.
+
 use std::{
     fmt,
     ops::{Deref, DerefMut},