From 0c39a757da4988467bfb870a8cba7339c72fe1a9 Mon Sep 17 00:00:00 2001 From: Brad King Date: Mon, 16 Sep 2013 14:04:39 -0400 Subject: Drop the 'Full' field from cmDocumentationEntry We need only 'Brief' for usage documentation. We no longer have builtin 'Full' documentation, which is now in Help/*/*.rst files. --- Source/CPack/cpack.cxx | 99 +++------- Source/CursesDialog/ccmake.cxx | 16 +- Source/QtDialog/CMakeSetup.cxx | 16 +- Source/cmDocumentation.cxx | 42 ++--- Source/cmDocumentation.h | 6 +- Source/cmDocumentationSection.cxx | 48 +---- Source/cmDocumentationSection.h | 6 +- Source/cmExtraCodeBlocksGenerator.cxx | 7 - Source/cmExtraEclipseCDT4Generator.cxx | 7 - Source/cmExtraSublimeTextGenerator.cxx | 7 - Source/cmGlobalBorlandMakefileGenerator.cxx | 1 - Source/cmGlobalJOMMakefileGenerator.cxx | 1 - Source/cmGlobalKdevelopGenerator.cxx | 10 - Source/cmGlobalMSYSMakefileGenerator.cxx | 2 - Source/cmGlobalMinGWMakefileGenerator.cxx | 2 - Source/cmGlobalNMakeMakefileGenerator.cxx | 1 - Source/cmGlobalNinjaGenerator.cxx | 4 - Source/cmGlobalUnixMakefileGenerator3.cxx | 4 - Source/cmGlobalVisualStudio10Generator.cxx | 5 - Source/cmGlobalVisualStudio11Generator.cxx | 5 - Source/cmGlobalVisualStudio12Generator.cxx | 5 - Source/cmGlobalVisualStudio6Generator.cxx | 1 - Source/cmGlobalVisualStudio71Generator.cxx | 1 - Source/cmGlobalVisualStudio7Generator.cxx | 1 - Source/cmGlobalVisualStudio8Generator.cxx | 6 - Source/cmGlobalVisualStudio9Generator.cxx | 5 - Source/cmGlobalWatcomWMakeGenerator.cxx | 1 - Source/cmGlobalXCodeGenerator.cxx | 1 - Source/cmPropertyDefinition.cxx | 1 - Source/cmStandardIncludes.h | 10 +- Source/cmake.h | 45 +---- Source/cmakemain.cxx | 211 +++++---------------- Source/ctest.cxx | 273 +++++++--------------------- 33 files changed, 187 insertions(+), 663 deletions(-) diff --git a/Source/CPack/cpack.cxx b/Source/CPack/cpack.cxx index f8f6139..677f5b1 100644 --- a/Source/CPack/cpack.cxx +++ b/Source/CPack/cpack.cxx @@ -27,92 +27,42 @@ #include //---------------------------------------------------------------------------- -static const char * cmDocumentationName[][3] = +static const char * cmDocumentationName[][2] = { {0, - " cpack - Packaging driver provided by CMake.", 0}, - {0,0,0} + " cpack - Packaging driver provided by CMake."}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationUsage[][3] = +static const char * cmDocumentationUsage[][2] = { {0, - " cpack -G [options]", - 0}, - {0,0,0} + " cpack -G [options]"}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationOptions[][3] = +static const char * cmDocumentationOptions[][2] = { - {"-G ", "Use the specified generator to generate package.", - "CPack may support multiple native packaging systems on certain " - "platforms. A generator is responsible for generating input files for " - "particular system and invoking that systems. Possible generator names " - "are specified in the Generators section." }, - {"-C ", "Specify the project configuration", - "This option specifies the configuration that the project was build " - "with, for example 'Debug', 'Release'." }, - {"-D =", "Set a CPack variable.", \ - "Set a variable that can be used by the generator."}, \ - {"--config ", "Specify the config file.", - "Specify the config file to use to create the package. By default " - "CPackConfig.cmake in the current directory will be used." }, - {"--verbose,-V","enable verbose output","Run cpack with verbose output."}, - {"--debug","enable debug output (for CPack developers)", - "Run cpack with debug output (for CPack developers)."}, - {"-P ","override/define CPACK_PACKAGE_NAME", - "If the package name is not specified on cpack commmand line then" - "CPack.cmake defines it as CMAKE_PROJECT_NAME"}, - {"-R ","override/define CPACK_PACKAGE_VERSION", - "If version is not specified on cpack command line then" - "CPack.cmake defines it from CPACK_PACKAGE_VERSION_[MAJOR|MINOR|PATCH]" - "look into CPack.cmake for detail"}, - {"-B ","override/define CPACK_PACKAGE_DIRECTORY", - "The directory where CPack will be doing its packaging work." - "The resulting package will be found there. Inside this directory" - "CPack creates '_CPack_Packages' sub-directory which is the" - "CPack temporary directory."}, - {"--vendor ","override/define CPACK_PACKAGE_VENDOR", - "If vendor is not specified on cpack command line " - "(or inside CMakeLists.txt) then" - "CPack.cmake defines it with a default value"}, - {"--help-command cmd [file]", "Print help for a single command and exit.", - "Full documentation specific to the given command is displayed. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-command-list [file]", "List available commands and exit.", - "The list contains all commands for which help may be obtained by using " - "the --help-command argument followed by a command name. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-commands [file]", "Print help for all commands and exit.", - "Full documentation specific for all current command is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, + {"-G ", "Use the specified generator to generate package."}, + {"-C ", "Specify the project configuration"}, + {"-D =", "Set a CPack variable."}, + {"--config ", "Specify the config file."}, + {"--verbose,-V","enable verbose output"}, + {"--debug","enable debug output (for CPack developers)"}, + {"-P ","override/define CPACK_PACKAGE_NAME"}, + {"-R ","override/define CPACK_PACKAGE_VERSION"}, + {"-B ","override/define CPACK_PACKAGE_DIRECTORY"}, + {"--vendor ","override/define CPACK_PACKAGE_VENDOR"}, + {"--help-command cmd [file]", "Print help for a single command and exit."}, + {"--help-command-list [file]", "List available commands and exit."}, + {"--help-commands [file]", "Print help for all commands and exit."}, {"--help-variable var [file]", - "Print help for a single variable and exit.", - "Full documentation specific to the given variable is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-variable-list [file]", "List documented variables and exit.", - "The list contains all variables for which help may be obtained by using " - "the --help-variable argument followed by a variable name. If a file is " - "specified, the help is written into it." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-variables [file]", "Print help for all variables and exit.", - "Full documentation for all variables is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {0,0,0} + "Print help for a single variable and exit."}, + {"--help-variable-list [file]", "List documented variables and exit."}, + {"--help-variables [file]", "Print help for all variables and exit."}, + {0,0} }; //---------------------------------------------------------------------------- @@ -522,7 +472,6 @@ int main (int argc, char *argv[]) cmDocumentationEntry e; e.Name = generatorIt->first.c_str(); e.Brief = generatorIt->second.c_str(); - e.Full = ""; v.push_back(e); } doc.SetSection("Generators",v); diff --git a/Source/CursesDialog/ccmake.cxx b/Source/CursesDialog/ccmake.cxx index 37d0667..3855d53 100644 --- a/Source/CursesDialog/ccmake.cxx +++ b/Source/CursesDialog/ccmake.cxx @@ -23,27 +23,27 @@ #include //---------------------------------------------------------------------------- -static const char * cmDocumentationName[][3] = +static const char * cmDocumentationName[][2] = { {0, - " ccmake - Curses Interface for CMake.", 0}, - {0,0,0} + " ccmake - Curses Interface for CMake."}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationUsage[][3] = +static const char * cmDocumentationUsage[][2] = { {0, " ccmake \n" - " ccmake ", 0}, - {0,0,0} + " ccmake "}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationOptions[][3] = +static const char * cmDocumentationOptions[][2] = { CMAKE_STANDARD_OPTIONS_TABLE, - {0,0,0} + {0,0} }; cmCursesForm* cmCursesForm::CurrentForm=0; diff --git a/Source/QtDialog/CMakeSetup.cxx b/Source/QtDialog/CMakeSetup.cxx index 36b81ea..cfefab2 100644 --- a/Source/QtDialog/CMakeSetup.cxx +++ b/Source/QtDialog/CMakeSetup.cxx @@ -23,27 +23,27 @@ #include //---------------------------------------------------------------------------- -static const char * cmDocumentationName[][3] = +static const char * cmDocumentationName[][2] = { {0, - " cmake-gui - CMake GUI.", 0}, - {0,0,0} + " cmake-gui - CMake GUI."}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationUsage[][3] = +static const char * cmDocumentationUsage[][2] = { {0, " cmake-gui [options]\n" " cmake-gui [options] \n" - " cmake-gui [options] ", 0}, - {0,0,0} + " cmake-gui [options] "}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationOptions[][3] = +static const char * cmDocumentationOptions[][2] = { - {0,0,0} + {0,0} }; int main(int argc, char** argv) diff --git a/Source/cmDocumentation.cxx b/Source/cmDocumentation.cxx index f66866f..2d7feab 100644 --- a/Source/cmDocumentation.cxx +++ b/Source/cmDocumentation.cxx @@ -23,35 +23,23 @@ #include //---------------------------------------------------------------------------- -static const char *cmDocumentationStandardOptions[][3] = -{ - {"--copyright [file]", "Print the CMake copyright and exit.", - "If a file is specified, the copyright is written into it."}, - {"--help,-help,-usage,-h,-H,/?", "Print usage information and exit.", - "Usage describes the basic command line interface and its options."}, - {"--help-full [file]", "Print full help and exit.", - "Full help displays most of the documentation provided by the UNIX " - "man page. It is provided for use on non-UNIX platforms, but is " - "also convenient if the man page is not installed. If a file is " - "specified, the help is written into it."}, - {"--help-html [file]", "Print full help in HTML format.", - "This option is used by CMake authors to help produce web pages. " - "If a file is specified, the help is written into it."}, - {"--help-man [file]", "Print full help as a UNIX man page and exit.", - "This option is used by the cmake build to generate the UNIX man page. " - "If a file is specified, the help is written into it."}, - {"--version,-version,/V [file]", - "Show program name/version banner and exit.", - "If a file is specified, the version is written into it."}, - {0,0,0} +static const char *cmDocumentationStandardOptions[][2] = +{ + {"--copyright [file]", "Print the CMake copyright and exit."}, + {"--help,-help,-usage,-h,-H,/?", "Print usage information and exit."}, + {"--help-full [file]", "Print full help and exit."}, + {"--help-html [file]", "Print full help in HTML format."}, + {"--help-man [file]", "Print full help as a UNIX man page and exit."}, + {"--version,-version,/V [file]"}, + {0,0} }; //---------------------------------------------------------------------------- -static const char *cmDocumentationGeneratorsHeader[][3] = +static const char *cmDocumentationGeneratorsHeader[][2] = { {0, - "The following generators are available on this platform:", 0}, - {0,0,0} + "The following generators are available on this platform:"}, + {0,0} }; //---------------------------------------------------------------------------- @@ -468,7 +456,7 @@ void cmDocumentation::SetSection(const char *name, //---------------------------------------------------------------------------- void cmDocumentation::SetSection(const char *name, - const char *docs[][3]) + const char *docs[][2]) { cmDocumentationSection *sec = new cmDocumentationSection(name, @@ -490,7 +478,7 @@ void cmDocumentation //---------------------------------------------------------------------------- void cmDocumentation::PrependSection(const char *name, - const char *docs[][3]) + const char *docs[][2]) { cmDocumentationSection *sec = 0; if (this->AllSections.find(name) == this->AllSections.end()) @@ -526,7 +514,7 @@ void cmDocumentation::PrependSection(const char *name, //---------------------------------------------------------------------------- void cmDocumentation::AppendSection(const char *name, - const char *docs[][3]) + const char *docs[][2]) { cmDocumentationSection *sec = 0; if (this->AllSections.find(name) == this->AllSections.end()) diff --git a/Source/cmDocumentation.h b/Source/cmDocumentation.h index 37707b4..a4072c5 100644 --- a/Source/cmDocumentation.h +++ b/Source/cmDocumentation.h @@ -65,19 +65,19 @@ public: void SetSection(const char *sectionName, std::vector &docs); void SetSection(const char *sectionName, - const char *docs[][3]); + const char *docs[][2]); void SetSections(std::map §ions); /** Add the documentation to the beginning/end of the section */ void PrependSection(const char *sectionName, - const char *docs[][3]); + const char *docs[][2]); void PrependSection(const char *sectionName, std::vector &docs); void PrependSection(const char *sectionName, cmDocumentationEntry &docs); void AppendSection(const char *sectionName, - const char *docs[][3]); + const char *docs[][2]); void AppendSection(const char *sectionName, std::vector &docs); void AppendSection(const char *sectionName, diff --git a/Source/cmDocumentationSection.cxx b/Source/cmDocumentationSection.cxx index a2dfe70..b0dd8ef 100644 --- a/Source/cmDocumentationSection.cxx +++ b/Source/cmDocumentationSection.cxx @@ -13,69 +13,33 @@ //---------------------------------------------------------------------------- -void cmDocumentationSection::Append(const char *data[][3]) +void cmDocumentationSection::Append(const char *data[][2]) { int i = 0; while(data[i][1]) { this->Entries.push_back(cmDocumentationEntry(data[i][0], - data[i][1], - data[i][2])); + data[i][1])); data += 1; } } //---------------------------------------------------------------------------- -void cmDocumentationSection::Prepend(const char *data[][3]) +void cmDocumentationSection::Prepend(const char *data[][2]) { std::vector tmp; int i = 0; while(data[i][1]) { tmp.push_back(cmDocumentationEntry(data[i][0], - data[i][1], - data[i][2])); + data[i][1])); data += 1; } this->Entries.insert(this->Entries.begin(),tmp.begin(),tmp.end()); } //---------------------------------------------------------------------------- -void cmDocumentationSection::Append(const char *n, const char *b, - const char *f) +void cmDocumentationSection::Append(const char *n, const char *b) { - this->Entries.push_back(cmDocumentationEntry(n,b,f)); + this->Entries.push_back(cmDocumentationEntry(n,b)); } - -#if 0 -//---------------------------------------------------------------------------- -void cmDocumentationSection::Set(const cmDocumentationEntry* header, - const cmDocumentationEntry* section, - const cmDocumentationEntry* footer) -{ - this->Entries.erase(this->Entries.begin(), this->Entries.end()); - if(header) - { - for(const cmDocumentationEntry* op = header; op->brief; ++op) - { - this->Entries.push_back(*op); - } - } - if(section) - { - for(const cmDocumentationEntry* op = section; op->brief; ++op) - { - this->Entries.push_back(*op); - } - } - if(footer) - { - for(const cmDocumentationEntry* op = footer; op->brief; ++op) - { - this->Entries.push_back(*op); - } - } - cmDocumentationEntry empty = {0,0,0}; - this->Entries.push_back(empty); -} -#endif diff --git a/Source/cmDocumentationSection.h b/Source/cmDocumentationSection.h index fd1d505..636860d 100644 --- a/Source/cmDocumentationSection.h +++ b/Source/cmDocumentationSection.h @@ -48,11 +48,11 @@ public: { this->Entries.insert(this->Entries.end(),entries.begin(),entries.end()); } /** Append an entry to this section using NULL terminated chars */ - void Append(const char *[][3]); - void Append(const char *n, const char *b, const char *f); + void Append(const char *[][2]); + void Append(const char *n, const char *b); /** prepend some documentation to this section */ - void Prepend(const char *[][3]); + void Prepend(const char *[][2]); void Prepend(const std::vector &entries) { this->Entries.insert(this->Entries.begin(), entries.begin(),entries.end()); } diff --git a/Source/cmExtraCodeBlocksGenerator.cxx b/Source/cmExtraCodeBlocksGenerator.cxx index dfbb1c0..1e799b8 100644 --- a/Source/cmExtraCodeBlocksGenerator.cxx +++ b/Source/cmExtraCodeBlocksGenerator.cxx @@ -42,13 +42,6 @@ void cmExtraCodeBlocksGenerator { entry.Name = this->GetName(); entry.Brief = "Generates CodeBlocks project files."; - entry.Full = - "Project files for CodeBlocks will be created in the top directory " - "and in every subdirectory which features a CMakeLists.txt file " - "containing a PROJECT() call. " - "Additionally a hierarchy of makefiles is generated into the " - "build tree. The appropriate make program can build the project through " - "the default make target. A \"make install\" target is also provided."; } cmExtraCodeBlocksGenerator::cmExtraCodeBlocksGenerator() diff --git a/Source/cmExtraEclipseCDT4Generator.cxx b/Source/cmExtraEclipseCDT4Generator.cxx index d80e775..bd3d669 100644 --- a/Source/cmExtraEclipseCDT4Generator.cxx +++ b/Source/cmExtraEclipseCDT4Generator.cxx @@ -48,13 +48,6 @@ void cmExtraEclipseCDT4Generator { entry.Name = this->GetName(); entry.Brief = "Generates Eclipse CDT 4.0 project files."; - entry.Full = - "Project files for Eclipse will be created in the top directory. " - "In out of source builds, a linked resource to the top level source " - "directory will be created. " - "Additionally a hierarchy of makefiles is generated into the " - "build tree. The appropriate make program can build the project through " - "the default make target. A \"make install\" target is also provided."; } //---------------------------------------------------------------------------- diff --git a/Source/cmExtraSublimeTextGenerator.cxx b/Source/cmExtraSublimeTextGenerator.cxx index 523fca9..baed733 100644 --- a/Source/cmExtraSublimeTextGenerator.cxx +++ b/Source/cmExtraSublimeTextGenerator.cxx @@ -45,13 +45,6 @@ void cmExtraSublimeTextGenerator { entry.Name = this->GetName(); entry.Brief = "Generates Sublime Text 2 project files."; - entry.Full = - "Project files for Sublime Text 2 will be created in the top directory " - "and in every subdirectory which features a CMakeLists.txt file " - "containing a PROJECT() call. " - "Additionally Makefiles (or build.ninja files) are generated into the " - "build tree. The appropriate make program can build the project through " - "the default make target. A \"make install\" target is also provided."; } cmExtraSublimeTextGenerator::cmExtraSublimeTextGenerator() diff --git a/Source/cmGlobalBorlandMakefileGenerator.cxx b/Source/cmGlobalBorlandMakefileGenerator.cxx index 2a7d61d..6c20952 100644 --- a/Source/cmGlobalBorlandMakefileGenerator.cxx +++ b/Source/cmGlobalBorlandMakefileGenerator.cxx @@ -59,5 +59,4 @@ void cmGlobalBorlandMakefileGenerator { entry.Name = cmGlobalBorlandMakefileGenerator::GetActualName(); entry.Brief = "Generates Borland makefiles."; - entry.Full = ""; } diff --git a/Source/cmGlobalJOMMakefileGenerator.cxx b/Source/cmGlobalJOMMakefileGenerator.cxx index 4af0607..bc15ef2 100644 --- a/Source/cmGlobalJOMMakefileGenerator.cxx +++ b/Source/cmGlobalJOMMakefileGenerator.cxx @@ -65,5 +65,4 @@ void cmGlobalJOMMakefileGenerator { entry.Name = cmGlobalJOMMakefileGenerator::GetActualName(); entry.Brief = "Generates JOM makefiles."; - entry.Full = ""; } diff --git a/Source/cmGlobalKdevelopGenerator.cxx b/Source/cmGlobalKdevelopGenerator.cxx index a81c26c..e7c857e 100644 --- a/Source/cmGlobalKdevelopGenerator.cxx +++ b/Source/cmGlobalKdevelopGenerator.cxx @@ -28,16 +28,6 @@ void cmGlobalKdevelopGenerator { entry.Name = this->GetName(); entry.Brief = "Generates KDevelop 3 project files."; - entry.Full = - "Project files for KDevelop 3 will be created in the top directory " - "and in every subdirectory which features a CMakeLists.txt file " - "containing a PROJECT() call. " - "If you change the settings using KDevelop cmake will try its best " - "to keep your changes when regenerating the project files. " - "Additionally a hierarchy of UNIX makefiles is generated into the " - "build tree. Any " - "standard UNIX-style make program can build the project through the " - "default make target. A \"make install\" target is also provided."; } cmGlobalKdevelopGenerator::cmGlobalKdevelopGenerator() diff --git a/Source/cmGlobalMSYSMakefileGenerator.cxx b/Source/cmGlobalMSYSMakefileGenerator.cxx index d49639b..539d2af 100644 --- a/Source/cmGlobalMSYSMakefileGenerator.cxx +++ b/Source/cmGlobalMSYSMakefileGenerator.cxx @@ -110,6 +110,4 @@ void cmGlobalMSYSMakefileGenerator { entry.Name = cmGlobalMSYSMakefileGenerator::GetActualName(); entry.Brief = "Generates MSYS makefiles."; - entry.Full = "The makefiles use /bin/sh as the shell. " - "They require msys to be installed on the machine."; } diff --git a/Source/cmGlobalMinGWMakefileGenerator.cxx b/Source/cmGlobalMinGWMakefileGenerator.cxx index 1f374d3..e00c7dd 100644 --- a/Source/cmGlobalMinGWMakefileGenerator.cxx +++ b/Source/cmGlobalMinGWMakefileGenerator.cxx @@ -49,6 +49,4 @@ void cmGlobalMinGWMakefileGenerator { entry.Name = cmGlobalMinGWMakefileGenerator::GetActualName(); entry.Brief = "Generates a make file for use with mingw32-make."; - entry.Full = "The makefiles generated use cmd.exe as the shell. " - "They do not require msys or a unix shell."; } diff --git a/Source/cmGlobalNMakeMakefileGenerator.cxx b/Source/cmGlobalNMakeMakefileGenerator.cxx index 7af4ee3..4fbabe4 100644 --- a/Source/cmGlobalNMakeMakefileGenerator.cxx +++ b/Source/cmGlobalNMakeMakefileGenerator.cxx @@ -65,5 +65,4 @@ void cmGlobalNMakeMakefileGenerator { entry.Name = cmGlobalNMakeMakefileGenerator::GetActualName(); entry.Brief = "Generates NMake makefiles."; - entry.Full = ""; } diff --git a/Source/cmGlobalNinjaGenerator.cxx b/Source/cmGlobalNinjaGenerator.cxx index e45d024..bdc08b3 100644 --- a/Source/cmGlobalNinjaGenerator.cxx +++ b/Source/cmGlobalNinjaGenerator.cxx @@ -470,10 +470,6 @@ void cmGlobalNinjaGenerator { entry.Name = cmGlobalNinjaGenerator::GetActualName(); entry.Brief = "Generates build.ninja files (experimental)."; - entry.Full = - "A build.ninja file is generated into the build tree. Recent " - "versions of the ninja program can build the project through the " - "\"all\" target. An \"install\" target is also provided."; } // Implemented in all cmGlobaleGenerator sub-classes. diff --git a/Source/cmGlobalUnixMakefileGenerator3.cxx b/Source/cmGlobalUnixMakefileGenerator3.cxx index 9e23ae9..7ab107f 100644 --- a/Source/cmGlobalUnixMakefileGenerator3.cxx +++ b/Source/cmGlobalUnixMakefileGenerator3.cxx @@ -65,10 +65,6 @@ void cmGlobalUnixMakefileGenerator3 { entry.Name = cmGlobalUnixMakefileGenerator3::GetActualName(); entry.Brief = "Generates standard UNIX makefiles."; - entry.Full = - "A hierarchy of UNIX makefiles is generated into the build tree. Any " - "standard UNIX-style make program can build the project through the " - "default make target. A \"make install\" target is also provided."; } //---------------------------------------------------------------------------- diff --git a/Source/cmGlobalVisualStudio10Generator.cxx b/Source/cmGlobalVisualStudio10Generator.cxx index b2a337c..07ccc33 100644 --- a/Source/cmGlobalVisualStudio10Generator.cxx +++ b/Source/cmGlobalVisualStudio10Generator.cxx @@ -48,11 +48,6 @@ public: virtual void GetDocumentation(cmDocumentationEntry& entry) const { entry.Name = "Visual Studio 10"; entry.Brief = "Generates Visual Studio 10 (2010) project files."; - entry.Full = - "It is possible to append a space followed by the platform name " - "to create project files for a specific target platform. E.g. " - "\"Visual Studio 10 Win64\" will create project files for " - "the x64 processor; \"Visual Studio 10 IA64\" for Itanium."; } virtual void GetGenerators(std::vector& names) const { diff --git a/Source/cmGlobalVisualStudio11Generator.cxx b/Source/cmGlobalVisualStudio11Generator.cxx index 8ae7331..41a349e 100644 --- a/Source/cmGlobalVisualStudio11Generator.cxx +++ b/Source/cmGlobalVisualStudio11Generator.cxx @@ -68,11 +68,6 @@ public: virtual void GetDocumentation(cmDocumentationEntry& entry) const { entry.Name = "Visual Studio 11"; entry.Brief = "Generates Visual Studio 11 (2012) project files."; - entry.Full = - "It is possible to append a space followed by the platform name " - "to create project files for a specific target platform. E.g. " - "\"Visual Studio 11 Win64\" will create project files for " - "the x64 processor; \"Visual Studio 11 ARM\" for ARM."; } virtual void GetGenerators(std::vector& names) const { diff --git a/Source/cmGlobalVisualStudio12Generator.cxx b/Source/cmGlobalVisualStudio12Generator.cxx index c56dfff..c2cdc0b 100644 --- a/Source/cmGlobalVisualStudio12Generator.cxx +++ b/Source/cmGlobalVisualStudio12Generator.cxx @@ -43,11 +43,6 @@ public: virtual void GetDocumentation(cmDocumentationEntry& entry) const { entry.Name = "Visual Studio 12"; entry.Brief = "Generates Visual Studio 12 (2013) project files."; - entry.Full = - "It is possible to append a space followed by the platform name " - "to create project files for a specific target platform. E.g. " - "\"Visual Studio 12 Win64\" will create project files for " - "the x64 processor; \"Visual Studio 12 ARM\" for ARM."; } virtual void GetGenerators(std::vector& names) const { diff --git a/Source/cmGlobalVisualStudio6Generator.cxx b/Source/cmGlobalVisualStudio6Generator.cxx index 5296248..4006df4 100644 --- a/Source/cmGlobalVisualStudio6Generator.cxx +++ b/Source/cmGlobalVisualStudio6Generator.cxx @@ -405,7 +405,6 @@ void cmGlobalVisualStudio6Generator { entry.Name = cmGlobalVisualStudio6Generator::GetActualName(); entry.Brief = "Generates Visual Studio 6 project files."; - entry.Full = ""; } //---------------------------------------------------------------------------- diff --git a/Source/cmGlobalVisualStudio71Generator.cxx b/Source/cmGlobalVisualStudio71Generator.cxx index 51efc46..2643719 100644 --- a/Source/cmGlobalVisualStudio71Generator.cxx +++ b/Source/cmGlobalVisualStudio71Generator.cxx @@ -313,5 +313,4 @@ void cmGlobalVisualStudio71Generator { entry.Name = cmGlobalVisualStudio71Generator::GetActualName(); entry.Brief = "Generates Visual Studio .NET 2003 project files."; - entry.Full = ""; } diff --git a/Source/cmGlobalVisualStudio7Generator.cxx b/Source/cmGlobalVisualStudio7Generator.cxx index 65eb3a9..0b9796d 100644 --- a/Source/cmGlobalVisualStudio7Generator.cxx +++ b/Source/cmGlobalVisualStudio7Generator.cxx @@ -841,7 +841,6 @@ void cmGlobalVisualStudio7Generator { entry.Name = cmGlobalVisualStudio7Generator::GetActualName(); entry.Brief = "Generates Visual Studio .NET 2002 project files."; - entry.Full = ""; } //---------------------------------------------------------------------------- diff --git a/Source/cmGlobalVisualStudio8Generator.cxx b/Source/cmGlobalVisualStudio8Generator.cxx index 92e40a8..b9bc1ae 100644 --- a/Source/cmGlobalVisualStudio8Generator.cxx +++ b/Source/cmGlobalVisualStudio8Generator.cxx @@ -65,11 +65,6 @@ public: virtual void GetDocumentation(cmDocumentationEntry& entry) const { entry.Name = vs8generatorName; entry.Brief = "Generates Visual Studio 8 2005 project files."; - entry.Full = - "It is possible to append a space followed by the platform name " - "to create project files for a specific target platform. E.g. " - "\"Visual Studio 8 2005 Win64\" will create project files for " - "the x64 processor."; } virtual void GetGenerators(std::vector& names) const { @@ -147,7 +142,6 @@ void cmGlobalVisualStudio8Generator { entry.Name = cmGlobalVisualStudio8Generator::GetActualName(); entry.Brief = "Generates Visual Studio 8 2005 project files."; - entry.Full = ""; } //---------------------------------------------------------------------------- diff --git a/Source/cmGlobalVisualStudio9Generator.cxx b/Source/cmGlobalVisualStudio9Generator.cxx index fba6ed1..aadf982 100644 --- a/Source/cmGlobalVisualStudio9Generator.cxx +++ b/Source/cmGlobalVisualStudio9Generator.cxx @@ -70,11 +70,6 @@ public: virtual void GetDocumentation(cmDocumentationEntry& entry) const { entry.Name = vs9generatorName; entry.Brief = "Generates Visual Studio 9 2008 project files."; - entry.Full = - "It is possible to append a space followed by the platform name " - "to create project files for a specific target platform. E.g. " - "\"Visual Studio 9 2008 Win64\" will create project files for " - "the x64 processor; \"Visual Studio 9 2008 IA64\" for Itanium."; } virtual void GetGenerators(std::vector& names) const { diff --git a/Source/cmGlobalWatcomWMakeGenerator.cxx b/Source/cmGlobalWatcomWMakeGenerator.cxx index e3cebc4..6ae8775 100644 --- a/Source/cmGlobalWatcomWMakeGenerator.cxx +++ b/Source/cmGlobalWatcomWMakeGenerator.cxx @@ -62,5 +62,4 @@ void cmGlobalWatcomWMakeGenerator { entry.Name = cmGlobalWatcomWMakeGenerator::GetActualName(); entry.Brief = "Generates Watcom WMake makefiles."; - entry.Full = ""; } diff --git a/Source/cmGlobalXCodeGenerator.cxx b/Source/cmGlobalXCodeGenerator.cxx index 5a0fb07..c8b6832 100644 --- a/Source/cmGlobalXCodeGenerator.cxx +++ b/Source/cmGlobalXCodeGenerator.cxx @@ -3671,7 +3671,6 @@ void cmGlobalXCodeGenerator::GetDocumentation(cmDocumentationEntry& entry) { entry.Name = cmGlobalXCodeGenerator::GetActualName(); entry.Brief = "Generate Xcode project files."; - entry.Full = ""; } //---------------------------------------------------------------------------- diff --git a/Source/cmPropertyDefinition.cxx b/Source/cmPropertyDefinition.cxx index b80c863..3aa9e94 100644 --- a/Source/cmPropertyDefinition.cxx +++ b/Source/cmPropertyDefinition.cxx @@ -17,7 +17,6 @@ cmDocumentationEntry cmPropertyDefinition::GetDocumentation() const cmDocumentationEntry e; e.Name = this->Name; e.Brief = this->ShortDescription; - e.Full = this->FullDescription; return e; } diff --git a/Source/cmStandardIncludes.h b/Source/cmStandardIncludes.h index a4aec2e..d09b304 100644 --- a/Source/cmStandardIncludes.h +++ b/Source/cmStandardIncludes.h @@ -321,14 +321,12 @@ struct cmDocumentationEntry { std::string Name; std::string Brief; - std::string Full; cmDocumentationEntry(){}; - cmDocumentationEntry(const char *doc[3]) + cmDocumentationEntry(const char *doc[2]) { if (doc[0]) this->Name = doc[0]; - if (doc[1]) this->Brief = doc[1]; - if (doc[2]) this->Full = doc[2]; }; - cmDocumentationEntry(const char *n, const char *b, const char *f) - { if (n) this->Name = n; if (b) this->Brief = b; if (f) this->Full = f; }; + if (doc[1]) this->Brief = doc[1];}; + cmDocumentationEntry(const char *n, const char *b) + { if (n) this->Name = n; if (b) this->Brief = b; }; }; /** Data structure to represent a single command line. */ diff --git a/Source/cmake.h b/Source/cmake.h index f9bd74d..a5bef24 100644 --- a/Source/cmake.h +++ b/Source/cmake.h @@ -464,43 +464,12 @@ private: }; #define CMAKE_STANDARD_OPTIONS_TABLE \ - {"-C ", "Pre-load a script to populate the cache.", \ - "When cmake is first run in an empty build tree, it creates a " \ - "CMakeCache.txt file and populates it with customizable settings " \ - "for the project. This option may be used to specify a file from " \ - "which to load cache entries before the first pass through " \ - "the project's cmake listfiles. The loaded entries take priority " \ - "over the project's default values. The given file should be a CMake " \ - "script containing SET commands that use the CACHE option, " \ - "not a cache-format file."}, \ - {"-D :=", "Create a cmake cache entry.", \ - "When cmake is first run in an empty build tree, it creates a " \ - "CMakeCache.txt file and populates it with customizable settings " \ - "for the project. This option may be used to specify a setting " \ - "that takes priority over the project's default value. The option " \ - "may be repeated for as many cache entries as desired."}, \ - {"-U ", "Remove matching entries from CMake cache.", \ - "This option may be used to remove one or more variables from the " \ - "CMakeCache.txt file, globbing expressions using * and ? are supported. "\ - "The option may be repeated for as many cache entries as desired.\n" \ - "Use with care, you can make your CMakeCache.txt non-working."}, \ - {"-G ", "Specify a build system generator.", \ - "CMake may support multiple native build systems on certain platforms. " \ - "A generator is responsible for generating a particular build " \ - "system. Possible generator names are specified in the Generators " \ - "section."},\ - {"-T ", "Specify toolset name if supported by generator.", \ - "Some CMake generators support a toolset name to be given to the " \ - "native build system to choose a compiler. " \ - "This is supported only on specific generators:\n" \ - " Visual Studio >= 10\n" \ - " Xcode >= 3.0\n" \ - "See native build system documentation for allowed toolset names."}, \ - {"-Wno-dev", "Suppress developer warnings.",\ - "Suppress warnings that are meant for the author"\ - " of the CMakeLists.txt files."},\ - {"-Wdev", "Enable developer warnings.",\ - "Enable warnings that are meant for the author"\ - " of the CMakeLists.txt files."} + {"-C ", "Pre-load a script to populate the cache."}, \ + {"-D :=", "Create a cmake cache entry."}, \ + {"-U ", "Remove matching entries from CMake cache."}, \ + {"-G ", "Specify a build system generator."},\ + {"-T ", "Specify toolset name if supported by generator."}, \ + {"-Wno-dev", "Suppress developer warnings."},\ + {"-Wdev", "Enable developer warnings."} #endif diff --git a/Source/cmakemain.cxx b/Source/cmakemain.cxx index b05dec3..6e2125f 100644 --- a/Source/cmakemain.cxx +++ b/Source/cmakemain.cxx @@ -28,20 +28,20 @@ #ifdef CMAKE_BUILD_WITH_CMAKE //---------------------------------------------------------------------------- -static const char * cmDocumentationName[][3] = +static const char * cmDocumentationName[][2] = { {0, - " cmake - Cross-Platform Makefile Generator.", 0}, - {0,0,0} + " cmake - Cross-Platform Makefile Generator."}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationUsage[][3] = +static const char * cmDocumentationUsage[][2] = { {0, " cmake [options] \n" - " cmake [options] ", 0}, - {0,0,0} + " cmake [options] "}, + {0,0} }; #define CMAKE_BUILD_OPTIONS \ @@ -57,179 +57,50 @@ static const char * cmDocumentationUsage[][3] = " -- = Pass remaining options to the native tool.\n" //---------------------------------------------------------------------------- -static const char * cmDocumentationOptions[][3] = +static const char * cmDocumentationOptions[][2] = { CMAKE_STANDARD_OPTIONS_TABLE, - {"-E", "CMake command mode.", - "For true platform independence, CMake provides a list of commands " - "that can be used on all systems. Run with -E help for the usage " - "information. Commands available are: chdir, compare_files, copy, " - "copy_directory, copy_if_different, echo, echo_append, environment, " - "make_directory, md5sum, remove, remove_directory, rename, tar, time, " - "touch, touch_nocreate. In addition, some platform specific commands " - "are available. " - "On Windows: comspec, delete_regv, write_regv. " - "On UNIX: create_symlink."}, - {"-i", "Run in wizard mode.", - "Wizard mode runs cmake interactively without a GUI. The user is " - "prompted to answer questions about the project configuration. " - "The answers are used to set cmake cache values."}, - {"-L[A][H]", "List non-advanced cached variables.", - "List cache variables will run CMake and list all the variables from the " - "CMake cache that are not marked as INTERNAL or ADVANCED. This will " - "effectively display current CMake settings, which can then be changed " - "with -D option. Changing some of the variables may result in more " - "variables being created. If A is specified, then it will display also " - "advanced variables. If H is specified, it will also display help for " - "each variable."}, - {"--build ", "Build a CMake-generated project binary tree.", - "This abstracts a native build tool's command-line interface with the " - "following options:\n" - CMAKE_BUILD_OPTIONS - "Run cmake --build with no options for quick help."}, - {"-N", "View mode only.", - "Only load the cache. Do not actually run configure and generate steps."}, - {"-P ", "Process script mode.", - "Process the given cmake file as a script written in the CMake language. " - "No configure or generate step is performed and the cache is not" - " modified. If variables are defined using -D, this must be done " - "before the -P argument."}, - {"--find-package", "Run in pkg-config like mode.", - "Search a package using find_package() and print the resulting flags " - "to stdout. This can be used to use cmake instead of pkg-config to find " - "installed libraries in plain Makefile-based projects or in " - "autoconf-based projects (via share/aclocal/cmake.m4)."}, + {"-E", "CMake command mode."}, + {"-i", "Run in wizard mode."}, + {"-L[A][H]", "List non-advanced cached variables."}, + {"--build ", "Build a CMake-generated project binary tree."}, + {"-N", "View mode only."}, + {"-P ", "Process script mode."}, + {"--find-package", "Run in pkg-config like mode."}, {"--graphviz=[file]", "Generate graphviz of dependencies, see " - "CMakeGraphVizOptions.cmake for more.", - "Generate a graphviz input file that will contain all the library and " - "executable dependencies in the project. See the documentation for " - "CMakeGraphVizOptions.cmake for more details. "}, - {"--system-information [file]", "Dump information about this system.", - "Dump a wide range of information about the current system. If run " - "from the top of a binary tree for a CMake project it will dump " - "additional information such as the cache, log files etc."}, + "CMakeGraphVizOptions.cmake for more."}, + {"--system-information [file]", "Dump information about this system."}, {"--debug-trycompile", "Do not delete the try_compile build tree. Only " - "useful on one try_compile at a time.", - "Do not delete the files and directories created for try_compile calls. " - "This is useful in debugging failed try_compiles. It may however " - "change the results of the try-compiles as old junk from a previous " - "try-compile may cause a different test to either pass or fail " - "incorrectly. This option is best used for one try-compile at a time, " - "and only when debugging." }, - {"--debug-output", "Put cmake in a debug mode.", - "Print extra stuff during the cmake run like stack traces with " - "message(send_error ) calls."}, - {"--trace", "Put cmake in trace mode.", - "Print a trace of all calls made and from where with " - "message(send_error ) calls."}, - {"--warn-uninitialized", "Warn about uninitialized values.", - "Print a warning when an uninitialized variable is used."}, - {"--warn-unused-vars", "Warn about unused variables.", - "Find variables that are declared or set, but not used."}, - {"--no-warn-unused-cli", "Don't warn about command line options.", - "Don't find variables that are declared on the command line, but not " - "used."}, + "useful on one try_compile at a time."}, + {"--debug-output", "Put cmake in a debug mode."}, + {"--trace", "Put cmake in trace mode."}, + {"--warn-uninitialized", "Warn about uninitialized values."}, + {"--warn-unused-vars", "Warn about unused variables."}, + {"--no-warn-unused-cli", "Don't warn about command line options."}, {"--check-system-vars", "Find problems with variable usage in system " - "files.", "Normally, unused and uninitialized variables are searched for " - "only in CMAKE_SOURCE_DIR and CMAKE_BINARY_DIR. This flag tells CMake to " - "warn about other files as well."}, - {"--help-command cmd [file]", "Print help for a single command and exit.", - "Full documentation specific to the given command is displayed. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-command-list [file]", "List available listfile commands and exit.", - "The list contains all commands for which help may be obtained by using " - "the --help-command argument followed by a command name. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-commands [file]", "Print help for all commands and exit.", - "Full documentation specific for all current commands is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-compatcommands [file]", "Print help for compatibility commands. ", - "Full documentation specific for all compatibility commands is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-module module [file]", "Print help for a single module and exit.", - "Full documentation specific to the given module is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-module-list [file]", "List available modules and exit.", - "The list contains all modules for which help may be obtained by using " - "the --help-module argument followed by a module name. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-modules [file]", "Print help for all modules and exit.", - "Full documentation for all modules is displayed. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, + "files."}, + {"--help-command cmd [file]", "Print help for a single command and exit."}, + {"--help-command-list [file]", "List available listfile commands and exit."}, + {"--help-commands [file]", "Print help for all commands and exit."}, + {"--help-compatcommands [file]", "Print help for compatibility commands. "}, + {"--help-module module [file]", "Print help for a single module and exit."}, + {"--help-module-list [file]", "List available modules and exit."}, + {"--help-modules [file]", "Print help for all modules and exit."}, {"--help-custom-modules [file]" , "Print help for all custom modules and " - "exit.", - "Full documentation for all custom modules is displayed. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, + "exit."}, {"--help-policy cmp [file]", - "Print help for a single policy and exit.", - "Full documentation specific to the given policy is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-policy-list [file]", "List available policies and exit.", - "The list contains all policies for which help may be obtained by using " - "the --help-policy argument followed by a policy name. " - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-policies [file]", "Print help for all policies and exit.", - "Full documentation for all policies is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, + "Print help for a single policy and exit."}, + {"--help-policy-list [file]", "List available policies and exit."}, + {"--help-policies [file]", "Print help for all policies and exit."}, {"--help-property prop [file]", - "Print help for a single property and exit.", - "Full documentation specific to the given property is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-property-list [file]", "List available properties and exit.", - "The list contains all properties for which help may be obtained by using " - "the --help-property argument followed by a property name. If a file is " - "specified, the help is written into it." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-properties [file]", "Print help for all properties and exit.", - "Full documentation for all properties is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, + "Print help for a single property and exit."}, + {"--help-property-list [file]", "List available properties and exit."}, + {"--help-properties [file]", "Print help for all properties and exit."}, {"--help-variable var [file]", - "Print help for a single variable and exit.", - "Full documentation specific to the given variable is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-variable-list [file]", "List documented variables and exit.", - "The list contains all variables for which help may be obtained by using " - "the --help-variable argument followed by a variable name. If a file is " - "specified, the help is written into it." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {"--help-variables [file]", "Print help for all variables and exit.", - "Full documentation for all variables is displayed." - "If a file is specified, the documentation is written into and the output " - "format is determined depending on the filename suffix. Supported are man " - "page, HTML, DocBook and plain text."}, - {0,0,0} + "Print help for a single variable and exit."}, + {"--help-variable-list [file]", "List documented variables and exit."}, + {"--help-variables [file]", "Print help for all variables and exit."}, + {0,0} }; #endif diff --git a/Source/ctest.cxx b/Source/ctest.cxx index 9798554..6e3a86b 100644 --- a/Source/ctest.cxx +++ b/Source/ctest.cxx @@ -20,235 +20,98 @@ #include "CTest/cmCTestLaunch.h" //---------------------------------------------------------------------------- -static const char * cmDocumentationName[][3] = +static const char * cmDocumentationName[][2] = { {0, - " ctest - Testing driver provided by CMake.", 0}, - {0,0,0} + " ctest - Testing driver provided by CMake."}, + {0,0} }; //---------------------------------------------------------------------------- -static const char * cmDocumentationUsage[][3] = +static const char * cmDocumentationUsage[][2] = { {0, - " ctest [options]", 0}, - {0,0,0} + " ctest [options]"}, + {0,0} }; //---------------------------------------------------------------------------- //---------------------------------------------------------------------------- -static const char * cmDocumentationOptions[][3] = +static const char * cmDocumentationOptions[][2] = { - {"-C , --build-config ", "Choose configuration to test.", - "Some CMake-generated build trees can have multiple build configurations " - "in the same tree. This option can be used to specify which one should " - "be tested. Example configurations are \"Debug\" and \"Release\"."}, - {"-V,--verbose", "Enable verbose output from tests.", - "Test output is normally suppressed and only summary information is " - "displayed. This option will show all test output."}, - {"-VV,--extra-verbose", "Enable more verbose output from tests.", - "Test output is normally suppressed and only summary information is " - "displayed. This option will show even more test output."}, - {"--debug", "Displaying more verbose internals of CTest.", - "This feature will result in a large number of output that is mostly " - "useful for debugging dashboard problems."}, - {"--output-on-failure", "Output anything outputted by the test program " - "if the test should fail. This option can also be enabled by setting " - "the environment variable CTEST_OUTPUT_ON_FAILURE"}, - {"-F", "Enable failover.", "This option allows ctest to resume a test " - "set execution that was previously interrupted. If no interruption " - "occurred, the -F option will have no effect."}, + {"-C , --build-config ", "Choose configuration to test."}, + {"-V,--verbose", "Enable verbose output from tests."}, + {"-VV,--extra-verbose", "Enable more verbose output from tests."}, + {"--debug", "Displaying more verbose internals of CTest."}, + {"--output-on-failure"}, + {"-F", "Enable failover."}, {"-j , --parallel ", "Run the tests in parallel using the" - "given number of jobs.", - "This option tells ctest to run the tests in parallel using given " - "number of jobs. This option can also be set by setting " - "the environment variable CTEST_PARALLEL_LEVEL."}, - {"-Q,--quiet", "Make ctest quiet.", - "This option will suppress all the output. The output log file will " - "still be generated if the --output-log is specified. Options such " - "as --verbose, --extra-verbose, and --debug are ignored if --quiet is " - "specified."}, - {"-O , --output-log ", "Output to log file", - "This option tells ctest to write all its output to a log file."}, - {"-N,--show-only", "Disable actual execution of tests.", - "This option tells ctest to list the tests that would be run but not " - "actually run them. Useful in conjunction with the -R and -E options."}, + "given number of jobs."}, + {"-Q,--quiet", "Make ctest quiet."}, + {"-O , --output-log ", "Output to log file"}, + {"-N,--show-only", "Disable actual execution of tests."}, {"-L , --label-regex ", "Run tests with labels matching " - "regular expression.", - "This option tells ctest to run only the tests whose labels match the " - "given regular expression."}, + "regular expression."}, {"-R , --tests-regex ", "Run tests matching regular " - "expression.", - "This option tells ctest to run only the tests whose names match the " - "given regular expression."}, + "expression."}, {"-E , --exclude-regex ", "Exclude tests matching regular " - "expression.", - "This option tells ctest to NOT run the tests whose names match the " - "given regular expression."}, + "expression."}, {"-LE , --label-exclude ", "Exclude tests with labels " - "matching regular expression.", - "This option tells ctest to NOT run the tests whose labels match the " - "given regular expression."}, - {"-D , --dashboard ", "Execute dashboard test", - "This option tells ctest to act as a Dart client and perform " - "a dashboard test. All tests are , where Mode can be " - "Experimental, Nightly, and Continuous, and Test can be Start, Update, " - "Configure, Build, Test, Coverage, and Submit."}, - {"-D :=", "Define a variable for script mode", - "Pass in variable values on the command line. Use in " - "conjunction with -S to pass variable values to a dashboard script. " - "Parsing -D arguments as variable values is only attempted if " - "the value following -D does not match any of the known dashboard " - "types."}, - {"-M , --test-model ", "Sets the model for a dashboard", - "This option tells ctest to act as a Dart client " - "where the TestModel can be Experimental, " - "Nightly, and Continuous. Combining -M and -T is similar to -D"}, + "matching regular expression."}, + {"-D , --dashboard ", "Execute dashboard test"}, + {"-D :=", "Define a variable for script mode"}, + {"-M , --test-model ", "Sets the model for a dashboard"}, {"-T , --test-action ", "Sets the dashboard action to " - "perform", - "This option tells ctest to act as a Dart client " - "and perform some action such as start, build, test etc. " - "Combining -M and -T is similar to -D"}, - {"--track ", "Specify the track to submit dashboard to", - "Submit dashboard to specified track instead of default one. By " - "default, the dashboard is submitted to Nightly, Experimental, or " - "Continuous track, but by specifying this option, the track can be " - "arbitrary."}, + "perform"}, + {"--track ", "Specify the track to submit dashboard to"}, {"-S