| Commit message (Collapse) | Author | Age | Files | Lines |
|---|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
As well as the traditional variables, providing imported targets is
suggested, and the relative advantages and disadvantages briefly
discussed.
A mini-tutorial walking through creating a simple find module is
provided.
This changes the recommended version variable from Foo_VERSION_STRING to
Foo_VERSION, because there is really no need to have different variable
names for package version files vs. find modules. It notes the old
variable name, though, and suggests setting it for compatibility.
|
| |
|
|
| |
The type no longer exists within CMake.
|
| |
|
|
| |
binary_find -> binary_search.
|
| | |
|
| |
|
|
|
|
|
|
| |
Psuedo -> Pseudo
behaviour -> behavior
CMake uses American spelling.
|
| |
|
|
|
| |
As found in commit 519c0a5d (Can't use std::string::clear() in
cmake., 2012-09-15).
|
| |
|
|
|
| |
As found in commit 8e7c207e (Use a manual loop to insert into
set::set., 2012-09-15).
|
| |
|
|
|
| |
This may be incomplete, but further limitations can be added when
needed.
|
| |
|
|
|
|
| |
The cmake-language.7 manual now documents comment syntax. Reference it
from cmake-developer.7 when discussing how to add comment-enclosed
documentation to modules.
|
| |
|
|
|
|
| |
Simply print out the lines as normal paragraph text. Teach the
CMakeLib.testRST test to cover this syntax. Update the
cmake-developer.7 manual to document support for the directives.
|
| |
|
|
|
|
|
| |
Add the man page description line as explicit markup at the top of each
Help/manual/*.rst file and scan it from conf.py to automatically
generate the man_pages Sphinx configuration value. This reduces the
number of places that need to be changed when a new manual is added.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When scanning CMake module files for .rst comments, recognize
bracket comments starting in ".rst:" too. For example:
#[[.rst:
Include the bracket comment content terminated by the closing bracket.
Exclude the line containing the bracket if it starts in "#".
Teach the CMakeLib.testRST test to cover multiple bracket lengths
and ending brackets on lines with and without "#".
Update the cmake-developer.7 manual to document the bracket-comment
syntax for .rst documentation.
|
| |
|
|
|
| |
Use prose instead of enumerated steps and re-order the steps so that
the cmake-module directive is covered contiguously.
|
| |
|
|
|
|
| |
The cmRST implementation and the list of capabilities documented in the
cmake-developer.7 manual must be kept in sync. Add a note to each file
to reference the other.
|
| |
|
|
|
|
| |
Document how CMake uses reStructuredText to provide the help manuals.
Cover supported inline markup and directives, the CMake Domain in
Sphinx, and cross-reference syntax.
|
| |
|
|
|
|
| |
Add "Module Documentation" and "Find Modules" subsections. Add to
Modules/readme.txt a textual reference to the cmake-developer.7 manual
and, while at it, fix the wiki URL domain.
|
| |
|
|
|
|
|
| |
Convert the content moved from Modules/readme.txt to valid
reStructuredText markup. Mainly, convert the lists of variables to
definition lists, wrap long lines in paragraph text, and add literal
block markup and indentation.
|
| |
|
|
|
|
|
| |
Move all content from Modules/readme.txt except for the link to the
module maintainers wiki page into "Help/manual/cmake-developer.7.rst".
This produces some invalid reStructuredText markup to be fixed in a
future commit.
|
|
|
Add the manual with just an introduction section. Leave section headers
for Help and Modules to be filled in later.
|
