Changed some module's name

[time-http.git] / Data / Time / RFC1123.hs

diff --git a/Data/Time/RFC1123.hs b/Data/Time/RFC1123.hs
index bf68f057704661b6b7b9617a6068761fff441213..93aeb7e2d924d0a5ee85112c376835a6baac7b0b 100644 (file)
--- a/Data/Time/RFC1123.hs
+++ b/Data/Time/RFC1123.hs
@@ -1,23 +1,26 @@
+-- |This module provides functions to parse and format RFC 1123 date
+-- and time formats.
+--
+-- The format is basically same as RFC 822, but the syntax for @date@
+-- is changed from:
+--
+-- > year ::= 2DIGIT
+--
+-- to:
+--
+-- > year ::= 4DIGIT
 module Data.Time.RFC1123
     ( format
     , parse
     )
     where
-
-import qualified Text.Parsec as P
-
 import Data.Time
 import Data.Time.Calendar.WeekDate
 import Data.Time.HTTP.Common
 import Data.Time.RFC822 (showRFC822TimeZone)
-import Data.Time.RFC1123.Parsec
-
-{-
-         The syntax for the date is hereby changed to:
-
-            date = 1*2DIGIT month 2*4DIGIT
--}
+import Data.Time.RFC1123.Internal
 
+-- |Format a 'ZonedTime' in RFC 1123.
 format :: ZonedTime -> String
 format zonedTime
     = let localTime          = zonedTimeToLocalTime zonedTime
@@ -43,6 +46,8 @@ format zonedTime
                , showRFC822TimeZone timeZone
                ]
 
+-- |Parse an RFC 1123 date and time string. When the string can't be
+-- parsed, it returns 'Nothing'.
 parse :: String -> Maybe ZonedTime
 parse src = case P.parse p "" src of
               Right zt -> Just zt