Merge topic 'no-smiley'

24fa04018c Help: Spell out ";-list" as "semicolon-separated list"

Acked-by: Kitware Robot <[email protected]>
Merge-request: !2528

Help/command/FIND_XXX.txt

@@ -96,7 +96,7 @@ If ``NO_DEFAULT_PATH`` is not specified, the search process is as follows:
 
 2. Search paths specified in cmake-specific cache variables.
    These are intended to be used on the command line with a ``-DVAR=value``.
-   The values are interpreted as :ref:`;-lists <CMake Language Lists>`.
+   The values are interpreted as :ref:`semicolon-separated lists <CMake Language Lists>`.
    This can be skipped if ``NO_CMAKE_PATH`` is passed.
 
    * |CMAKE_PREFIX_PATH_XXX|

Help/command/execute_process.rst

@@ -56,7 +56,7 @@ Options:
 
 ``RESULTS_VARIABLE <variable>``
  The variable will be set to contain the result of all processes as a
- :ref:`;-list <CMake Language Lists>`, in order of the given ``COMMAND``
+ :ref:`semicolon-separated list <CMake Language Lists>`, in order of the given ``COMMAND``
  arguments.  Each entry will be an integer return code from the
  corresponding child or a string describing an error condition.
 

Help/command/find_package.rst

@@ -291,7 +291,7 @@ enabled.
 
 2. Search paths specified in cmake-specific cache variables.  These
    are intended to be used on the command line with a ``-DVAR=value``.
-   The values are interpreted as :ref:`;-lists <CMake Language Lists>`.
+   The values are interpreted as :ref:`semicolon-separated lists <CMake Language Lists>`.
    This can be skipped if ``NO_CMAKE_PATH`` is passed::
 
      CMAKE_PREFIX_PATH

Help/command/set.rst

@@ -8,7 +8,7 @@ and cache entries.
 
 Signatures of this command that specify a ``<value>...`` placeholder
 expect zero or more arguments.  Multiple arguments will be joined as
-a :ref:`;-list <CMake Language Lists>` to form the actual variable
+a :ref:`semicolon-separated list <CMake Language Lists>` to form the actual variable
 value to be set.  Zero arguments will cause normal variables to be
 unset.  See the :command:`unset` command to unset variables explicitly.
 

Help/command/target_link_libraries.rst

@@ -94,7 +94,7 @@ Each ``<item>`` may be:
 
 * **A generator expression**: A ``$<...>`` :manual:`generator expression
   <cmake-generator-expressions(7)>` may evaluate to any of the above
-  items or to a :ref:`;-list <CMake Language Lists>` of them.
+  items or to a :ref:`semicolon-separated list <CMake Language Lists>` of them.
   If the ``...`` contains any ``;`` characters, e.g. after evaluation
   of a ``${list}`` variable, be sure to use an explicitly quoted
   argument ``"$<...>"`` so that this command receives it as a

Help/prop_dir/BUILDSYSTEM_TARGETS.rst

@@ -2,7 +2,7 @@ BUILDSYSTEM_TARGETS
 -------------------
 
 This read-only directory property contains a
-:ref:`;-list <CMake Language Lists>` of buildsystem targets added in the
+:ref:`semicolon-separated list <CMake Language Lists>` of buildsystem targets added in the
 directory by calls to the :command:`add_library`, :command:`add_executable`,
 and :command:`add_custom_target` commands.  The list does not include any
 :ref:`Imported Targets` or :ref:`Alias Targets`, but does include

Help/prop_dir/COMPILE_OPTIONS.rst

@@ -3,7 +3,7 @@ COMPILE_OPTIONS
 
 List of options to pass to the compiler.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 given so far to the :command:`add_compile_options` command.
 
 This property is used to initialize the :prop_tgt:`COMPILE_OPTIONS` target

Help/prop_dir/LINK_DIRECTORIES.rst

@@ -3,7 +3,7 @@ LINK_DIRECTORIES
 
 List of linker search directories.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of directories
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of directories
 and is typically populated using the :command:`link_directories` command.
 It gets its initial value from its parent directory, if it has one.
 

