summaryrefslogtreecommitdiffstats
path: root/Utilities/Sphinx
Commit message (Collapse)AuthorAgeFilesLines
* Utilities/Sphinx: Add hanging indent to version notesMatthew Woehlke2023-03-141-0/+11
| | | | | | | Tweak HTML styling of version-{added,changed} notes to include a hanging indent. This makes it more obvious what text is part of such a note in cases where the note is lengthy (especially if more than one paragraph), rather than the relevant text blending into the surrounding prose.
* Merge topic 'smart-wrap-signatures'Brad King2023-03-142-12/+76
|\ | | | | | | | | | | | | 39ecaa5da1 Utilities/Sphinx: Improve word wrap of signatures Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8317
| * Utilities/Sphinx: Improve word wrap of signaturesMatthew Woehlke2023-03-132-12/+76
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Implement logic to support several styles of parsing in the new signature directive that control where line breaks are allowed in a signature. The default is 'smart', which forbids breaks inside of square- or angle-brackets. The 'verbatim' option forbids all breaks. In all cases, breaks are always allowed where a newline appears in the source. This seems to Just Work for most writers, but HTML needs some special handling that is accomplished by a new CSS rule and assigning the 'nbsp' class to spaces that are not allowed to break. (ROFF's line wrapping is rather unfortunate here, as it prefers splitting and hyphenating words rather than breaking at a space.)
* | Utilities/Sphinx: Allow explicit target for genexMatthew Woehlke2023-03-131-5/+29
|/ | | | | | | | | | | | | | | | Split the genex directive into its own class, allowing a slight simplification of CMakeObject. Add ability to specify an explicit target name for the same. Use this to provide a target for the `$<TARGET_PROPERTY:prop>` generator expression which is otherwise missing one (due to overlap with `$<TARGET_PROPERTY:tgt,prop>`). With this one can write: :genex:`$<TARGET_PROPERTY:prop> <TARGET_PROPERTY:prop>` to link the second variant. Fixes: #24573
* Utilities/Sphinx: Make signatures linkableMatthew Woehlke2023-03-091-10/+29
| | | | | | | | | | | Add signatures to the collection of observed objects (which can be referenced elsewhere). Don't automatically strip parameters from a :command: reference, as these may now link signatures. (Do, however, munge them into 'text <ref>' form if they aren't already, as not doing so adds an extra '()' for some reason.) Correspondingly, change xref resolution to try to match 'command' when a ref like 'command(args)' is not matched, so that existing links to commands that have not been converted to use the new signature directive don't immediately break.
* Utilities/Sphinx: Refactor Sphinx reference recordingMatthew Woehlke2023-03-081-18/+39
| | | | | | | | | Rewrite how we record objects in our Sphinx extensions to more closely conform to how other domains do likewise, and to store more information than was previously being stored. This is a first step toward being able to record and reference signatures.
* Utilities/Sphinx: Add a directive to document command signaturesMatthew Woehlke2023-03-032-3/+105
| | | | | | | Add a `signature` directive to offer a CMake version of Sphinx's `function` directive, similar to that found in other domains (py, cpp, etc.). Like others, this takes one or more signatures as arguments and creates dt/dd nodes from the signatures and the directive contents.
* Utilities/Sphinx: Drop commented-out code from cmake domain implBrad King2023-02-241-12/+1
| | | | Inspired-by: Alex Turbov <i.zaufi@gmail.com>
* Utilities/Sphinx: Configure linkcheck allowed permanent redirectsBrad King2023-02-171-0/+8
| | | | | Some permanent redirects are part of the structure of their site to make URLs look nicer. Allow them.
* Configure CMake itself with policies through CMake 3.25Brad King2023-02-011-1/+1
|
* Merge topic 'doc-guide-link-style'Brad King2022-11-091-0/+11
|\ | | | | | | | | | | | | 977c38c339 Help: Render guide links as normal text instead of monospace Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7886
| * Help: Render guide links as normal text instead of monospaceAlex Turbov2022-11-081-0/+11
| | | | | | | | | | The guide document names are phrases, not code-like man-page names. Add CSS selectors for `:guide:` links and revert unnecessary properties.
* | Build: Add `SPHINX_LINKCHECK` build optionAlex Turbov2022-11-072-1/+19
| | | | | | | | Run `sphinx-build` to check external links and report broken one.
* | Build: Do not redirect `sphinx-build` output if CMake running in verbose modeAlex Turbov2022-11-071-3/+34
| | | | | | | | | | | | | | | | | | Configuring with `--log-level=VERBOSE` a user can see an output of `sphinx-build` at build time. The other way is to have `VERBOSE` envvar set at configure time. And finally one can set `CMAKE_VERBOSE_MAKEFILE` CMake cache variable.
* | Build: Deduplicate `add_custom_command()` calls for Sphinx targetsAlex Turbov2022-11-071-32/+25
| |
* | Utilities/Sphinx: support cmakedomain running in parallelHenry Schreiner2022-10-241-0/+1
| | | | | | | | | | | | Fixes: #24076 Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>
* | Configure CMake itself with policies through CMake 3.24Brad King2022-10-121-1/+1
|/
* Utilities/Sphinx: Avoid deprecated docutils error handling helpersBrad King2022-10-111-12/+6
| | | | | | | | | | 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
* Build: Modernize some `foreach` calls to use `IN LISTS`/`IN ITEMS`Alex Turbov2022-09-221-9/+3
|
* QtHelp: Update Sphinx issue URLs in commentsFeRD (Frank Dana)2022-09-041-2/+2
| | | | | | 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.
* Configure CMake itself with policies through CMake 3.23Brad King2022-06-141-1/+1
|
* Merge topic 'doc-cmake.org-tutorial-archive'Brad King2022-04-292-6/+54
|\ | | | | | | | | | | | | | | | | 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
| * Tutorial: Provide a source archive when published on cmake.orgBrad King2022-04-282-0/+46
| | | | | | | | | | | | | | | | | | 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
| * Utilities/Sphinx: Add variables listing pre-sphinx commandsBrad King2022-04-271-0/+2
| |
| * Utilities/Sphinx: Clarify names of variables listing post-sphinx commandsBrad King2022-04-271-6/+6
| |
| * Merge branch 'doc-qhelpgenerator' into release-3.23Brad King2022-04-081-6/+6
| |\ | | | | | | | | | Merge-request: !7150
| * \ Merge topic 'ci-cmake.org-help' into release-3.23Brad King2022-04-061-0/+6
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
| * \ \ Merge topic 'ci-cmake.org-help' into release-3.23Brad King2022-04-054-6/+85
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | | | | CMake: Use FindPython instead of FindPythonInterp to build CMake itselfKyle Edwards2022-04-211-2/+2
| | | | | | | | | | | | | | | | | | | | Fixes: #23444
* | | | | Merge topic 'doc-qhelpgenerator'Brad King2022-04-081-6/+6
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
| * | | | Utilities/Sphinx: Update qthelp generation to qhelpgeneratorBrad King2022-04-071-6/+6
| | |_|/ | |/| | | | | | | | | | `qcollectiongenerator` is deprecated in favor of `qhelpgenerator`.
* | | | Merge topic 'ci-cmake.org-help'Brad King2022-04-061-0/+6
|\ \ \ \ | |/ / / | | | | | | | | | | | | | | | | | | | | | | | | 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
| * | | gitlab-ci: Build qthelp-format release documentation for cmake.orgBrad King2022-04-061-0/+6
| | |/ | |/| | | | | | | | | | Previously the qthelp-format release documentation on `cmake.org` was built manually.
* | | Merge branch 'backport-ci-cmake.org-help' into ci-cmake.org-helpBrad King2022-04-054-6/+85
|\ \ \ | |/ /
| * | Utilities/Sphinx: Add OpenSearch link to html page headers on cmake.orgBrad King2022-04-052-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | 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.
| * | Utilities/Sphinx: Add option to build outdated version banner for cmake.orgBrad King2022-04-053-0/+29
| | | | | | | | | | | | | | | This was previously added in a custom branch for building the cmake.org reference documentation.
| * | Utilities/Sphinx: Add undocumented option to build docs for cmake.orgBrad King2022-04-053-6/+50
| | |
* | | Require CMake 3.13+ to configure CMake itselfBrad King2022-02-221-1/+1
| | | | | | | | | | | | | | | | | | 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.
* | | Configure CMake itself with policies through CMake 3.22Brad King2022-02-031-1/+1
| |/ |/|
* | Utilities/Sphinx: Ignore warning in generated texinfo documentationBrad King2022-02-012-0/+4
| |
* | Configure CMake itself with policies through CMake 3.21Brad King2021-10-081-1/+1
|/
* Utilities/Sphinx: Print path to index.html in build outputArcturus Arcturus2021-10-041-0/+7
| | | | | Print the url to index.html in the build output, just so one can "open in browser" from the context menu in some terminals.
* Configure CMake itself with policies through CMake 3.20Brad King2021-06-301-1/+1
|
* Utilities/Sphinx: Index guide section documents for cross-referencingBrad King2021-06-171-0/+11
| | | | | | | | 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.
* Merge topic 'sphinx-4'Brad King2021-05-141-0/+1
|\ | | | | | | | | | | | | bb9c69ed70 Utilities/Sphinx: Update man page config for Sphinx 4 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6126
| * Utilities/Sphinx: Update man page config for Sphinx 4Brad King2021-05-141-0/+1
| | | | | | | | | | | | | | | | 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
* | Utilities: Fix typos and spelling in commentsJosef Angstenberger2021-05-071-1/+1
| |
* | Help: Add option to generate docs with latexpdfHenryk Paluch2021-03-011-17/+48
| |
* | Merge topic 'doc-presets'Brad King2021-02-181-0/+1
|\ \ | |/ | | | | | | | | | | | | | | | | 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
| * Utilities/Sphinx: Avoid converting -- to an en-dashBrad King2021-02-181-0/+1
| |
generated by cgit v0.12 at 2025-01-06 01:25:30 (GMT)