Refactor and document nrepl-client.el

Refactor:

   - general code and documentation cleanup
   - use -- convention for internal function of very limited use
   - inline several very short internal functions
   - use systematic naming convention for requests. Namely nrepl-send-request and
     nrepl-send-sync-request for workhorse functions and `nrepl-request:XXX` and
     `nrepl-sync-request:OP` for requests of type "OP".
   - rename `nrepl-send-request-sync` into `nrepl-send-sync-request`
   - delete `nrepl-log-messages` command

Reorganize nrepl-client.el in functional chapters:

   - Bencode
   - Client: Process Filter
   - Client: Initialization
   - Client: Response Handling
   - Client: Request Handling
   - Server
   - Utilities
   - Connection Buffer Management
   - Connection Browser

Document the nREPL communication process.

1 files changed, 19 insertions, 0 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 711ae0c7..e9991b28 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,25 @@
 
 ## master (unreleased)
 
+### Changes
+
+* nrepl-client.el refactoring:
+
+  - `nrepl-send-request-sync` was renamed into `nrepl-send-sync-request` to comply
+  -  with the names of other 'sync' variables.
+
+  - nREPL requests are now named with `nrepl-request:OP` where "OP" stands for
+    the type of the request (eval, clone etc.). The following functions
+    were renamed:
+    
+       nrepl-send-string -> nrepl-request:eval
+       nrepl-send-string-sync -> nrepl-sync-request:eval
+       nrepl-send-interrupt -> nrepl-request:interrupt
+       nrepl-send-stdin -> nrepl-request:stdin
+       nrepl-describe-session -> nrepl-request:describe
+       nrepl-create-client-session -> nrepl-request:clone
+
+
 ## 0.7.0 / 2014-08-05
 
 ### New features