| Commit message (Collapse) | Author | Age | Files | Lines |
... | |
| |
| |
| |
| |
| |
| | |
Fixes: #24076
Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>
|
|/ |
|
|
|
|
|
|
|
|
|
|
| |
The `SafeString` and `ErrorString` classes are deprecated and will be
removed in Docutils 0.21 or later. They help avoid encoding errors
during exception handling in Python <= 2.7, but these days we always
use Python 3 to build the documentation, at least during development,
when error cases are most likely to occur.
Fixes: #24039
|
| |
|
|
|
|
|
|
| |
The QtHelp Sphinx generation code contains two links to Sphinx issues
that used old, dead BitBucket URLs. Those issues were migrated to
GitHub, so the dead links can be replaced with working ones.
|
| |
|
|\
| |
| |
| |
| |
| |
| |
| |
| | |
4cb616fed6 Tutorial: Provide a source archive when published on cmake.org
37fb70591e Utilities/Sphinx: Add variables listing pre-sphinx commands
eb7d913a21 Utilities/Sphinx: Clarify names of variables listing post-sphinx commands
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7215
|
| |
| |
| |
| |
| |
| |
| |
| |
| | |
Provide readers following the tutorial on `cmake.org` a direct link to
download the tutorial's source examples. Previously readers had to
fetch the CMake source tree separately and look for the tutorial source
examples inside it.
Fixes: #22475
|
| | |
|
| | |
|
| |\
| | |
| | |
| | | |
Merge-request: !7150
|
| |\ \
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | | |
b691906d27 gitlab-ci: Build qthelp-format release documentation for cmake.org
1ceec19c20 gitlab-ci: Add objects.inv to cmake.org html documentation
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7146
|
| |\ \ \
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | | |
2808281730 gitlab-ci: update cmake.org documentation in release package pipeline
ed00a29cce gitlab-ci: consolidate jobs for cmake.org/cmake/help/git-{master,stage} docs
5c2e8ce515 Utilities/Sphinx: Add OpenSearch link to html page headers on cmake.org
a14905d4df Utilities/Sphinx: Add option to build outdated version banner for cmake.org
cca73b54ae Utilities/Sphinx: Add undocumented option to build docs for cmake.org
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7144
|
| | | | |
| | | | |
| | | | |
| | | | | |
Fixes: #23444
|
|\ \ \ \ \
| | |_|_|/
| |/| | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | | |
bf69fa32c4 Utilities/Sphinx: Update qthelp generation to qhelpgenerator
37904abb58 Help: Add "Updates" section header in 3.22 release notes
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7150
|
| | |_|/
| |/| |
| | | |
| | | | |
`qcollectiongenerator` is deprecated in favor of `qhelpgenerator`.
|
|\ \ \ \
| |/ / /
| | | |
| | | |
| | | |
| | | |
| | | |
| | | | |
b691906d27 gitlab-ci: Build qthelp-format release documentation for cmake.org
1ceec19c20 gitlab-ci: Add objects.inv to cmake.org html documentation
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7146
|
| | |/
| |/|
| | |
| | |
| | | |
Previously the qthelp-format release documentation on `cmake.org` was
built manually.
|
|\ \ \
| |/ / |
|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
Reference an OpenSearch description file that sits outside the content
of any specific version so we only need to maintain one and so that
it can reference the latest version.
This was previously added in a custom branch for building the
cmake.org reference documentation.
|
| | |
| | |
| | |
| | |
| | | |
This was previously added in a custom branch for building the
cmake.org reference documentation.
|
| | | |
|
| | |
| | |
| | |
| | |
| | |
| | | |
In particular, guarantee that policy `CMP0077` has `NEW` behavior.
This will be useful to hard-code options of third-party libraries
without polluting our own cache.
|
| |/
|/| |
|
| | |
|
|/ |
|
|
|
|
|
| |
Print the url to index.html in the build output, just so one can
"open in browser" from the context menu in some terminals.
|
| |
|
|
|
|
|
|
|
|
| |
Extend the change from commit 6185265800 (Utilities/Sphinx: Index
guide-level documents for cross-referencing, 2019-12-06,
v3.17.0-rc1~181^2~1) to name guide documents other than the top level
using their docname instead of their title. This will allow them to be
cross-referenced by a stable name even if their title changes.
|
|\
| |
| |
| |
| |
| |
| | |
bb9c69ed70 Utilities/Sphinx: Update man page config for Sphinx 4
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !6126
|
| |
| |
| |
| |
| |
| |
| |
| | |
Sphinx 4 by default generates `man/#/foo.#`, but older versions generate
`man/foo.#` as our install rules expect. Update our Sphinx config file
to tell Sphinx 4 to use the old layout.
Fixes: #22192
|
| | |
|
| | |
|
|\ \
| |/
| |
| |
| |
| |
| |
| |
| |
| | |
47ab2d4d2e Help: Clarify role of binaryDir inheritance in cmake-presets(7)
0e3c361f77 Help: Link to tool-specific preset arguments from cmake-presets(7)
dd6165fbd4 Help: Mention version 2 in cmake-presets(7)
cdbd1ae64b Utilities/Sphinx: Avoid converting -- to an en-dash
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !5829
|
| | |
|
|/ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
This enables cross-reference syntax for CMake generator expressions:
:genex:`SOME_GENEX`
:genex:`$<SOME_GENEX>`
:genex:`$<SOME_GENEX:...>`
and definition of CMake generator expressions via a directive:
.. genex:: SOME_GENEX
.. genex:: $<SOME_GENEX>
.. genex:: $<SOME_GENEX:...>
It also adds generator expressions defined by the directive and by
`Help/genex/SOME_GENEX.rst` documents to the index.
|
|
|
|
|
|
|
| |
Sphinx theme CSS removes top margin for dd > p combination,
but directives add an intervening div and need a separate rule.
Issue: #19715
|
|\
| |
| |
| |
| |
| |
| | |
f25e4313ac Utilities/Sphinx: Tell Sphinx that documentation is written in English
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !5480
|
| |
| |
| |
| | |
Fixes: #21409
|
|/ |
|
|
|
|
|
|
|
|
| |
Sphinx has deprecated `sphinx.util.pycompat.htmlescape` and
`sphinx.builders.qthelp.QtHelpBuilder`. We only import these as part of
a monkey-patch to work around a bug in versions of sphinx before 1.7.2,
so make that code path conditional. The imports are not deprecated on
the versions where we need them.
|
| |
|
| |
|
|
|
|
|
| |
The idea is that one may set `CTEST_DROP_METHOD` in custom CTest
scripting.
|
| |
|
| |
|
| |
|
| |
|
| |
|