NAME

       openstack-doc-test - OpenStack documentation tools

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 dependencies. 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

   Bugs
       • openstack-doc-tools is hosted on Launchpad so you can view current bugs at Bugs : openstack-manuals

AUTHOR

       OpenStack

COPYRIGHT

       2014, OpenStack Foundation

                                                October 23, 2015                           OPENSTACK-DOC-TEST(1)