Merge pull request #872 from FranciscoBorges/documentation

Improve documentation, + one code fix
HORNETQ-720 Sort out the live.stop() order:

1. live.stop()
2. freeze all connections
   - if replicating keep that channel open
3. close all server sessions
4. close pagingManager
5. close storageManager

Now, the replicationManager is still open when the storagemanager closes, so
- it gets the "persist ID" value
- storageManager.stop() will send "LIVE_IS_STOPPING" msg