Mirror
/
Kitware-CMake
mirror of https://github.com/Kitware/CMake.git
1
0
Fork 0
Code Issues Releases Wiki Activity
Browse Source

ENH:Tweaks to dump documentation

pull/1/head
Will Schroeder 25 years ago
parent
b67bacd1be
commit
9a0e8e41de
9 changed files with 109 additions and 108 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 46
      README
  2. 4
      Source/cmAuxSourceDirectoryRule.h
  3. 2
      Source/cmIncludeDirectoryRule.h
  4. 10
      Source/cmLinkLibrariesRule.h
  5. 4
      Source/cmProjectRule.h
  6. 3
      Source/cmSourceFilesRequireRule.h
  7. 2
      Source/cmSubdirRule.h
  8. 4
      Source/cmUnixDefinesRule.h
  9. 4
      Source/cmWin32DefinesRule.h

46
README
View File

@ -53,8 +53,8 @@ Usage: ABSTRACT_FILES(file1 file2 ..)
ADD_TARGET - Add an extra target to the build system.
Usage: ADD_TARGET(Name "command to run")
AUX_SOURCE_DIRECTORY - Add all the source files found in the specified directory to
the build.
AUX_SOURCE_DIRECTORY - Add all the source files found in the specified
directory to the build.
Usage: AUX_SOURCE_DIRECTORY(dir)
EXECUTABLES - Add a list of executables files.
@ -70,8 +70,7 @@ FIND_PROGRARM - Find an executable program.
Usage: FIND_PROGRAM(NAME executable1 executable2 ...)
INCLUDE_DIRECTORIES - Add include directories to the build.
Usage: INCLUDE_DIRECTORIES(dir1 dir2 ...).
Usage: INCLUDE_DIRECTORIES(dir1 dir2 ...)
LIBRARY - Set a name for a library.
Usage: LIBRARY(libraryname)
@ -84,24 +83,26 @@ CMAKE_BINARY_DIR and CMAKE_SOURCE_DIR.
LINK_LIBRARIES - Specify a list of libraries to be linked into executables or
shared objects.
Usage: Specify a list of libraries to be linked into executables or
shared objects. This rule is passed down to all other rules.LINK_LIBRARIES(library1 library2).
The library name should be the same as the name used in the
LIBRARY(library) rule.
Usage: LINK_LIBRARIES(library1 library2)
Specify a list of libraries to be linked into
executables or shared objects. This rule is passed
down to all other rules. The library name should be
the same as the name used in the LIBRARY(library) rule.
PROJECT - Set a name for the entire project. One argument.
Usage: Set the name for the entire project. This takes one argument.
PROJECT(projectname)
Usage: PROJECT(projectname)
Set the name for the entire project. This takes one argument.
SOURCE_FILES - Add a list of source files.
Usage: SOURCE_FILES(file1 file2 ...)
SOURCE_FILES_REQUIRE - Add a list of source files if the required variables are set.
SOURCE_FILES_REQUIRE - Add a list of source files if the required
variables are set.
Usage: SOURCE_FILES_REQUIRE(var1 var2 ... SOURCES_BEGIN file1 file2 ...)
SUBDIRS - Add a list of subdirectories to the build.
Usage: Add a list of subdirectories to the build.
SUBDIRS(dir1 dir2 ...)
Usage: SUBDIRS(dir1 dir2 ...)
Add a list of subdirectories to the build.
This will cause any CMakeLists.txt files in the sub directories
to be processed by CMake.
@ -109,22 +110,19 @@ TESTS - Add a list of executables files that are run as tests.
Usage: TESTS(file1 file2 ...)
UNIX_DEFINES - Add -D flags to the command line for Unix only.
Usage: Add -D flags to the command line for Unix only.
UNIX_DEFINES(-DFOO -DBAR)
Usage: UNIX_DEFINES(-DFOO -DBAR)
Add -D flags to the command line for Unix only.
UNIX_LIBRARIES - Add libraries that are only used for Unix programs.
Usage: UNIX_LIBRARIES(library -lm ...)
WIN32_DEFINES - Add -D define flags to command line for Win32 environments.
Usage: Add -D define flags to command line for Win32 environments.
WIN32_DEFINES(-DFOO -DBAR ...)
Usage: WIN32_DEFINES(-DFOO -DBAR ...)
Add -D define flags to command line for Win32 environments.
WIN32_LIBRARIES - Add libraries that are only used for Win32 programs.
Usage: WIN32_LIBRARIES(library -lm ...)
USING / BUILDING WITH CMAKE
---------------------------
@ -160,10 +158,12 @@ makefile fragments:
CMakeMaster.make -> main file to be included by makefiles
CMakeVariables.make -> all make varibles are set in this file
CMakeRules.make -> All build rules are here (except Simple Rules)
CMakeSimpleRules.make -> simple build rules for .o to .cxx, this is separate
to be able to build CMakeBuildTargets itself.
CMakeSimpleRules.make -> simple build rules for .o to .cxx, this is
separate to be able to build CMakeBuildTargets
itself.
CMakeLocal.make -> Place for hand configuration
CMakeTargets.make -> generated rules for make style build in each directory
CMakeTargets.make -> generated rules for make style build in each
directory
MakefileTemplate.make -> master makefile template used by configure to
generate Makefiles

