Document zuul client

Adds programoutput sphinx extension as a test dependency so doc
builds can include the program help text.

Change-Id: Iec2f09f710162614cbb393a5628204ddebe2e29f
This commit is contained in:
James E. Blair 2013-12-05 14:06:08 -08:00
parent 8a7347014c
commit 4ce47daa50
4 changed files with 34 additions and 1 deletions

31
doc/source/client.rst Normal file
View File

@ -0,0 +1,31 @@
:title: Zuul Client
Zuul Client
===========
Zuul includes a simple command line client that may be used by
administrators to affect Zuul's behavior while running. It must be
run on a host that has access to the Gearman server (e.g., locally on
the Zuul host).
Configuration
-------------
The client uses the same zuul.conf file as the server, and will look
for it in the same locations if not specified on the command line.
Usage
-----
The general options that apply to all subcommands are:
.. program-output:: zuul --help
The following subcommands are supported:
Enqueue
^^^^^^^
.. program-output:: zuul enqueue --help
Example::
zuul enqueue --trigger gerrit --pipeline check --project example_project --change 12345 --patchset 1

View File

@ -25,7 +25,7 @@ sys.path.insert(0, os.path.abspath('../..'))
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = [ 'sphinxcontrib.blockdiag' ]
extensions = [ 'sphinxcontrib.blockdiag', 'sphinxcontrib.programoutput' ]
#extensions = ['sphinx.ext.intersphinx']
#intersphinx_mapping = {'python': ('http://docs.python.org/2.7', None)}

View File

@ -23,6 +23,7 @@ Contents:
launchers
reporters
zuul
client
statsd
Indices and tables

View File

@ -9,3 +9,4 @@ fixtures>=0.3.14
python-subunit
testrepository>=0.0.17
testtools>=0.9.32
sphinxcontrib-programoutput