From 17de9500e8d027d6662a7c8e371def90fa118eac Mon Sep 17 00:00:00 2001 From: Tyler Yankee Date: Sun, 25 Oct 2026 19:49:28 -0400 Subject: [PATCH] Help: Clarify existing CODEGEN behavior --- Help/command/add_custom_command.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Help/command/add_custom_command.rst b/Help/command/add_custom_command.rst index 92a11e3a6c..dd3d1ddf80 100644 --- a/Help/command/add_custom_command.rst +++ b/Help/command/add_custom_command.rst @@ -253,6 +253,9 @@ Generating Files Furthermore, this option is allowed only if policy :policy:`CMP0171` is set to ``NEW``. + Like ``all``, the ``codegen`` target exists per directory and skips + targets and directories marked ``EXCLUDE_FROM_ALL``. + This keyword cannot be used with ``APPEND`` (see policy :policy:`CMP0175`). It can only be set on the first call to ``add_custom_command(OUTPUT...)`` for the output files. @@ -270,7 +273,8 @@ Generating Files .. note:: - This option cannot be specified at the same time as ``DEPFILE`` option. + This option cannot be specified at the same time as the ``DEPFILE`` or + ``CODEGEN`` options. ``JOB_POOL`` .. versionadded:: 3.15