Browse Source

Help: Split cmake-generators(7) into linkable subsections

Many places in our documentation refer to "Makefile Generators" or
"Visual Studio" generators as a group of generators.  Give such
places a linkable document section to reference since they cannot
cross-reference the individual generators in the groups.
Brad King 10 years ago
parent
commit
6ed6ef6237
1 changed files with 25 additions and 1 deletions
  1. 25 1
      Help/manual/cmake-generators.7.rst

+ 25 - 1
Help/manual/cmake-generators.7.rst

@@ -34,6 +34,11 @@ These generators support command-line build tools.  In order to use them,
 one must launch CMake from a command-line prompt whose environment is
 one must launch CMake from a command-line prompt whose environment is
 already configured for the chosen compiler and build tool.
 already configured for the chosen compiler and build tool.
 
 
+.. _`Makefile Generators`:
+
+Makefile Generators
+^^^^^^^^^^^^^^^^^^^
+
 .. toctree::
 .. toctree::
    :maxdepth: 1
    :maxdepth: 1
 
 
@@ -42,10 +47,17 @@ already configured for the chosen compiler and build tool.
    /generator/MinGW Makefiles
    /generator/MinGW Makefiles
    /generator/NMake Makefiles
    /generator/NMake Makefiles
    /generator/NMake Makefiles JOM
    /generator/NMake Makefiles JOM
-   /generator/Ninja
    /generator/Unix Makefiles
    /generator/Unix Makefiles
    /generator/Watcom WMake
    /generator/Watcom WMake
 
 
+Ninja Generator
+^^^^^^^^^^^^^^^
+
+.. toctree::
+   :maxdepth: 1
+
+   /generator/Ninja
+
 IDE Build Tool Generators
 IDE Build Tool Generators
 -------------------------
 -------------------------
 
 
@@ -53,6 +65,11 @@ These generators support Integrated Development Environment (IDE)
 project files.  Since the IDEs configure their own environment
 project files.  Since the IDEs configure their own environment
 one may launch CMake from any environment.
 one may launch CMake from any environment.
 
 
+.. _`Visual Studio Generators`:
+
+Visual Studio Generators
+^^^^^^^^^^^^^^^^^^^^^^^^
+
 .. toctree::
 .. toctree::
    :maxdepth: 1
    :maxdepth: 1
 
 
@@ -65,6 +82,13 @@ one may launch CMake from any environment.
    /generator/Visual Studio 11 2012
    /generator/Visual Studio 11 2012
    /generator/Visual Studio 12 2013
    /generator/Visual Studio 12 2013
    /generator/Visual Studio 14 2015
    /generator/Visual Studio 14 2015
+
+Xcode Generator
+^^^^^^^^^^^^^^^
+
+.. toctree::
+   :maxdepth: 1
+
    /generator/Xcode
    /generator/Xcode
 
 
 Extra Generators
 Extra Generators