Help: More syntax highlighting for literal blocks

Covers almost all blocks containing actual code, except:

* Parsed-literal blocks can't be highlighted, including many command
  summaries and substitution-heavy docs like find_... commands.
  This is a Sphinx limitation.

* Code with errors, like CMP0049, DEPLOYMENT_ADDITIONAL_FILES,
  DEPLOYMENT_REMOTE_DIRECTORY, @PACKAGE_INIT@ substitution in the
  tutorial, bracket arguments/comments in cmake-language.7 and
  cmake-developer.7.

* FindQt4 module, which needs reformatting.
This commit is contained in:
Nikita Nemkin
2025-01-29 20:05:12 +05:00
committed by Brad King
parent e806a490b6
commit 9890cfc4ec
79 changed files with 339 additions and 176 deletions

View File

@@ -39,7 +39,9 @@ Creating And Installing JARs
.. command:: add_jar
Creates a jar file containing java objects and, optionally, resources::
Creates a jar file containing java objects and, optionally, resources:
.. code-block:: cmake
add_jar(<target_name>
[SOURCES] <source1> [<source2>...] [<resource1>...]
@@ -216,7 +218,9 @@ Creating And Installing JARs
.. command:: install_jar
This command installs the jar file to the given destination::
This command installs the jar file to the given destination:
.. code-block:: cmake
install_jar(<target_name> <destination>)
install_jar(<target_name> DESTINATION <destination> [COMPONENT <component>])
@@ -246,7 +250,9 @@ Creating And Installing JARs
.. command:: install_jni_symlink
Installs JNI symlinks for target generated by :ref:`add_jar() <add_jar>`::
Installs JNI symlinks for target generated by :ref:`add_jar() <add_jar>`:
.. code-block:: cmake
install_jni_symlink(<target_name> <destination>)
install_jni_symlink(<target_name> DESTINATION <destination> [COMPONENT <component>])
@@ -283,7 +289,9 @@ Header Generation
.. versionadded:: 3.4
Generates C header files for java classes::
Generates C header files for java classes:
.. code-block:: cmake
create_javah(TARGET <target> | GENERATED_FILES <VAR>
CLASSES <class>...
@@ -353,7 +361,9 @@ Exporting JAR Targets
.. versionadded:: 3.7
Installs a target export file::
Installs a target export file:
.. code-block:: cmake
install_jar_exports(TARGETS <jars>...
[NAMESPACE <namespace>]
@@ -390,7 +400,9 @@ Exporting JAR Targets
.. versionadded:: 3.7
Writes a target export file::
Writes a target export file:
.. code-block:: cmake
export_jars(TARGETS <jars>...
[NAMESPACE <namespace>]
@@ -418,7 +430,9 @@ Finding JARs
.. command:: find_jar
Finds the specified jar file::
Finds the specified jar file:
.. code-block:: cmake
find_jar(<VAR>
<name> | NAMES <name1> [<name2>...]
@@ -455,7 +469,9 @@ Creating Java Documentation
.. command:: create_javadoc
Creates java documentation based on files and packages::
Creates java documentation based on files and packages:
.. code-block:: cmake
create_javadoc(<VAR>
(PACKAGES <pkg1> [<pkg2>...] | FILES <file1> [<file2>...])