summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2019-05-30 16:25:39 (GMT)
committerBetsy McPhail <betsy.mcphail@kitware.com>2019-06-18 14:36:16 (GMT)
commitd2fde9480955cf2246519357e01ab5142a067efc (patch)
tree84131f83ba9f855099d3520c2792cdf607669456
parentf067af8e385d17cc5b14e43475ded4d9d38317a2 (diff)
downloadCMake-d2fde9480955cf2246519357e01ab5142a067efc.zip
CMake-d2fde9480955cf2246519357e01ab5142a067efc.tar.gz
CMake-d2fde9480955cf2246519357e01ab5142a067efc.tar.bz2
Help: Add infrastructure for guide-level documentation
Create a `Help/guide/` directory to hold guide-level documents. Build them in most documentation formats, but not as man pages. Initialize the guide directory with a placeholder for the tutorial.
-rw-r--r--CMakeLists.txt2
-rw-r--r--Help/guide/tutorial/index.rst2
-rw-r--r--Help/index.rst8
3 files changed, 11 insertions, 1 deletions
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 51a1d8b..399e79c 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -817,7 +817,7 @@ if(NOT CMake_TEST_EXTERNAL_CMAKE)
PATTERN "*.sh*" PERMISSIONS OWNER_READ OWNER_EXECUTE OWNER_WRITE
GROUP_READ GROUP_EXECUTE
WORLD_READ WORLD_EXECUTE
- REGEX "Help/dev($|/)" EXCLUDE
+ REGEX "Help/(dev|guide|index.rst)($|/)" EXCLUDE
)
# Install auxiliary files integrating with other tools.
diff --git a/Help/guide/tutorial/index.rst b/Help/guide/tutorial/index.rst
new file mode 100644
index 0000000..be906af
--- /dev/null
+++ b/Help/guide/tutorial/index.rst
@@ -0,0 +1,2 @@
+CMake Tutorial
+**************
diff --git a/Help/index.rst b/Help/index.rst
index a948939..cf1d2f1 100644
--- a/Help/index.rst
+++ b/Help/index.rst
@@ -44,6 +44,14 @@ Reference Manuals
/manual/cmake-variables.7
/manual/cpack-generators.7
+Guides
+######
+
+.. toctree::
+ :maxdepth: 1
+
+ /guide/tutorial/index
+
.. only:: html or text
Release Notes