another docs revision for 1.9