4
Source/cmAuxSourceDirectoryRule.h
View File

@ -61,8 +61,8 @@ public:
*/
virtual const char* TerseDocumentation()
{
return "Add all the source files found in the specified directory to\n"
" the build.";
return "Add all the source files found in the specified\n"
"directory to the build.";
}
/**

2
Source/cmIncludeDirectoryRule.h
View File

@ -73,7 +73,7 @@ public:
virtual const char* FullDocumentation()
{
return
"INCLUDE_DIRECTORIES(dir1 dir2 ...).\n";
"INCLUDE_DIRECTORIES(dir1 dir2 ...)";
}
};

10
Source/cmLinkLibrariesRule.h
View File

@ -76,11 +76,11 @@ public:
virtual const char* FullDocumentation()
{
return
"Specify a list of libraries to be linked into executables or \n"
"shared objects. This rule is passed down to all other rules."
"LINK_LIBRARIES(library1 library2).\n"
"The library name should be the same as the name used in the\n"
"LIBRARY(library) rule.";
"LINK_LIBRARIES(library1 library2)\n"
"Specify a list of libraries to be linked into\n"
"executables or shared objects. This rule is passed\n"
"down to all other rules. The library name should be\n"
"the same as the name used in the LIBRARY(library) rule.";
}
};

4
Source/cmProjectRule.h
View File

@ -68,8 +68,8 @@ public:
virtual const char* FullDocumentation()
{
return
"Set the name for the entire project. This takes one argument.\n"
"PROJECT(projectname)";
"PROJECT(projectname)\n"
"Set the name for the entire project. This takes one argument.";
}
};

3
Source/cmSourceFilesRequireRule.h
View File

@ -61,7 +61,8 @@ public:
*/
virtual const char* TerseDocumentation()
{
return "Add a list of source files if the required variables are set.";
return "Add a list of source files if the required \n"
"variables are set.";
}
/**

2
Source/cmSubdirRule.h
View File

@ -68,8 +68,8 @@ public:
virtual const char* FullDocumentation()
{
return
"Add a list of subdirectories to the build.\n"
"SUBDIRS(dir1 dir2 ...)\n"
"Add a list of subdirectories to the build.\n"
"This will cause any CMakeLists.txt files in the sub directories\n"
"to be processed by CMake.";
}

4
Source/cmUnixDefinesRule.h
View File

@ -78,8 +78,8 @@ public:
virtual const char* FullDocumentation()
{
return
"Add -D flags to the command line for Unix only.\n"
"UNIX_DEFINES(-DFOO -DBAR)";
"UNIX_DEFINES(-DFOO -DBAR)\n"
"Add -D flags to the command line for Unix only.";
}
};

4
Source/cmWin32DefinesRule.h
View File

@ -78,8 +78,8 @@ public:
virtual const char* FullDocumentation()
{
return
"Add -D define flags to command line for Win32 environments.\n"
"WIN32_DEFINES(-DFOO -DBAR ...)";
"WIN32_DEFINES(-DFOO -DBAR ...)\n"
"Add -D define flags to command line for Win32 environments.";
}
};

Write Preview
Loading…
Cancel
Save