add missing return value in function docu

In session.c the function ssh_handle_packets() can return SSH_AGAIN. Add this info to the doc string.