some additions to the manual code and getting ready to generate bindings to other routines
typos fixed