Help/prop_dir/LINK_OPTIONS.rst

@@ -4,7 +4,7 @@ LINK_OPTIONS
 List of options to use for the link step of shared library, module
 and executable targets.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 given so far to the :command:`add_link_options` command.
 
 This property is used to initialize the :prop_tgt:`LINK_OPTIONS` target

Help/prop_dir/SUBDIRECTORIES.rst

@@ -2,7 +2,7 @@ SUBDIRECTORIES
 --------------
 
 This read-only directory property contains a
-:ref:`;-list <CMake Language Lists>` of subdirectories processed so far by
+:ref:`semicolon-separated list <CMake Language Lists>` of subdirectories processed so far by
 the :command:`add_subdirectory` or :command:`subdirs` commands.  Each entry is
 the absolute path to the source directory (containing the ``CMakeLists.txt``
 file).  This is suitable to pass to the :command:`get_property` command

Help/prop_dir/TESTS.rst

@@ -3,5 +3,5 @@ TESTS
 
 List of tests.
 
-This read-only property holds a :ref:`;-list <CMake Language Lists>` of tests
+This read-only property holds a :ref:`semicolon-separated list <CMake Language Lists>` of tests
 defined so far, in the current directory, by the :command:`add_test` command.

Help/prop_sf/COMPILE_OPTIONS.rst

@@ -3,7 +3,7 @@ COMPILE_OPTIONS
 
 List of additional options to pass to the compiler.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 and will be added to the list of compile flags when this
 source file builds.  Use :prop_sf:`COMPILE_DEFINITIONS` to pass
 additional preprocessor definitions and :prop_sf:`INCLUDE_DIRECTORIES` to pass

Help/prop_sf/INCLUDE_DIRECTORIES.rst

@@ -3,7 +3,7 @@ INCLUDE_DIRECTORIES
 
 List of preprocessor include file search directories.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of paths
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of paths
 and will be added to the list of include directories when this
 source file builds. These directories will take precedence over directories
 defined at target level except for :generator:`Xcode` generator due to technical

Help/prop_sf/OBJECT_DEPENDS.rst

@@ -3,7 +3,7 @@ OBJECT_DEPENDS
 
 Additional files on which a compiled object file depends.
 
-Specifies a :ref:`;-list <CMake Language Lists>` of full-paths to
+Specifies a :ref:`semicolon-separated list <CMake Language Lists>` of full-paths to
 files on which any object files compiled from this source file depend.
 On :ref:`Makefile Generators` and the :generator:`Ninja` generator an
 object file will be recompiled if any of the named files is newer than it.

Help/prop_tgt/AUTOMOC_MACRO_NAMES.rst

@@ -1,7 +1,7 @@
 AUTOMOC_MACRO_NAMES
 -------------------
 
-A :ref:`;-list <CMake Language Lists>` list of macro names used by
+A :ref:`semicolon-separated list <CMake Language Lists>` list of macro names used by
 :prop_tgt:`AUTOMOC` to determine if a C++ file needs to be processed by ``moc``.
 
 This property is only used if the :prop_tgt:`AUTOMOC` property is ``ON``

Help/prop_tgt/BUILD_RPATH.rst

@@ -1,7 +1,7 @@
 BUILD_RPATH
 -----------
 
-A :ref:`;-list <CMake Language Lists>` specifying runtime path (``RPATH``)
+A :ref:`semicolon-separated list <CMake Language Lists>` specifying runtime path (``RPATH``)
 entries to add to binaries linked in the build tree (for platforms that
 support it).  The entries will *not* be used for binaries in the install
 tree.  See also the :prop_tgt:`INSTALL_RPATH` target property.

Help/prop_tgt/COMPILE_OPTIONS.rst

@@ -3,7 +3,7 @@ COMPILE_OPTIONS
 
 List of options to pass to the compiler.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 specified so far for its target.  Use the :command:`target_compile_options`
 command to append more options.
 

Help/prop_tgt/IMPORTED_OBJECTS.rst

@@ -1,7 +1,7 @@
 IMPORTED_OBJECTS
 ----------------
 
