diff options
Diffstat (limited to 'doc/rst_source/relay/build_this.rst')
-rw-r--r-- | doc/rst_source/relay/build_this.rst | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/rst_source/relay/build_this.rst b/doc/rst_source/relay/build_this.rst index d91a6d55d..f51d1047d 100644 --- a/doc/rst_source/relay/build_this.rst +++ b/doc/rst_source/relay/build_this.rst @@ -29,10 +29,12 @@ expected. Updating man pages ------------------ -Man pages generated from the RST sources, are checked into the src/man -directory. To regenerate these files, run ``make rstman`` from the -man subdirectory of a configured build tree. You can also do this -from an unconfigured source tree with:: +Man pages are generated from the RST sources and checked into the +``src/man`` directory of the repository. This allows man pages to be +installed without requiring Sphinx when using a source checkout. To +regenerate these files, run ``make rstman`` from the man subdirectory +of a configured build tree. You can also do this from an unconfigured +source tree with:: cd src/man make -f Makefile.in top_srcdir=.. srcdir=. rstman @@ -48,7 +50,7 @@ Building for a release tarball or web site To generate documentation in HTML format, run ``make rsthtml`` in the ``doc`` subdirectory of a configured build tree (the build directory corresponding to ``src/doc``, not the top-level ``doc`` directory). -The output be placed in the top-level ``doc/rst_html`` directory. +The output will be placed in the top-level ``doc/rst_html`` directory. This build will include the API reference generated from Doxygen markup in the source tree. |