175e79ebf7
Fix all issues found and enable doc8 run. Change-Id: I1b3fc9ac3db5e2d1dfa138b026e26835ead4d7fb
118 lines
2.8 KiB
ReStructuredText
118 lines
2.8 KiB
ReStructuredText
==================
|
|
openstack-doc-test
|
|
==================
|
|
|
|
------------------------------------------------------
|
|
OpenStack Validation tool
|
|
------------------------------------------------------
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
openstack-doc-test [options]
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
openstack-doc-test allows to test the validity of the OpenStack
|
|
documentation content.
|
|
|
|
OPTIONS
|
|
=======
|
|
|
|
**General options**
|
|
|
|
**--api-site**
|
|
Special handling for api-site and other API repositories
|
|
to handle WADL.
|
|
|
|
**--build-file-exception BUILD_FILE_EXCEPTION**
|
|
File that will be skipped during delete and build checks to
|
|
generate depenencies. This should be done for invalid XML files
|
|
only.
|
|
|
|
**--check-build**
|
|
Try to build books using modified files.
|
|
|
|
**--check-deletions**
|
|
Check that deleted files are not used.
|
|
|
|
**--check-links**
|
|
Check that linked URLs are valid and reachable.
|
|
|
|
**--check-niceness**
|
|
Check the niceness of files, for example whitespace.
|
|
|
|
**--check-syntax**
|
|
Check the syntax of modified files.
|
|
|
|
**--check-all**
|
|
Run all checks (default if no arguments are given).
|
|
|
|
**--config-file PATH**
|
|
Path to a config file to use. Multiple config files can be
|
|
specified, with values in later files taking precedence.
|
|
|
|
**--debug**
|
|
Enable debug code.
|
|
|
|
**--file-exception FILE_EXCEPTION**
|
|
File that will be skipped during niceness and syntax validation.
|
|
|
|
**--force**
|
|
Force the validation of all files and build all books.
|
|
|
|
**-h, --help**
|
|
Show help message and exit.
|
|
|
|
**--ignore-dir IGNORE_DIR**
|
|
Directory to ignore for building of manuals. The parameter can
|
|
be passed multiple times to add several directories.
|
|
|
|
**--language LANGUAGE, -l LANGUAGE**
|
|
Build translated manual for language in path generate/$LANGUAGE .
|
|
|
|
**--only-book ONLY_BOOK**
|
|
Build each specified manual.
|
|
|
|
**--parallel**
|
|
Build books in parallel (default).
|
|
|
|
**--print-unused-files**
|
|
Print list of files that are not included anywhere as part of
|
|
check-build.
|
|
|
|
**--publish**
|
|
Setup content in publish-docs directory for publishing to
|
|
external website.
|
|
|
|
**--verbose**
|
|
Verbose execution.
|
|
|
|
**--version**
|
|
Output version number.
|
|
|
|
FILES
|
|
=====
|
|
|
|
Reads the file `doc-test.conf` in the top-level directory of the git
|
|
repository for option processing.
|
|
|
|
Building of books will generate in the top-level directory of the git
|
|
repository:
|
|
|
|
* a directory `publish-docs` with a copy of the build results.
|
|
* for each book build a log file named `build-${book}.log.gz`.
|
|
|
|
SEE ALSO
|
|
========
|
|
|
|
* `OpenStack Documentation <http://wiki.openstack.org/wiki/Documentation>`__
|
|
|
|
Bugs
|
|
====
|
|
|
|
* openstack-doc-tools is hosted on Launchpad so you can view current
|
|
bugs at
|
|
`Bugs : openstack-manuals <https://bugs.launchpad.net/openstack-manuals/>`__
|