Minor documentation enhancements

source/Network/Xmpp.hs

@@ -32,7 +32,7 @@ module Network.Xmpp
     -- TODO: Close session, etc.
     -- ** Authentication handlers
     -- | The use of 'scramSha1' is /recommended/, but 'digestMd5' might be
-    -- useful for interaction with older implementation
+    -- useful for interaction with older implementations.
   , scramSha1
   , plain
   , digestMd5

source/Network/Xmpp/Concurrent.hs

@@ -126,9 +126,8 @@ writeWorker stCh writeR = forever $ do
 
 -- | Creates a 'Session' object by setting up a connection with an XMPP server.
 --
--- Will connect to the specified host. If the fourth parameters is a 'Just'
+-- Will connect to the specified host with the provided configuration. If the
--- value, @session@ will attempt to secure the connection with TLS. If the fifth
+-- third parameter is a 'Just' value, @session@ will attempt to authenticate and
--- parameters is a 'Just' value, @session@ will attempt to authenticate and
 -- acquire an XMPP resource.
 session :: HostName                          -- ^ The hostname / realm
         -> SessionConfiguration              -- ^ configuration details

source/Network/Xmpp/Utilities.hs

@@ -87,8 +87,9 @@ message = Message { messageID      = Nothing
                   , messagePayload = []
                   }
 
--- Produce an answer message with the given payload, switching the "from" and
+-- | Produce an answer message with the given payload, switching the "from" and
--- "to" attributes in the original message.
+-- "to" attributes in the original message. Produces a 'Nothing' value of the
+-- provided message message has no from attribute.
 answerMessage :: Message -> [Element] -> Maybe Message
 answerMessage Message{messageFrom = Just frm, ..} payload =
     Just Message{ messageFrom    = messageTo