summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeFilesLines
* CTest: added test for RUN_SERIAL issue #14484Nils Gladitz2013-10-213-0/+39
|
* CTest: added comments that describe the basic test sorting approachNils Gladitz2013-10-211-0/+7
|
* CTest: removed redundant copy of test dependency setNils Gladitz2013-10-211-7/+1
|
* CTest: perform cycle test earlyNils Gladitz2013-10-192-1/+8
|
* CTest: consider previously failed tests before all othersNils Gladitz2013-10-191-15/+10
|
* CTest: prioritize tests by their depth in the dependency graphNils Gladitz2013-10-181-4/+45
|
* CTest: handle dependent and non dependent test requirements equallyNils Gladitz2013-10-171-40/+9
|
* Merge topic 'help-manual-cleanup'Brad King2013-10-1715-870/+283
|\ | | | | | | | | | | | | | | 9b212ad Make --help-* options available from all command-line tools 5dde65a Help: De-duplicate manual/(cmake|ccmake).1.rst build options ae944d1 Help: Organize manual/*.1.rst sections 4f7d708 Help: Drop leftover conversion content from manual/*.1.rst
| * Make --help-* options available from all command-line toolsBrad King2013-10-1613-370/+163
| | | | | | | | | | | | | | | | | | | | | | Make the standard --help-* options available from all command-line tools. Drop options that are no longer supported: --copyright, --help-full, --help-html, --help-man, --help-compatcommands, --help-custom-modules De-duplicate Help/manual/*.1.rst help options by using an OPTIONS_HELP.txt file included from each manual.
| * Help: De-duplicate manual/(cmake|ccmake).1.rst build optionsBrad King2013-10-163-115/+59
| | | | | | | | | | Move common build options out of cmake and ccmake manuals into an OPTIONS_BUILD.txt file and include it from the original locations.
| * Help: Organize manual/*.1.rst sectionsBrad King2013-10-166-116/+61
| | | | | | | | | | | | | | Add "Synopsis", "Description", and "See Also" manual page section headers. These are typical of .1 man section pages. Also de-duplicate the See Also section links using a separate LINKS.txt file included from each manual.
| * Help: Drop leftover conversion content from manual/*.1.rstBrad King2013-10-165-269/+0
| | | | | | | | | | Some text in these manuals is left from the old full help transition text generated by the automatic conversion process. Drop it.
* | Merge topic 'wix-documentation-escapes'Brad King2013-10-171-2/+2
|\ \ | | | | | | | | | | | | 42b4f6c CPackWiX: prevent attribute references in docs from being interpreted
| * | CPackWiX: prevent attribute references in docs from being interpretedNils Gladitz2013-10-161-2/+2
| |/
* | Merge topic 'readable-lupdate.pro'Brad King2013-10-171-3/+4
|\ \ | | | | | | | | | | | | 51305f5 Qt4: make pro files generated for translations easier to read
| * | Qt4: make pro files generated for translations easier to readRolf Eike Beer2013-10-161-3/+4
| |/ | | | | | | | | -use one line for each input file and include directory -remove duplicate include directories
* | Merge topic 'print-CMP0022-content-conflict-test'Brad King2013-10-174-0/+29
|\ \ | | | | | | | | | | | | 4fd6024 CMP0022: Add unit test for null pointer check and message.
| * | CMP0022: Add unit test for null pointer check and message.Stephen Kelly2013-10-164-0/+29
| |/
* | CMake Nightly Date StampKitware Robot2013-10-171-1/+1
|/
* Merge topic 'update-kwsys'Brad King2013-10-161-0/+9
|\ | | | | | | | | | | 0408415 Merge branch 'upstream-kwsys' into update-kwsys c01e744 KWSys 2013-10-15 (6eab64c3)
| * Merge branch 'upstream-kwsys' into update-kwsysBrad King2013-10-151-0/+9
| |\
| | * KWSys 2013-10-15 (6eab64c3)KWSys Robot2013-10-151-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Extract upstream KWSys using the following shell commands. $ git archive --prefix=upstream-kwsys/ 6eab64c3 | tar x $ git shortlog --no-merges --abbrev=8 --format='%h %s' 96b2f6f4..6eab64c3 Raphael Kubo da Costa (1): 6eab64c3 SystemInformation: Include backtrace-related headers on FreeBSD Change-Id: Ib0447aab3d6555ce278f0c1417af2c53e6f181a5
* | | Merge topic 'doc-reStructuredText'Brad King2013-10-161352-36097/+24015
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7038a93 Modules/readme.txt: Update steps to add module documentation a77e308 CPack: Replace #<type> markup with reStructuredText equivalent e7ca48f Help: Factor out cmake-generator-expressions manual page 97e8650 Help: Factor out COMPILE_DEFINITIONS disclaimer duplication 8982161 Help: Factor out find_* command duplication 30b2186 Help: Factor out *_OUTPUT_(NAME|DIRECTORY).rst duplication bfe07aa Build Help documentation during CMake build using Sphinx 53ded59 Drop unused builtin documentation APIs 0c39a75 Drop the 'Full' field from cmDocumentationEntry e33d8d2 Drop builtin command documentation 399e9c4 Drop builtin property documentation 6035c04 get_property: Drop test for builtin property documentation 80a3273 Drop all documentation formatters except Usage b336a1eb Teach COMPATIBLE_INTERFACE_* checks to use Help .rst documents ec6df36 Teach --help-* options to load documentation from .rst files 25f2877 Add class cmRST to do basic reStructuredText processing ...
| * | | Modules/readme.txt: Update steps to add module documentationBrad King2013-10-161-23/+41
| | | | | | | | | | | | | | | | | | | | Replace the old module documentation instructions with steps to add reStructuredText documentation that will be built by Sphinx.
| * | | CPack: Replace #<type> markup with reStructuredText equivalentKitware Robot2013-10-1611-1188/+805
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Drop #end and #module. Convert #section to a subsection header. Convert #variable to the cmake domain "variable" directive. Convert #macro to the cmake domain "command" directive. Perform minor formatting fixes in text near these changes.
| * | | Help: Factor out cmake-generator-expressions manual pageBrad King2013-10-1620-1219/+128
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Generator expressions are supported in many places and are a distinct concept worthy of their own manual page. The old builtin documentation was previously represented by preprocessor macros to generate it into each place that supports them. Factor out the duplicate content into a dedicated cmake-generator-expressions manual page and reference it from each original location.
| * | | Help: Factor out COMPILE_DEFINITIONS disclaimer duplicationBrad King2013-10-164-60/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The COMPILE_DEFINITIONS escaping disclaimer was represented in builtin documentation using a preprocessor macro. Factor the duplicate content out into a separate .txt file and include it in each document with the reStructuredText include directive.
| * | | Help: Factor out find_* command duplicationBrad King2013-10-169-628/+227
| | | | | | | | | | | | | | | | | | | | | | | | | | | | These documents were represented in the builtin documentation using a common starting point with placeholders substituted by each command. Convert them back to this approach using the reStructuredText include directive and substitutions to avoid duplication.
| * | | Help: Factor out *_OUTPUT_(NAME|DIRECTORY).rst duplicationBrad King2013-10-169-81/+46
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Portions of these documents contain duplicate content generated from preprocessor macros in the original builtin documentation source. Factor the common parts out into .txt files using reStructuredText include directives and substitutions to avoid duplication.
| * | | Build Help documentation during CMake build using SphinxBrad King2013-10-167-0/+471
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a Utilities/Sphinx directory to hold CMake build code to run the Sphinx (sphinx-doc.org) documentation generation tool. Create a CMakeLists.txt file there capable of building either as a subdirectory of the main CMake build, or as a standalone documentation build. Add cache options SPHINX_MAN and SPHINX_HTML to select output formats and SPHINX_EXECUTABLE to specify the sphinx-build executable. Add bootstrap options --sphix-man and --sphinx-html to select output formats and --sphinx-build=<sb> to specify the sphinx-build executable. Create a "conf.py.in" file to configure_file into "conf.py" to tell sphinx-build how to build our documents. Create a "cmake.py" Sphinx extension module defining: * The "cmake-module" directive used in Help/module/*.rst files to scan .rst markup from the corresponding Modules/*.cmake file. * A Sphinx domain called "cmake" defining documentation object types for CMake Help/<type> directories: command, generator, manual, module, policy, prop_*, and variable. Add a "role" for each type to perform cross-references. Teach the roles to treat "<XYZ>" as placeholders instead of explicit targets if not preceded by a space. Add cmake domain directives to define command and variable objects explicitly in .rst file content. This will allow modules to define their own commands and variables and have them indexed and linkable. * A Sphinx document transform that converts Help/<type>/*.rst documents into cmake domain objects of the corresponding <type> and adds index entries for them. This will automatically index all CMake documentation objects and provide cross-reference targets for them with no special markup in the .rst files.
| * | | Drop unused builtin documentation APIsBrad King2013-10-166-29/+3
| | | | | | | | | | | | | | | | | | | | Now that all DefineProperty documentation calls have been dropped, drop the supporting APIs.
| * | | Drop the 'Full' field from cmDocumentationEntryBrad King2013-10-1633-663/+187
| | | | | | | | | | | | | | | | | | | | We need only 'Brief' for usage documentation. We no longer have builtin 'Full' documentation, which is now in Help/*/*.rst files.
| * | | Drop builtin command documentationBrad King2013-10-16131-5529/+0
| | | | | | | | | | | | | | | | | | | | Drop all GetTerseDocumentation and GetFullDocumentation methods from commands. The command documentation is now in Help/command/*.rst files.
| * | | Drop builtin property documentationBrad King2013-10-1619-4447/+6
| | | | | | | | | | | | | | | | | | | | | | | | Drop all DefineProperty calls for non-chained properties. Drop the documentation from the chained ones. The documentation for all properties is now in Help/prop_*/*.rst files.
| * | | get_property: Drop test for builtin property documentationBrad King2013-10-161-11/+0
| | | | | | | | | | | | | | | | | | | | Property documentation is no longer builtin, so the get_property command will be unable to return the documentation. Drop the test for it.
| * | | Drop all documentation formatters except UsageBrad King2013-10-1620-1525/+202
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We now need only the Usage formatter to support command-line options that print basic usage, and the supporting indented=>preformatted markup processor to support CMake message formatting. Drop all other documentation formatters and move the remaining code up into the top cmDocumentationFormatter class.
| * | | Teach COMPATIBLE_INTERFACE_* checks to use Help .rst documentsBrad King2013-10-161-3/+6
| | | | | | | | | | | | | | | | | | | | | | | | These checks want to know if named target properties are builtin, which is now known by checking the Help/prop_tgt directory. (Previously the check could be confused by a define_property call in the project.)
| * | | Teach --help-* options to load documentation from .rst filesBrad King2013-10-166-37/+309
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Install the Help directory next to Modules to make it available in CMake distributions. Use cmRST to read Help .rst documents and print them as help output. Add options --help-manual-list --help-manual to list available manuals or print one of them. Implement the options --help-commands --help-modules --help-policies --help-properties --help-variables by mapping to the corresponding manual page. Implement the options --help-command-list --help-module-list --help-policy-list --help-property-list --help-variable-list by globbing the available Help .rst documents of the corresponding type and reading their titles. Implement the options --help-command --help-module --help-policy --help-property --help-variable by globbing the matching Help .rst document(s) and printing them.
| * | | Add class cmRST to do basic reStructuredText processingBrad King2013-10-1612-0/+766
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Create a cmRST class to perform just enough reStructuredText processing to support display of Help documents in human-readable text format. This will be used to implement --help-* command-line options. Support directives "include", "replace", "parsed-literal", "toctree" (Sphinx), and "cmake-module" (CMake Sphinx Extension to scan .cmake modules). Support inline CMake Sphinx Domain roles to convert cross-references to corresponding title text. Support inline substitutions defined by the "replace" directive, but keep it simple by requiring replacements to be defined before use. Add a CMakeLib "testRST" case to cover processing of supported constructs and compare results against expected output.
| * | | Drop "full" documentation output typesBrad King2013-10-1519-1462/+23
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We will no longer support full documentation generation from executables and will instead generate documentation with other tools. Disable (with a warning left behind) the command-line options: --copyright --help-compatcommands --help-full --help-html --help-man Drop supporting code. Drop manual sections generation from executables. Remove internal documentation construction APIs. Drop unused sections See Also, Author, Copyright, Compat Commands, Custom Modules.
| * | | Help: Fix reStructuredText syntax in auto-generated documentsBrad King2013-10-1519-19/+21
| | | |
| * | | Help: Add index.rst top-level documentBrad King2013-10-151-0/+28
| | | | | | | | | | | | | | | | | | | | | | | | Add a top-level document holding the Sphinx root toctree. List all reference manuals from Help/manual/*.rst and the Sphinx-generated general index (genindex) and search pages.
| * | | ExternalProject: Restore documentation indentation levelBrad King2013-10-151-70/+70
| | | | | | | | | | | | | | | | | | | | This module parses its own documentation to extract supported options. Fix the indentation level to match that expected by the parser.
| * | | Convert builtin help to reStructuredText source filesKitware Robot2013-10-151044-6171/+23771
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.
| * | | Add bash script to convert builtin help to reStructuredTextBrad King2013-10-151-0/+306
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Create a convert-help.bash script to extract builtin documentation as reStructuredText sources in a new Help directory. Run each executable with the --help-full option targeting a .rst file to extract the documentation. Generate Sphinx "toctree" directives to point each man page at the corresponding documents it should contain. Organize cmake-commands(7), cmake-properties(7), and cmake-variables(7) man pages into sections similar to those generated by --help-properties and --help-variables output previously.
| * | | Add Help/generator/*.rst for Windows- and OS X-only generatorsKitware Robot2013-10-1521-0/+156
| | | | | | | | | | | | | | | | | | | | | | | | Run "cmake --help-full cmake.1.rst" by hand on Windows and OS X. Copy the generator/*.rst documents for generators unique to those platforms into Help/generator.
| * | | Add reStructuredText (RST) documentation formatterBrad King2013-10-158-4/+180
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Temporarily add a RST formatter to convert builtin documentation to .rst source files. This will be removed shortly after we use it to convert documentation. Teach the RST formatter to: * Output preformatted blocks as reStructuredText "::" literal blocks. * Output option lists as bullet lists with option names enclosed in reStructuredText ``literal`` quoting. * Output individual documentation objects (commands, variables, etc.) in separate .rst files organized in directories by type. Replace references to cmVersion::GetCMakeVersion() in builtin documentation with the literal placeholder "|release|" that will be defined as a substitution later.
| * | | Drop CPack module documentation markup extractionBrad King2013-10-153-386/+0
| | | | | | | | | | | | | | | | This will be replaced by alternative markup later.
| * | | Drop definition of internal propertyBrad King2013-10-151-5/+0
| | | | | | | | | | | | | | | | | | | | The property __CMAKE_DELETE_CACHE_CHANGE_VARS_ is not meant for public exposure.
| * | | Drop CMAKE_STRICT modeBrad King2013-10-159-215/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | With our modern development workflow it is less likely a property will be added to C++ code without documentation. This mode only existed to support the DocTest which had very limited coverage of the properties anyway.
generated by cgit v0.12 at 2024-11-15 07:03:00 (GMT)