Document zuul client
Adds programoutput sphinx extension as a test dependency so doc
builds can include the program help text.
Change-Id: Iec2f09f710162614cbb393a5628204ddebe2e29f
diff --git a/doc/source/client.rst b/doc/source/client.rst
new file mode 100644
index 0000000..f0b784a
--- /dev/null
+++ b/doc/source/client.rst
@@ -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