Merge pull request #8 from jsafrane/merged/doc-fixes

Added help2rst and reworked documentation
fixed parsing of host file
provide hostname on prompt, when asking for credentials

Ask user for credentials with hostname on prompt, if we connect
to multiple hosts.
added --same-credentials flag

This allows to use just one credential pair (username and password)
for all hosts.
new ARG_ARRAY_SUFFIX property for end point commands

Usage string such as:
  %(cmd)s mycommand <FILE>...
results in list being passed to an associated method with 'FILE' as
its name, which is a bit misleading. This enhancement allows the
following:

  class Mycommand(LmiLister):
    CALLABLE = associated_function
    ARG_ARRAY_SUFFIX = '_ARRAY'

which will cause that the list of files will be passed as 'FILE_ARRAY'.
fixed LmiShowInstance command creation

render method was not created properly if both PROPERTIES and
DYNAMIC_PROPERTIES were not assigned
fixed exception handling

KeyError can easily happen in run() method of command, let's not mistake
it for undefined command error.
fixed argument processing of nested multiplexer commands

options_first=True is needed for docopt to ignore any options following
unknown command.
This fixes following situation:
  $ lmi -h $hostname sw show package --repo fedora-updates $package

Which failed to be parsed because of "--repo" option was not recognized.
Merge remote-tracking branch 'upstream/master'