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

    - Extensively document what is going on
    - Fix typos from the recent re-factoring
    - `nrepl-client-filter' instead of `nrepl-project-filter'