Haddock comments

[time-w3c.git] / Data / Time / W3C / Parser.hs

diff --git a/Data/Time/W3C/Parser.hs b/Data/Time/W3C/Parser.hs
index 64f96b28e2f79259f80d0279dca056cc9afee5df..5bf2f9e674315d32092568d9d154b0bc8a257fae 100644 (file)
--- a/Data/Time/W3C/Parser.hs
+++ b/Data/Time/W3C/Parser.hs
@@ -1,3 +1,4 @@
+-- | Parse W3C Date and Time string.
 module Data.Time.W3C.Parser
     ( parse
     )
@@ -9,8 +10,15 @@ import Data.Convertible
 import Data.Time.W3C.Parser.Parsec
 import Data.Time.W3C.Types
 
+-- | Parse W3C Date and Time string to anything convertible from
+-- 'W3CDateTime' type. The most obvious acceptable type is the
+-- 'W3CDateTime' itself. If the given string is ill-formatted, 'parse'
+-- returns 'Prelude.Nothing'.
 parse :: Convertible W3CDateTime t => String -> Maybe t
-parse src
-    = case P.parse w3cDateTime "" src of
-        Right w3c -> Just (convert w3c)
-        Left  _   -> Nothing
+parse src = case P.parse p "" src of
+              Right w3c -> Just (convert w3c)
+              Left  _   -> Nothing
+    where
+      p = do w3c <- w3cDateTime
+             _   <- P.eof
+             return w3c
\ No newline at end of file