Bill Hoffman
f9687e328f
Merge in changes to CMake-2-8 RC 2
2009-10-01 17:21: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