channel-{func,type}.c, channel.scm: Update documentation.

* src/channel-func.c (guile_ssh_channel_open_session): Update
  the documentation string.
* src/channel-type.c: Update comments.
* src/channel.scm: Likewise.