Reformat channel_get_session() and improve docu.

git-svn-id: svn+ssh://svn.berlios.de/svnroot/repos/libssh/trunk@703 7dcaeef0-15fb-0310-b436-a5af3365683c

libssh/channels.c

@@ -1622,11 +1622,14 @@ int channel_poll(CHANNEL *channel, int is_stderr){
   return buffer_get_rest_len(stdbuf);
 }
 
-/** \brief recover the session in which belong a channel
+/**
- * \param channel channel
+ * @brief Recover the session in which belongs a channel.
- * \return the session pointer
+ *
+ * @param channel       The channel to recover the session from.
+ *
+ * @return The session pointer.
  */
-SSH_SESSION *channel_get_session(CHANNEL *channel){
+SSH_SESSION *channel_get_session(CHANNEL *channel) {
   return channel->session;
 }