From: Greg Hudson Date: Sat, 31 Mar 2012 06:01:02 +0000 (+0000) Subject: Edit RST docs on building RST docs X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=3f19f78897bcc370261cae11fb7ac18378e3055c;p=krb5.git Edit RST docs on building RST docs Fix a couple of grammar errors noted by Ben Kaduk, and elaborate a little bit on why generated man pages are checked into the repository. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25798 dc483132-0cff-0310-8789-dd5450dbe970 --- 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.