doc string update of lmi.scripts

improved documenting style for nicer output of spinx
documentation fixes

Lot of corrections, typo fixes. Added some cross-references.

Added automatically generated documentaion from sources.
Added gendoc.sh script, that generates rst files for modules.