Add comments about Stream.close_connection()'s behavior

Release note: n/a

R=hiroshige@chromium.org

Review URL: https://codereview.appspot.com/170050043

git-svn-id: https://pywebsocket.googlecode.com/svn/trunk@858 4ff78f4a-9131-11de-b045-6380ec9940d4