Haddock overhaul

[Lucu.git] / Network / HTTP / Lucu / MIMEType.hs

diff --git a/Network/HTTP/Lucu/MIMEType.hs b/Network/HTTP/Lucu/MIMEType.hs
index 36cdf0f82797b491783e9fd8ad1cac48fc2848ff..4b509bf1e1a25f0d23bff16efc700debde2dcd0b 100644 (file)
--- a/Network/HTTP/Lucu/MIMEType.hs
+++ b/Network/HTTP/Lucu/MIMEType.hs
@@ -3,7 +3,7 @@
   , UnicodeSyntax
   #-}
 
--- |Manipulation of MIME Types.
+-- |MIME Types
 module Network.HTTP.Lucu.MIMEType
     ( MIMEType(..)
     , mkMIMEType
@@ -27,8 +27,8 @@ import Network.HTTP.Lucu.RFC2231
 import Prelude hiding (min)
 import Prelude.Unicode
 
--- |@'MIMEType' \"major\" \"minor\" [(\"name\", \"value\")]@
--- represents \"major\/minor; name=value\".
+-- |@'MIMEType' \"major\" \"minor\" [(\"name\", \"value\"), ...]@
+-- represents \"major\/minor; name=value; ...\".
 data MIMEType = MIMEType {
       mtMajor  ∷ !CIAscii
     , mtMinor  ∷ !CIAscii
@@ -38,13 +38,14 @@ data MIMEType = MIMEType {
 instance Show MIMEType where
     show = A.toString ∘ A.fromAsciiBuilder ∘ printMIMEType
 
--- |Construct a 'MIMEType' without any parameters.
+-- |@'mkMIMEType' major minor@ returns a 'MIMEType' with the given
+-- @major@ and @minor@ types but without any parameters.
 mkMIMEType ∷ CIAscii → CIAscii → MIMEType
 {-# INLINE mkMIMEType #-}
 mkMIMEType maj min
     = MIMEType maj min (∅)
 
--- |Convert a 'MIMEType' to 'AsciiBuilder'.
+-- |Convert a 'MIMEType' to an 'AsciiBuilder'.
 printMIMEType ∷ MIMEType → AsciiBuilder
 {-# INLINEABLE printMIMEType #-}
 printMIMEType (MIMEType maj min params)
@@ -68,6 +69,7 @@ parseMIMEType str
              endOfInput
              return t
 
+-- |'Parser' for an 'MIMEType'.
 mimeTypeP ∷ Parser MIMEType
 {-# INLINEABLE mimeTypeP #-}
 mimeTypeP = do maj    ← A.toCIAscii <$> token
@@ -76,6 +78,7 @@ mimeTypeP = do maj    ← A.toCIAscii <$> token
                params ← paramsP
                return $ MIMEType maj min params
 
+-- |'Parser' for a list of 'MIMEType's.
 mimeTypeListP ∷ Parser [MIMEType]
 {-# INLINE mimeTypeListP #-}
 mimeTypeListP = listOf mimeTypeP