STYLE: make formatting of help a bit more consistent
Alex
This commit is contained in:
parent
f69a6a7c8c
commit
355b1f23af
|
@ -64,9 +64,9 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" aux_source_directory(dir VARIABLE)\n"
|
" aux_source_directory(<dir> <variable>)\n"
|
||||||
"Collects the names of all the source files in the specified "
|
"Collects the names of all the source files in the specified "
|
||||||
"directory and stores the list in the variable provided. This "
|
"directory and stores the list in the <variable> provided. This "
|
||||||
"command is intended to be used by projects that use explicit "
|
"command is intended to be used by projects that use explicit "
|
||||||
"template instantiation. Template instantiation files can be "
|
"template instantiation. Template instantiation files can be "
|
||||||
"stored in a \"Templates\" subdirectory and collected automatically "
|
"stored in a \"Templates\" subdirectory and collected automatically "
|
||||||
|
|
|
@ -60,10 +60,10 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" build_command(variable MAKECOMMAND)\n"
|
" build_command(<variable> <makecommand>)\n"
|
||||||
"Sets the given variable to a string containing the command that "
|
"Sets the given <variable> to a string containing the command that "
|
||||||
"will build this project from the root of the build tree using the "
|
"will build this project from the root of the build tree using the "
|
||||||
"build tool given by MAKECOMMAND. MAKECOMMAND should be msdev, "
|
"build tool given by <makecommand>. <makecommand> should be msdev, "
|
||||||
"nmake, make or one of the end user build tools. "
|
"nmake, make or one of the end user build tools. "
|
||||||
"This is useful for configuring testing systems.";
|
"This is useful for configuring testing systems.";
|
||||||
}
|
}
|
||||||
|
|
|
@ -60,7 +60,7 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" create_test_sourcelist(SourceListName DriverName\n"
|
" create_test_sourcelist(sourceListName driverName\n"
|
||||||
" test1 test2 test3\n"
|
" test1 test2 test3\n"
|
||||||
" EXTRA_INCLUDE include.h\n"
|
" EXTRA_INCLUDE include.h\n"
|
||||||
" FUNCTION function)\n"
|
" FUNCTION function)\n"
|
||||||
|
@ -68,7 +68,7 @@ public:
|
||||||
"a single executable. This is useful when building static executables "
|
"a single executable. This is useful when building static executables "
|
||||||
"with large libraries to shrink the total required size. "
|
"with large libraries to shrink the total required size. "
|
||||||
"The list of source files "
|
"The list of source files "
|
||||||
"needed to build the test driver will be in SourceListName. "
|
"needed to build the test driver will be in sourceListName. "
|
||||||
"DriverName is the name of the test driver program. The rest of "
|
"DriverName is the name of the test driver program. The rest of "
|
||||||
"the arguments consist of a list of test source files, can be "
|
"the arguments consist of a list of test source files, can be "
|
||||||
"semicolon separated. Each test source file should have a function in "
|
"semicolon separated. Each test source file should have a function in "
|
||||||
|
|
|
@ -63,7 +63,7 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" export(TARGETS tgt1 tgt2 ... [PREFIX <prefix>] FILE <filename> "
|
" export(TARGETS tgt1 ... tgtN [PREFIX <prefix>] FILE <filename> "
|
||||||
"[APPEND])\n"
|
"[APPEND])\n"
|
||||||
"Create a file that can be included into a CMake listfile with the "
|
"Create a file that can be included into a CMake listfile with the "
|
||||||
"INCLUDE command. The file will contain a number of SET commands "
|
"INCLUDE command. The file will contain a number of SET commands "
|
||||||
|
|
|
@ -68,10 +68,10 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" export_library_dependencies(FILE [APPEND])\n"
|
" export_library_dependencies(<file> [APPEND])\n"
|
||||||
"Create a file that can be included into a CMake listfile with the "
|
"Create a file named <file> that can be included into a CMake listfile "
|
||||||
"INCLUDE command. The file will contain a number of SET commands "
|
"with the INCLUDE command. The file will contain a number of SET "
|
||||||
"that will set all the variables needed for library dependency "
|
"commands that will set all the variables needed for library dependency "
|
||||||
"information. This should be the last command in the top level "
|
"information. This should be the last command in the top level "
|
||||||
"CMakeLists.txt file of the project. If the APPEND option is "
|
"CMakeLists.txt file of the project. If the APPEND option is "
|
||||||
"specified, the SET commands will be appended to the given file "
|
"specified, the SET commands will be appended to the given file "
|
||||||
|
|
|
@ -60,7 +60,7 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" option(OPTION_VAR \"help string describing option\"\n"
|
" option(<option_variable> \"help string describing option\"\n"
|
||||||
" [initial value])\n"
|
" [initial value])\n"
|
||||||
"Provide an option for the user to select as ON or OFF. If no "
|
"Provide an option for the user to select as ON or OFF. If no "
|
||||||
"initial value is provided, OFF is used.";
|
"initial value is provided, OFF is used.";
|
||||||
|
|
|
@ -65,25 +65,26 @@ public:
|
||||||
virtual const char* GetFullDocumentation()
|
virtual const char* GetFullDocumentation()
|
||||||
{
|
{
|
||||||
return
|
return
|
||||||
" set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])\n"
|
" set(<variable> <value> [CACHE <type> <docstring> [FORCE]])\n"
|
||||||
"Within CMake sets VAR to the value VALUE. VALUE is expanded before "
|
"Within CMake sets <variable> to the value <value>. <value> is expanded"
|
||||||
"VAR is set to it. If CACHE is present, then the VAR is put in the "
|
" before <variable> is set to it. If CACHE is present, then the "
|
||||||
"cache. TYPE and DOCSTRING are required. TYPE is used by the CMake GUI "
|
"<variable> is put in the cache. <type> and <docstring> are then "
|
||||||
"to choose a widget with which the user sets a value. The value for "
|
"required. <type> is used by the CMake GUI to choose a widget with "
|
||||||
"TYPE may be one of\n"
|
"which the user sets a value. The value for <type> may be one of\n"
|
||||||
" FILEPATH = File chooser dialog.\n"
|
" FILEPATH = File chooser dialog.\n"
|
||||||
" PATH = Directory chooser dialog.\n"
|
" PATH = Directory chooser dialog.\n"
|
||||||
" STRING = Arbitrary string.\n"
|
" STRING = Arbitrary string.\n"
|
||||||
" BOOL = Boolean ON/OFF checkbox.\n"
|
" BOOL = Boolean ON/OFF checkbox.\n"
|
||||||
" INTERNAL = No GUI entry (used for persistent variables).\n"
|
" INTERNAL = No GUI entry (used for persistent variables).\n"
|
||||||
"If TYPE is INTERNAL, then the VALUE is always written into the cache, "
|
"If <type> is INTERNAL, then the <value> is always written into the "
|
||||||
"replacing any values existing in the cache. If it is not a cache "
|
"cache, replacing any values existing in the cache. If it is not a "
|
||||||
"variable, then this always writes into the current makefile. The "
|
"cache variable, then this always writes into the current makefile. The "
|
||||||
"FORCE option will overwrite the cache value removing any changes by "
|
"FORCE option will overwrite the cache value removing any changes by "
|
||||||
"the user.\n"
|
"the user.\n"
|
||||||
" set(VAR VALUE1 ... VALUEN).\n"
|
" set(<variable> <value1> ... <valueN>)\n"
|
||||||
"In this case VAR is set to a semicolon separated list of values.\n"
|
"In this case <variable> is set to a semicolon separated list of "
|
||||||
"VAR can be an environment variable such as:\n"
|
"values.\n"
|
||||||
|
"<variable> can be an environment variable such as:\n"
|
||||||
" set( ENV{PATH} /home/martink )\n"
|
" set( ENV{PATH} /home/martink )\n"
|
||||||
"in which case the environment variable will be set.";
|
"in which case the environment variable will be set.";
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue