Add/edit docbook documentation in user-docs.

Add boolean shutdown variable in ShutdownListener.
Hierarchical State Machine is now broken out to its own module (river-hsm) and clears almost all findbugs/pmd/etc checks.
river-container-core no longer has a dependency on OpenWebBeans.