Updated old usescases and updated the docs.

Adding new usecases in the documentation.

Merge from 89:270ab1db32db

(0) -30 -10 -3 +3 +10 +30 tip

mercurial