浏览代码

Help/dev: Add info how to generate documentation locally

This adds a short info to the development documentation how to build it
locally quickly using only Utilities/Sphinx source directory.
Peter Kokot 6 月之前
父节点
当前提交
4665dba9e4
共有 1 个文件被更改,包括 8 次插入0 次删除
  1. 8 0
      Help/dev/documentation.rst

+ 8 - 0
Help/dev/documentation.rst

@@ -16,6 +16,14 @@ processed by `Sphinx`_ to generate the CMake help manuals.
 .. _`reStructuredText`: https://docutils.sourceforge.net/docs/ref/rst/introduction.html
 .. _`reStructuredText`: https://docutils.sourceforge.net/docs/ref/rst/introduction.html
 .. _`Sphinx`: https://sphinx-doc.org
 .. _`Sphinx`: https://sphinx-doc.org
 
 
+To generate the HTML and/or man documentation locally from within the CMake
+repository to ``build/html`` and ``build/man`` directories:
+
+.. code-block:: console
+
+  $ cmake -S Utilities/Sphinx -B build -DSPHINX_HTML=ON -DSPHINX_MAN=ON
+  $ cmake --build build
+
 Markup Constructs
 Markup Constructs
 -----------------
 -----------------