瀏覽代碼

Help: Cross-link conditional and boolean expressions.

Rename Logical -> Boolean Generator Expressions.
It's the return type that helps us to sort the expression zoo.
Joachim Wuttke (h) 7 年之前
父節點
當前提交
9891adf74b
共有 1 個文件被更改,包括 24 次插入18 次删除
  1. 24 18
      Help/manual/cmake-generator-expressions.7.rst

+ 24 - 18
Help/manual/cmake-generator-expressions.7.rst

@@ -25,11 +25,13 @@ conditional include directories, and more.  The conditions may be based on
 the build configuration, target properties, platform information or any other
 the build configuration, target properties, platform information or any other
 queryable information.
 queryable information.
 
 
-Conditional Expressions
-=======================
+.. _`Conditional Generator Expressions`:
 
 
-Conditional expressions depend on a boolean condition that must be
-``0`` or ``1``.
+Conditional Generator Expressions
+=================================
+
+Conditional generator expressions depend on a boolean condition
+that must be ``0`` or ``1``.
 
 
 ``$<condition:true_value>``
 ``$<condition:true_value>``
   Evaluates to ``true_value`` if ``condition`` is ``1``.
   Evaluates to ``true_value`` if ``condition`` is ``1``.
@@ -39,23 +41,27 @@ Conditional expressions depend on a boolean condition that must be
   Evaluates to ``true_value`` if ``condition`` is ``1``.
   Evaluates to ``true_value`` if ``condition`` is ``1``.
   Otherwise evaluates to ``false_value``.
   Otherwise evaluates to ``false_value``.
 
 
-
-Logical Expressions
-===================
-
-Logical expressions are used to create conditional output.  The basic
-expressions are the ``0`` and ``1`` expressions.  Because other logical
-expressions evaluate to either ``0`` or ``1``, they can be composed to
-create conditional output:
+Typically, the ``condition`` is a
+:ref:`boolean generator expression<Boolean Generator Expressions>`.
+For instance,
 
 
 .. code-block:: cmake
 .. code-block:: cmake
 
 
   $<$<CONFIG:Debug>:DEBUG_MODE>
   $<$<CONFIG:Debug>:DEBUG_MODE>
 
 
 expands to ``DEBUG_MODE`` when the ``Debug`` configuration is used, and
 expands to ``DEBUG_MODE`` when the ``Debug`` configuration is used, and
-otherwise expands to nothing.
+otherwise expands to the empty string.
+
+.. _`Boolean Generator Expressions`:
+
+Boolean Generator Expressions
+=============================
+
+Boolean expressions evaluate to either ``0`` or ``1``.
+They are typically used to construct the condition in a
+:ref:`conditional generator expression<Conditional Generator Expressions>`.
 
 
-Available logical expressions are:
+Available boolean expressions are:
 
 
 ``$<BOOL:condition>``
 ``$<BOOL:condition>``
   ``1`` if the ``condition`` is true, else ``0``
   ``1`` if the ``condition`` is true, else ``0``
@@ -171,8 +177,8 @@ Available logical expressions are:
     add_executable(myapp main.cpp)
     add_executable(myapp main.cpp)
     target_link_libraries(myapp myapp_c myapp_cxx)
     target_link_libraries(myapp myapp_c myapp_cxx)
 
 
-Informational Expressions
-=========================
+Informational Generator Expressions
+===================================
 
 
 These expressions expand to some information. The information may be used
 These expressions expand to some information. The information may be used
 directly, eg:
 directly, eg:
@@ -272,8 +278,8 @@ Available informational expressions are:
   the unary version for notes about portability of this generator
   the unary version for notes about portability of this generator
   expression.
   expression.
 
 
-Output Expressions
-==================
+Output Generator Expressions
+============================
 
 
 These expressions generate output, in some cases depending on an input. These
 These expressions generate output, in some cases depending on an input. These
 expressions may be combined with other expressions for information or logical
 expressions may be combined with other expressions for information or logical