subtests: Fix minor problems in tests.

Signed-off-by: Jiří Župka <jzupka@redhat.com>
subtests.docker_cli.run_attach: Fix the commands

Accedentally I put the \nexit\n in different command.

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>
docker_daemon: Adds docs for network and tls tests.

Signed-off-by: Jiří Župka <jzupka@redhat.com>
Merge pull request #302 from jzupka/fix_problems

subtests: Fix minor problems in tests.
Merge pull request #304 from jzupka/daemon_net_tls_docs

docker_daemon: Adds docs for network and tls tests.
index.rst: Fix/add descriptions in index.rst and bad docstring

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>
subtests.docker_cli: Remove build_paths test

This test is superseded by docker_cli/build test, which now supports
various locations too plus it does deeper postprocess.

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>
Merge pull request #303 from ldoktor/fixups

Couple of mixed fixups
Docs: Separate subtest section

*  Moved everything except the examples into
   a separate ``subtests.rst`` file.
*  Updated the content of the subtests section
   including adding more details about the
   sub-subtest mechanism.

Signed-off-by: Chris Evich <cevich@redhat.com>
Docs: Update example docstrings to new standard format

Signed-off-by: Chris Evich <cevich@redhat.com>
dockertest.dockercmd: Print stdin when provided

It's hard to know, what happened while executing a command, when you
don't know the provided stdin. This patch appends `<<< "..."` after the
docker execute message in case it's non-zero. I used "%r" to make it
easier to discover, that it's not part of the executed command plus to
decrease size of the log.

Example:
Execute /usr/bin/docker -D run --name test_rvSj fedora bash  <<< 'ls /\nexit\n'
Execute /usr/bin/docker -D run --name test_rvSj fedora ls /

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>
Docs: Merge old subtest docs into docstrings w/ new format

Contents of ``subtests.rst`` were moved/merged into the
main module docstrings for each subtest.  Examples
were updated to reflect docstring format.

Signed-off-by: Chris Evich <cevich@redhat.com>
Docs: Minor fixes, include version/revision

*  Fix release value to represent version less revision number.
*  Add substitutions for version & revision in Title and API section.
*  Fix prerequisites link.
*  Prepare subtests section for inclusion by external file.

Signed-off-by: Chris Evich <cevich@redhat.com>
Docker: Add run_checkdocs.py, call from travis

This patch adds `run_checkdocs.py` helper, which checks all
existing files and it's documentation. This check is added in .travis.yml
and will be executed with each test.

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>
Docker: Auto-generate subtest docs

Moved generic subtest locating / naming code from run_checkdocs.py
into class dockertest.environment.SubtestDocs.  This module by
has no dockertest-dependencies, so it's safe to call from stand-alone
scripts.  Added methods for extracing docstrings from subtest modules
and joining them together.  Added unittests to verify all functionality.

Updated Makefile to properly identify changed subtest modules so
subtest documentation will be rebuilt automatically.  Updated
index.rst to include subtests.rst file.  Added subtests.rst as
a dependency to all targets.

Modified travis.yml to build documentation prior to running
documentation checks.  Modified run_checkdocs.py to point
at subtests.rst instead of index.rst.

Signed-off-by: Chris Evich <cevich@redhat.com>
Merge branch 'subtest_docs' of https://github.com/cevich/autotest-docker into doc_checker
Docker: Made run_checkdocs.py executable

Signed-off-by: Chris Evich <cevich@redhat.com>
Doc: Fix warnings/errors in subtest docstrings

Resolves #336, #337, #338, and #339

Signed-off-by: Chris Evich <cevich@redhat.com>
Docker: Output single subtest doc in html

Signed-off-by: Chris Evich <cevich@redhat.com>
Docker: Update dockertest.subtest docs

*  ``index.rst`` now pulls in entire ``subtest`` module
   instead of class-by-class (old problem of ``Subtest``
   class not appearing, doesn't happen now that there is
   ``SubBase``.

*  Updated docstrings on a few undocumented attributes.

*  Added double-backquotes around some symbol names in
   docstrings.

Signed-off-by: Chris Evich <cevich@redhat.com>