Nicolas Despres
3353d84c14
Usage: Document all options printing usage information.
2011-10-23 22:18:14 +02:00
Nicolas Despres
d3d7e45df2
Remove trailing white-spaces.
2011-10-23 22:15:20 +02:00
Alex Neundorf
d62c51ddc2
-fix documentation from a module which has *only* documentation
...
This is #10466 . It didn't crash for me, but also didn't work.
The issue was that a line ending with something else than a # was considered as the
end of the documentation block. If there was simply the end of the file we didn't
get into the correct branch.
Alex
2010-05-08 10:10:19 +02:00
Bill Hoffman
2c6f8de2cc
Fix for bug #0010466 , fix crash in --help-module.
2010-03-26 16:57:01 -04:00
Zach Mullen
0ae0780055
BUG 9961: ctest --help should not display a Generators section
2009-11-24 11:46:06 -05:00
Brad King
96afb12087
Convert CMake to OSI-approved BSD License
...
This converts the CMake license to a pure 3-clause OSI-approved BSD
License. We drop the previous license clause requiring modified
versions to be plainly marked. We also update the CMake copyright to
cover the full development time range.
2009-09-28 11:43:28 -04:00
Brad King
32258b44bc
ENH: Document CACHE entry properties
...
This adds a property documentation section for CACHE properties.
We document the ADVANCED, HELPSTRING, TYPE, and VALUE properties.
2009-03-10 11:11:15 -04:00
Brad King
46e3956349
COMP: Fix assignment inside condition
2008-10-11 15:35:30 -04:00
Brad King
5a82a0b108
ENH: Improve generated documentation formatting
...
Applying patch provided in issue #7797 .
Fixes to man-pages:
- Character '-' must be espaced as '\-'
- Surround preformatted text with '.nf' and '.fi' to adjust filling
- Give every page a NAME section for indexing by mandb
- Pass the man page filename without extension to .TH in its header
Also added a title to the HTML header.
2008-10-10 11:23:35 -04:00
Brad King
657627c231
BUG: Fix help type for filenames with many dots
...
The help page type should be determined using only the extension after
the last dot. See issue #7797 .
2008-10-10 11:23:17 -04:00
Bill Hoffman
d632b96841
BUG: fix 6647 arguments after -E should not be parsed by CMake
2008-08-19 15:42:48 -04:00
Alexander Neundorf
4175b514fc
ENH: handle HTML documentation for single items better: no warning about
...
ComputeSectionLinkPrefix, don't create an index for only one item
Alex
2008-07-21 17:52:59 -04:00
Bill Hoffman
7173f2db0e
ENH: add master index into html full help
2008-03-05 11:05:22 -05:00
Ken Martin
d47a5951ed
ENH: add --help-policies and --help-policy command line options
2008-03-04 09:16:33 -05:00
Alexander Neundorf
969ea3f449
ENH: add support for creating the documentation in docbook format
...
(http://www.oasis-open.org/docbook/xml/4.2/ ), which users can then convert
to other formats.
Tested with meinproc from KDE, which generates HTML pages which look good.
Alex
2008-02-19 14:33:43 -05:00
Alexander Neundorf
95ba817b2e
BUG: actually print the docs for custom modules if this was requested
...
Alex
2008-02-17 14:04:01 -05:00
Alexander Neundorf
f8f232bdd8
BUG: make -help-module-list work by filling the modules section first, also
...
for custom modules
Alex
2008-01-14 17:05:09 -05:00
Amitha Perera
4d9259c15b
STYLE: Spelling fixes on documentation
2008-01-09 22:09:19 -05:00
Alexander Neundorf
acb27977f0
ENH: sort the module files alphabetically when generating the documentation
...
of rht modules
Alex
2008-01-09 16:59:01 -05:00
Alexander Neundorf
f3ea6a351a
BUG: create modules documentation not only for the first documentation creation step
...
in cmake (the set ModulesFound wasn't cleared at the beginning of each
PrintDocumentation() function, so when documentation for modules was executed the second
time, ModulesFound already contained all modules and so no module was
documented)
Alex
2007-12-29 11:53:36 -05:00
Ken Martin
ad581280a5
BUG: fix single module generation
2007-11-29 10:23:26 -05:00
Ken Martin
c2f0aac146
ENH: some more cleanup, fixes, and patch for HTML output
2007-10-24 11:36:47 -04:00
Ken Martin
8b76142f00
COMP: fix a problem with a shadowed var
2007-10-23 10:07:40 -04:00
Ken Martin
b6f1cb4edf
COMP: fix some warnings and add some doc strings back in
2007-10-22 16:41:15 -04:00
Ken Martin
44cce51a1a
COMP: fix some warnings and add some doc strings back in
2007-10-22 15:33:19 -04:00
Ken Martin
6cdf032505
ENH: change to make the documentation class more generic, about halfway there, also provides secitons for Variables now
2007-10-22 12:49:09 -04:00
Ken Martin
8d32d229a3
ENH: make commands lower case by default
2007-10-10 11:47:43 -04:00
Ken Martin
35e13b11f3
BUG: revert doc changes since VS7 cannot compile them, will implement them in a different manner
2007-10-09 14:35:25 -04:00
Ken Martin
18ce24c748
ENH: make documentation entries actually store their data
2007-10-09 09:55:42 -04:00
Alexander Neundorf
40fa85883c
STYLE: fix line lengths
...
Alex
2007-09-20 08:33:07 -04:00
Alexander Neundorf
31881265c7
ENH: add new help option --help-custom-modules, which generates
...
documentation for all modules found in CMAKE_MODULE_PATH, which currently
has to be specified via -D, this can later on be improved e.g. by reading a
special (to-be-created) file like CMakeFiles/ModulePath.cmake in the build
tree so that running cmake help in the build tree of a project will always
give you the current module path. (This could actually also help IDEs which
would like to support cmake for projects...)
Alex
2007-09-19 13:14:25 -04:00
Alexander Neundorf
c5f249bdbd
STYLE: move the code for the different formats of the generated help into
...
their own classes, making cmDocumentation smaller and also making it easier
to eventually add another format
Alex
2007-09-19 09:05:28 -04:00
Alexander Neundorf
9ec10993f8
BUG: properties and module names are case sensitive
...
Alex
2007-08-09 08:48:56 -04:00
Alexander Neundorf
55303d6dd2
STYLE: fix line lengths
...
Alex
2007-07-20 08:36:16 -04:00
Alexander Neundorf
9f16292b6a
STYLE: sort the property documentation into
...
global/directory/target/test/sourcefile and variable sections
Alex
2007-07-11 15:53:58 -04:00
Alexander Neundorf
ad2fe23f6f
COMP: fix compile on HP-UX with aCC, reusing the same identifier for a
...
variable as for the enum type doesn't work here
Alex
2007-07-03 08:26:32 -04:00
Alexander Neundorf
151d55557e
ENH: generate separate documentation for the commands, compatiblity
...
commands, modules and properties as html, text and man pages.
The names of the man pages are cmcommands, cmcompat, cmprops and cmmodules,
so they are easy to type.
Alex
2007-06-28 15:04:28 -04:00
Alexander Neundorf
c95dc91237
ENH:
...
-in the full documentation there is now an extra section for
compatibility commands, so users see which commands they shouldn't use
-cmake -h <command> now also works with lower case commands
--help-fullm --help-command, --help-module and --help-property now determine
the output format from the extension of the given filename
Let me know if there are some things I overlooked.
Alex
2007-06-28 11:00:57 -04:00
Alexander Neundorf
1d9889c5d3
ENH: put compatibility commands in extra section and prepare for creating
...
separate man pages for properties, modules, commands and compatibility
commands
Alex
2007-06-22 08:44:51 -04:00
Alexander Neundorf
e37f8e2964
STYLE: create command documentation for ctest
...
I think some of the cmake commands should be removed from ctest if possible,
like add_executable etc.
Alex
2007-06-08 16:06:33 -04:00
Brad King
bc8f3d504a
BUG: Patch from Alex to fix single-command help broken by previous patch.
2007-02-06 15:05:56 -05:00
Brad King
58bf0dbac1
ENH: Patch from Alex to improve implementation and prepare for splitting the man page into more sections.
2007-02-01 10:38:42 -05:00
Brad King
1e566707da
COMP: Patch from Alex for const correctness.
2007-01-22 10:52:24 -05:00
Ken Martin
1dd5db0235
COMP: fix some warnings and style issues
2006-12-08 09:27:52 -05:00
Ken Martin
27379d7b08
ENH: make properties a bit more formal with documentation and chaining
2006-12-07 09:45:32 -05:00
Brad King
49bf0b9e3d
ENH: Make hyperlinks in documentation active when generated into HTML documents. This addresses bug#3906.
2006-10-16 14:52:31 -04:00
Ken Martin
cfb3c9eaa9
BUG: potential segfault
2006-10-06 14:00:35 -04:00
Brad King
1bdebd7da6
ENH: Adding links to web resources and FAQ to SEE ALSO section. This addresses bug #3757 .
2006-10-05 10:55:37 -04:00
Brad King
211e991057
BUG: Fixed man page formatting for INSTALL command documentation. Fixed line-too-long warning.
2006-08-22 10:38:10 -04:00
Ken Martin
14781101fd
STYLE: fix line length
2006-05-10 15:01:22 -04:00
Bill Hoffman
96a46bdb44
ENH: search for help modules in the correct place for install and source tree builds
2006-04-13 23:15:48 -04:00
Bill Hoffman
0cae876867
ENH: case insensitive command help
2006-04-12 09:12:01 -04:00
Bill Hoffman
037487a488
ENH: make sure uncommented modules are not documented
2005-12-16 16:49:01 -05:00
Bill Hoffman
4b0fd57bef
ENH: fix module documenation to handle bad docs and fix qt3 docs
2005-12-15 09:19:23 -05:00
Bill Hoffman
b7fa820118
ENH: add documentation support for modules
2005-12-14 13:51:08 -05:00
Andy Cedilnik
0e3b1febbb
ENH: Cleanup the help a bit
2005-07-18 11:32:02 -04:00
Andy Cedilnik
fc70a2bb2a
ENH: Add development version support in CMake
2004-10-22 15:44:54 -04:00
Andy Cedilnik
04016278c6
BUG: Move documentation so that it does not apear in ctest
2004-05-10 17:53:24 -04:00
Brad King
0c92cfb8c4
ENH: Renamed --help-list-commands to --help-command-list and split --help [command] into separate --help and --help-command cmd options.
2004-04-14 14:25:43 -04:00
Brad King
8020279dd6
ENH: Added --help-list-commands option.
2004-04-14 13:40:24 -04:00
Brad King
7d6aaf23e9
BUG: Don't use -V as a version option. It conflicts with ctest.
2003-08-06 18:43:49 -04:00
Brad King
b78888fe38
ENH: Added configuration of name of executable in man page header and version banner.
2003-08-06 14:49:52 -04:00
Brad King
c4794319c7
ENH: Added support to --help to print help for a single command.
2003-08-05 18:10:45 -04:00
Brad King
fde552ea6e
ENH: CheckOptions now takes const argv.
2003-07-23 17:27:34 -04:00
Brad King
90397af164
BUG: Text dump of documentation should be in ascii mode.
2003-07-21 14:58:07 -04:00
Brad King
7c2b4e3a02
ENH: Added SEE ALSO section to generated man page. Minor formatting improvements for generated text-only documentation.
2003-07-10 23:15:45 -04:00
Brad King
6167fa8aa2
ERR: Added missing std::.
2003-07-08 00:28:23 -04:00
Brad King
ed273acfa7
ENH: Improved name of cmake version variables. They are now CMake_VERSION (major.minor) and CMake_VERSION_FULL (major.minor.patch).
2003-07-07 23:20:30 -04:00
Brad King
1cecf7b5aa
ENH: Added support to write multiple help options with one command line. Output files can now also be specified for the help options.
2003-07-07 22:44:18 -04:00
Brad King
e5ed57ec18
ENH: Registered global generators are now kept in a table in the cmake instance. Added support for documentation with a Generators section.
2003-07-07 21:52:10 -04:00
Brad King
3bba5f587e
ENH: Running with zero arguments now produces usage.
2003-04-02 22:44:42 -05:00
Brad King
610da00d51
ERR: Fixed signed/unsigned warning.
2003-02-19 08:52:45 -05:00
Brad King
5e18bec8f7
ENH: Re-implemented document generation class to be more organized and more robust.
2003-02-18 20:42:02 -05:00
Andy Cedilnik
d54e7a6888
Minor documentation fixes
2003-02-17 09:56:41 -05:00
Brad King
07cdd0e60c
ENH: Added header before list of commands in generated docs. Made options more intuitive.
2003-02-17 09:42:13 -05:00
Brad King
7d1ee1d4c8
ERR: Use of stream format flags is hard to make portable. Manually implementing justification.
2003-02-16 11:57:20 -05:00
Brad King
caa074e8b5
ERR: Use of std::ios::fmtflags is not portable to older compilers.
2003-02-15 22:36:06 -05:00
Brad King
dec0b51066
ENH: Improved formatting of plain-text help to add a blank line before the beginning of a preformatted section.
2003-02-14 16:16:06 -05:00
Brad King
0005e70c05
ENH: Further improved formatting. HTML/man/help now all have a consistent appearance.
2003-02-14 13:28:46 -05:00
Brad King
2c7a05edd2
ENH: Improved formatting of documentation.
2003-02-14 13:06:37 -05:00
Brad King
1f55680332
ENH: Added cmDocumentation class to generate various forms of documentation. Each executable will be able to generate its own documentation.
2003-02-14 10:53:37 -05:00