Re-factor nrepl-client.el (2): documentation

    - Extensively document what is going on
    - Fix typos from the recent re-factoring
    - remove `nrepl-log-messages` function
    - nrepl-project-filter -> nrepl-client-filter instead of
    - nrepl--bencode1 -> nrepl-bencode-object