-:ref:`;-list <CMake Language Lists>` of absolute paths to the object
+A :ref:`semicolon-separated list <CMake Language Lists>` of absolute paths to the object
 files on disk for an :ref:`imported <Imported targets>`
 :ref:`object library <object libraries>`.
 

Help/prop_tgt/LANG_CLANG_TIDY.rst

@@ -3,7 +3,7 @@
 
 This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``.
 
-Specify a :ref:`;-list <CMake Language Lists>` containing a command
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command
 line for the ``clang-tidy`` tool.  The :ref:`Makefile Generators`
 and the :generator:`Ninja` generator will run this tool along with the
 compiler and report a warning if the tool reports any problems.

Help/prop_tgt/LANG_COMPILER_LAUNCHER.rst

@@ -4,7 +4,7 @@
 This property is implemented only when ``<LANG>`` is ``C``, ``CXX``,
 ``Fortran``, or ``CUDA``.
 
-Specify a :ref:`;-list <CMake Language Lists>` containing a command line
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
 for a compiler launching tool. The :ref:`Makefile Generators` and the
 :generator:`Ninja` generator will run this tool and pass the compiler and
 its arguments to the tool. Some example tools are distcc and ccache.

Help/prop_tgt/LANG_CPPCHECK.rst

@@ -3,7 +3,7 @@
 
 This property is supported only when ``<LANG>`` is ``C`` or ``CXX``.
 
-Specify a :ref:`;-list <CMake Language Lists>` containing a command line
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
 for the ``cppcheck`` static analysis tool.  The :ref:`Makefile Generators`
 and the :generator:`Ninja` generator will run ``cppcheck`` along with the
 compiler and report any problems.  If the command-line specifies the

Help/prop_tgt/LANG_CPPLINT.rst

@@ -3,7 +3,7 @@
 
 This property is supported only when ``<LANG>`` is ``C`` or ``CXX``.
 
-Specify a :ref:`;-list <CMake Language Lists>` containing a command line
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command line
 for the ``cpplint`` style checker.  The :ref:`Makefile Generators` and the
 :generator:`Ninja` generator will run ``cpplint`` along with the compiler
 and report any problems.

Help/prop_tgt/LANG_INCLUDE_WHAT_YOU_USE.rst

@@ -3,7 +3,7 @@
 
 This property is implemented only when ``<LANG>`` is ``C`` or ``CXX``.
 
