added documentation for v1.2 -- close #6