setup.py: email address is not supposed to be enclosed by <>

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man: introduce manpage-writer

A simple docutils wrapper, basically a rip off of rst2man for now,
that fetches information on arc source code.

For now it removes the burden of actually updating version numbers,
but the idea is to have all command line options automatically
pulled from the source code.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
docs: do not use sphinx to build manpage

We'll use the simpler reStructureText manpage writer instead.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
arc/cli/args: make id parameter explicity of type integer

So that access to those result in an integer rather than a
string.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
cli arguments: make a generic option for getting the object identification

Either the name or the id can identify many objects (hosts, jobs, etc).
Since this is a very frequent task, create a utility functions that
helps with that.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
arc/cli/args/host.py: make the help strings more straightforward

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: introduce cli_args_extract.py

Module that will extract command line arguments info from arc
cli arguments modules and save them as reST.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: make manpage writer use the auto generation of cli args text

Signed-off-by: Cleber Rosa <crosa@redhat.com>
README.md: tidy up the document

With only the most basic information needed.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: introduce cli_parser_extract.py

Module that will extract command line *usage* information from
the arcli command line parser, including its actions, and save
them as reST.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: use cli parser extraction module

And expand auto generation of modules to labels and test.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: add the man page itself.

It's a plain reST file, with include statements for text files
that are generated by `manpage-writer`.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: use absolute file names for the arc library and output files

This makes it more failproof when running manpage-writer out of any
directory, such as what happens when building an RPM package.

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: add it to the RPM build process

Signed-off-by: Cleber Rosa <crosa@redhat.com>
setup.py: add command for building sphinx documentation

Signed-off-by: Cleber Rosa <crosa@redhat.com>
RPM spec: build sphinx docs during the RPM build process

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: typos and spell check fixes

Signed-off-by: Cleber Rosa <crosa@redhat.com>
man page: improve documentation

This adds various clean ups to the man page, and includes an
example on how to submit a new job.

CC: Ruda Moura <rmoura@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
arc/cli/args/job.py: default profiles to an empty list

This fixes the bug reported by Ruda Moura (thanks) when
sending a new job on a fresh system without using profile
parameters.

CC: Ruda Moursa <rmoura@redhat.com>
Signed-off-by: Cleber Rosa <crosa@redhat.com>
arc/cli/args/base.py: use "object" as generic name

Instead of entry, which refers more strongly to a database record.
Objects, IMHO, are more easy for human to relate to.

Also, add generic NAME and ID arguments, to simplify the repeated
use of those options on other actions' arguments.

Signed-off-by: Cleber Rosa <crosa@redhat.com>