-Specify a :ref:`;-list <CMake Language Lists>` containing a command
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` containing a command
 line for the ``include-what-you-use`` tool.  The :ref:`Makefile Generators`
 and the :generator:`Ninja` generator will run this tool along with the
 compiler and report a warning if the tool reports any problems.

Help/prop_tgt/LINK_DIRECTORIES.rst

@@ -4,7 +4,7 @@ LINK_DIRECTORIES
 List of directories to use for the link step of shared library, module
 and executable targets.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of directories
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of directories
 specified so far for its target.  Use the :command:`target_link_directories`
 command to append more search directories.
 

Help/prop_tgt/LINK_OPTIONS.rst

@@ -6,7 +6,7 @@ and executable targets. Targets that are static libraries need to use
 the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property.
 
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 specified so far for its target.  Use the :command:`target_link_options`
 command to append more options.
 

Help/prop_tgt/STATIC_LIBRARY_OPTIONS.rst

@@ -5,7 +5,7 @@ Archiver (or MSVC librarian) flags for a static library target.
 Targets that are shared libraries, modules, or executables need to use
 the :prop_tgt:`LINK_OPTIONS` target property.
 
-This property holds a :ref:`;-list <CMake Language Lists>` of options
+This property holds a :ref:`semicolon-separated list <CMake Language Lists>` of options
 specified so far for its target.  Use :command:`set_target_properties` or
 :command:`set_property` commands to set its content.
 

Help/prop_tgt/VS_SDK_REFERENCES.rst

@@ -2,6 +2,6 @@ VS_SDK_REFERENCES
 -----------------
 
 Visual Studio project SDK references.
-Specify a :ref:`;-list <CMake Language Lists>` of SDK references
+Specify a :ref:`semicolon-separated list <CMake Language Lists>` of SDK references
 to be added to a generated Visual Studio project, e.g.
 ``Microsoft.AdMediatorWindows81, Version=1.0``.

Help/release/3.6.rst

@@ -251,7 +251,7 @@ Deprecated and Removed Features
   Users that keep some ``<prefix>/bin`` directories in the ``PATH`` just for
   their tools do not necessarily want any supporting ``<prefix>/lib``
   directories searched.  One may set the ``CMAKE_PREFIX_PATH`` environment
-  variable with a :ref:`;-list <CMake Language Lists>` of prefixes that are
+  variable with a :ref:`semicolon-separated list <CMake Language Lists>` of prefixes that are
   to be searched.
 
 * The :generator:`Visual Studio 7 .NET 2003` generator is now

Help/variable/CMAKE_APPBUNDLE_PATH.rst

@@ -1,6 +1,6 @@
 CMAKE_APPBUNDLE_PATH
 --------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for macOS application bundles used by the :command:`find_program`, and
 :command:`find_package` commands.

Help/variable/CMAKE_AUTOMOC_MACRO_NAMES.rst

@@ -1,7 +1,7 @@
 CMAKE_AUTOMOC_MACRO_NAMES
 ----------------------------
 
-A :ref:`;-list <CMake Language Lists>` list of macro names used by
+:ref:`Semicolon-separated list <CMake Language Lists>` list of macro names used by
 :variable:`CMAKE_AUTOMOC` to determine if a C++ file needs to be
 processed by ``moc``.
 

Help/variable/CMAKE_BUILD_RPATH.rst

@@ -1,7 +1,7 @@
 CMAKE_BUILD_RPATH
 -----------------
 
-A :ref:`;-list <CMake Language Lists>` specifying runtime path (``RPATH``)
+:ref:`Semicolon-separated list <CMake Language Lists>` specifying runtime path (``RPATH``)
 entries to add to binaries linked in the build tree (for platforms that
 support it).  The entries will *not* be used for binaries in the install
 tree.  See also the :variable:`CMAKE_INSTALL_RPATH` variable.

Help/variable/CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES.rst

@@ -2,6 +2,6 @@ CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES
 --------------------------------------
 
 When the ``CUDA`` language has been enabled, this provides a
-:ref:`;-list <CMake Language Lists>` of include directories provided
+:ref:`semicolon-separated list <CMake Language Lists>` of include directories provided
 by the CUDA Toolkit.  The value may be useful for C++ source files
 to include CUDA headers.

Help/variable/CMAKE_FIND_ROOT_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_FIND_ROOT_PATH
 --------------------
 
-:ref:`;-list <CMake Language Lists>` of root paths to search on the filesystem.
+:ref:`Semicolon-separated list <CMake Language Lists>` of root paths to search on the filesystem.
 
 This variable is most useful when cross-compiling. CMake uses the paths in
 this list as alternative roots to find filesystem items with

Help/variable/CMAKE_FRAMEWORK_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_FRAMEWORK_PATH
 --------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for macOS frameworks used by the :command:`find_library`,
 :command:`find_package`, :command:`find_path`, and :command:`find_file`
 commands.

Help/variable/CMAKE_IGNORE_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_IGNORE_PATH
 -----------------
 
-:ref:`;-list <CMake Language Lists>` of directories to be *ignored* by
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories to be *ignored* by
 the :command:`find_program`, :command:`find_library`, :command:`find_file`,
 and :command:`find_path` commands.  This is useful in cross-compiling
 environments where some system directories contain incompatible but

Help/variable/CMAKE_INCLUDE_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_INCLUDE_PATH
 ------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_file` and :command:`find_path` commands.  By default it
 is empty, it is intended to be set by the project.  See also
 :variable:`CMAKE_SYSTEM_INCLUDE_PATH` and :variable:`CMAKE_PREFIX_PATH`.

Help/variable/CMAKE_LANG_LINKER_WRAPPER_FLAG.rst

