X-Git-Url: http://gitweb.michael.orlitzky.com/?p=dead%2Fhalcyon.git;a=blobdiff_plain;f=src%2FTwitter%2FHttp.hs;h=d7135cec3b058b4c93093fafd572612625354666;hp=ddd68284ae91d22f94b7e5beb90a433630a51804;hb=69b8af30f49aaad0f5c051998d2556b9ec291df7;hpb=17dd116706c4a971e1f5c68daa1656af5eff5cd2

diff --git a/src/Twitter/Http.hs b/src/Twitter/Http.hs
index ddd6828..d7135ce 100644
--- a/src/Twitter/Http.hs
+++ b/src/Twitter/Http.hs
@@ -4,8 +4,11 @@ where
 import Network.Curl
 import System.IO (hPutStrLn, stderr)
 
---    
--- http://dev.twitter.com/doc/get/statuses/user_timeline
+-- |The API URL of username's timeline.
+--
+-- See,
+--
+--   <http://dev.twitter.com/doc/get/statuses/user_timeline>
 --
 user_timeline_url :: String -> String
 user_timeline_url username =
@@ -14,12 +17,16 @@ user_timeline_url username =
              "&include_rts=true",
              "&count=10" ]
 
+-- |Given username's last status id, constructs the API URL for
+-- username's new statuses. Essentially, 'user_timeline_url' with a
+-- "since_id" parameter tacked on.
 user_new_statuses_url :: String -> Integer -> String
 user_new_statuses_url username last_status_id =
     concat [ user_timeline_url username,
              "&since_id=" ++ (show last_status_id) ]
 
-                               
+
+-- |Return's username's timeline, or 'Nothing' if there was an error.
 get_user_timeline :: String -> IO (Maybe String)
 get_user_timeline username = do
   let uri = (user_timeline_url username)
@@ -27,13 +34,17 @@ get_user_timeline username = do
   return timeline
 
 
+-- Returns the XML representing all of username's statuses that are
+-- newer than last_status_id.
 get_user_new_statuses :: String -> Integer -> IO (Maybe String)
 get_user_new_statuses username last_status_id = do
   let uri = (user_new_statuses_url username last_status_id)
   new_statuses <- (http_get uri)
   return new_statuses
 
-         
+
+-- |Uses the CURL API to retrieve uri. Returns 'Nothing' if there was
+-- an error.
 http_get :: String -> IO (Maybe String)
 http_get uri = withCurlDo $ do
   resp <- curlGetString uri [CurlTimeout 45]