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.
Merge pull request #19 from rrakus/master

completion: Initial completion for LMI commands
added note about hosted documentation to README

also fixed markup, so that github show it properly
added README to doc directory

added setup.cfg making documentation uploads to fedorahosted easy
added a note about version of sources
version bump

changelog update
convert README to reStructuredText when making sdist

added simple Makefile to automate some tasks
fixed generating of pdf

Latex output made possible.

Also fixed reading of readme, where error has been incorrectly handled.

Synced version of documentation with package.
fixed detection of older shell when making a connection

correctly detect which of the following should be passed to connect
method:
  verify_certificate - older versions
  verify_server_cert - newer versions
fixed regexps in doc utility script
software: improved documentation strings

Polished software script documentation in order to get nice html
generated with sphinx.
added documentation for software script library

bumped version of software to 0.2.1
improved making of pdf documentation

Index now contains just one column. There are too long lines
for 2-columns making the index unreadable.