summaryrefslogtreecommitdiffstats
path: root/Source/cmDocumentationFormatterDocbook.cxx
Commit message (Collapse)AuthorAgeFilesLines
* docbook: Fix Sun CC warning on ptr_fun(isalnum)Brad King2012-09-101-1/+8
| | | | | | | | | | | The Sun compiler complains: cmDocumentationFormatterDocbook.cxx", line 230: Warning (Anachronism), badargtype2w: Formal argument x of type int(*)(int) in call to std::ptr_fun<int, int>(int(*)(int)) is being passed extern "C" int(*)(int). Add an intermediate C++ function to forward to the C function.
* docbook: Fix formatter naming convention to avoid shadowBrad King2012-09-091-2/+2
| | | | | | | | | Some compilers complain: cmDocumentationFormatterDocbook.cxx: In member function virtual void cmDocumentationFormatterDocbook::PrintHeader(const char*, const char*, std::ostream&): cmDocumentationFormatterDocbook.cxx:197:73: warning: declaration of docname shadows a member of 'this' [-Wshadow] Fix the name of the member variable.
* docbook: Add support for <abstract> at section level 1Daniel Pfeifer2012-09-081-2/+24
| | | | | | If a section has subsections (ie. subelemens with a title), all elements before the first title are written inside an <abstract>. Also wrap <programlisting> in <para>, to allow preformatted output in abstracts.
* docbook: Cleanup formatter and generated DocBookDaniel Pfeifer2012-09-071-24/+24
| | | | | Comment and whitespace changes, changed docbook version to 4.5, changed <literallayout> to <programlisting> (the latter implies a fixed-size font).
* docbook: Fix the DocBook section outputDaniel Pfeifer2012-09-071-24/+15
| | | | | | | | | | The DocBook formatter used to generate something like: <para id="section"><sect2><title>Title</title></sect2>Some Text</para> Which was completely wrong. In DocBook, a section should look like this: <sect2 id="section"><title>Title</title><para>Some Text</para></sect2>
* docbook: Factor out code to write valid DocBook IDsDaniel Pfeifer2012-09-071-37/+34
| | | | | | | | | | | Attributes in XML may contain alphanumeric characters, underscores, colons and dots. When DocBook is chunked, the dot is often used as a path separator. To generate a valid ID, we take the title of the section, transform all non-alphanumeric characters to underscores and then add a prefix separated with dots. We also add the document name as a prefix, in order to 'xinclude' eg. cmake.docbook and ctest.docbook in the same document. IDs are written in multiple places, so the code is factored to a function.
* docbook: Remove table of contentsDaniel Pfeifer2012-09-071-18/+0
| | | | | | When DocBook is transformed (eg. to PDF, HTML, ...), a TOC is generated from the document's layout. The TOC-like list that the docbook formatter used to generate was both redundant and invalid.
* Remove trailing whitespace from most CMake and C/C++ codeKitware Robot2012-08-131-10/+10
| | | | | | | | | | | | | | | | | Our Git commit hooks disallow modification or addition of lines with trailing whitespace. Wipe out all remnants of trailing whitespace everywhere except third-party code. Run the following shell code: git ls-files -z -- \ bootstrap doxygen.config '*.readme' \ '*.c' '*.cmake' '*.cpp' '*.cxx' \ '*.el' '*.f' '*.f90' '*.h' '*.in' '*.in.l' '*.java' \ '*.mm' '*.pike' '*.py' '*.txt' '*.vim' | egrep -z -v '^(Utilities/cm|Source/(kwsys|CursesDialog/form)/)' | egrep -z -v '^(Modules/CPack\..*\.in)' | xargs -0 sed -i 's/ \+$//'
* Convert CMake to OSI-approved BSD LicenseBrad King2009-09-281-14/+9
| | | | | | | 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.
* BUG: don't create empty <itemizedlist>s (#7289), dblatex didn't like thatAlexander Neundorf2009-01-101-10/+13
| | | | Alex
* ENH: Improve generated documentation formattingBrad King2008-10-101-3/+4
| | | | | | | | | | | | 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.
* STYLE: insert newlines after listitem so the generated lines don't getAlexander Neundorf2008-05-091-1/+1
| | | | | | several thousand characters long Alex
* ENH: Fix generated documentation internal links.Brad King2008-05-051-5/+7
| | | | | | | - Previously all links started in 'command_' which led to conflicts and was confusing for non-command items. - Use a per-section name that is meaningful to humans. - Fix link id names to be valid HTML.
* ENH: add support for creating the documentation in docbook formatAlexander Neundorf2008-02-191-0/+254
(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