X-Git-Url: http://git.cielonegro.org/gitweb.cgi?p=Lucu.git;a=blobdiff_plain;f=Network%2FHTTP%2FLucu%2FMIMEType.hs;fp=Network%2FHTTP%2FLucu%2FMIMEType.hs;h=4b509bf1e1a25f0d23bff16efc700debde2dcd0b;hp=36cdf0f82797b491783e9fd8ad1cac48fc2848ff;hb=9668dc27a02b59d7bfb1e9e40af3d2619700ad69;hpb=f402841101b4b84f263eea1a43c848f81c48ff93

diff --git a/Network/HTTP/Lucu/MIMEType.hs b/Network/HTTP/Lucu/MIMEType.hs
index 36cdf0f..4b509bf 100644
--- 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