STYLE: make formatting of help a bit more consistent

Alex
This commit is contained in:
Alexander Neundorf 2007-12-20 17:49:38 -05:00
parent f69a6a7c8c
commit 355b1f23af
7 changed files with 26 additions and 25 deletions

View File

@ -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 "

View File

@ -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.";
} }

View File

@ -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 "

View File

@ -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 "

View File

@ -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 "

View 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.";

View File

@ -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.";
} }