fix documentation error

pull* functions don't create on-the-fly copies of channels any more

source/Network/Xmpp.hs

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

source/Network/Xmpp/Concurrent/Message.hs

@@ -8,8 +8,8 @@ import Network.Xmpp.Types
 import Network.Xmpp.Concurrent.Types
 import Network.Xmpp.Concurrent.Basic
 
--- | Read an element from the inbound stanza channel, acquiring a copy of the
--- channel as necessary.
+-- | Read an element from the inbound stanza channel, discardes any
+-- non-Message stanzas from the channel
 pullMessage :: Session -> IO (Either MessageError Message)
 pullMessage session = do
     stanza <- atomically . readTChan $ stanzaCh session

source/Network/Xmpp/Concurrent/Presence.hs

@@ -7,8 +7,8 @@ import Network.Xmpp.Types
 import Network.Xmpp.Concurrent.Types
 import Network.Xmpp.Concurrent.Basic
 
--- | Read an element from the inbound stanza channel, acquiring a copy of the
--- channel as necessary.
+-- | Read an element from the inbound stanza channel, discardes any non-Presence
+-- stanzas from the channel
 pullPresence :: Session -> IO (Either PresenceError Presence)
 pullPresence session = do
     stanza <- atomically . readTChan $ stanzaCh session