@@ -5,7 +5,7 @@ Defines the syntax of compiler driver option to pass options to the linker
 tool. It will be used to translate the ``LINKER:`` prefix in the link options
 (see :command:`add_link_options` and :command:`target_link_options`).
 
-This variable holds a :ref:`;-list <CMake Language Lists>` of tokens.
+This variable holds a :ref:`semicolon-separated list <CMake Language Lists>` of tokens.
 If a space (i.e. " ") is specified as last token, flag and ``LINKER:``
 arguments will be specified as separate arguments to the compiler driver.
 The :variable:`CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP` variable can be specified

Help/variable/CMAKE_LIBRARY_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_LIBRARY_PATH
 ------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_library` command.  By default it is empty, it is
 intended to be set by the project.  See also
 :variable:`CMAKE_SYSTEM_LIBRARY_PATH` and :variable:`CMAKE_PREFIX_PATH`.

Help/variable/CMAKE_MODULE_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_MODULE_PATH
 -----------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for CMake modules to be loaded by the :command:`include` or
 :command:`find_package` commands before checking the default modules that come
 with CMake.  By default it is empty, it is intended to be set by the project.

Help/variable/CMAKE_PREFIX_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_PREFIX_PATH
 -----------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying installation
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying installation
 *prefixes* to be searched by the :command:`find_package`,
 :command:`find_program`, :command:`find_library`, :command:`find_file`, and
 :command:`find_path` commands.  Each command will add appropriate

Help/variable/CMAKE_PROGRAM_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_PROGRAM_PATH
 ------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_program` command.  By default it is empty, it is
 intended to be set by the project.  See also
 :variable:`CMAKE_SYSTEM_PROGRAM_PATH` and :variable:`CMAKE_PREFIX_PATH`.

Help/variable/CMAKE_SYSTEM_IGNORE_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_SYSTEM_IGNORE_PATH
 ------------------------
 
-:ref:`;-list <CMake Language Lists>` of directories to be *ignored* by
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories to be *ignored* by
 the :command:`find_program`, :command:`find_library`, :command:`find_file`,
 and :command:`find_path` commands.  This is useful in cross-compiling
 environments where some system directories contain incompatible but

Help/variable/CMAKE_SYSTEM_INCLUDE_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_SYSTEM_INCLUDE_PATH
 -------------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_file` and :command:`find_path` commands.  By default
 this contains the standard directories for the current system.  It is *not*
 intended to be modified by the project; use :variable:`CMAKE_INCLUDE_PATH` for

Help/variable/CMAKE_SYSTEM_LIBRARY_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_SYSTEM_LIBRARY_PATH
 -------------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_library` command.  By default this contains the
 standard directories for the current system.  It is *not* intended to be
 modified by the project; use :variable:`CMAKE_LIBRARY_PATH` for this.

Help/variable/CMAKE_SYSTEM_PREFIX_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_SYSTEM_PREFIX_PATH
 ------------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying installation
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying installation
 *prefixes* to be searched by the :command:`find_package`,
 :command:`find_program`, :command:`find_library`, :command:`find_file`, and
 :command:`find_path` commands.  Each command will add appropriate

Help/variable/CMAKE_SYSTEM_PROGRAM_PATH.rst

@@ -1,7 +1,7 @@
 CMAKE_SYSTEM_PROGRAM_PATH
 -------------------------
 
-:ref:`;-list <CMake Language Lists>` of directories specifying a search path
+:ref:`Semicolon-separated list <CMake Language Lists>` of directories specifying a search path
 for the :command:`find_program` command.  By default this contains the
 standard directories for the current system.  It is *not* intended to be
 modified by the project; use :variable:`CMAKE_PROGRAM_PATH` for this.

Help/variable/PackageName_ROOT.rst

@@ -9,6 +9,6 @@ prefixes specified in the ``Foo_ROOT`` CMake variable (if set).
 See policy :policy:`CMP0074`.
 
 This variable may hold a single prefix or a
-:ref:`;-list <CMake Language Lists>` of multiple prefixes.
+:ref:`semicolon-separated list <CMake Language Lists>` of multiple prefixes.
 
 See also the :envvar:`<PackageName>_ROOT` environment variable.