From 78b00f1d10f5bb0a152d7825ef554836b52f7977 Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Fri, 14 Oct 2016 14:42:48 -0400
Subject: [PATCH] Help: Clarify `ctest_*` APPEND option behavior

Explicitly state that this marks the `.xml` to tell the dashboard
server to append it to previously submitted results and that it
does not cause results to be appended to the `.xml` file.
---
 Help/command/ctest_build.rst     | 4 +++-
 Help/command/ctest_configure.rst | 4 +++-
 Help/command/ctest_coverage.rst  | 4 +++-
 Help/command/ctest_test.rst      | 4 +++-
 4 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/Help/command/ctest_build.rst b/Help/command/ctest_build.rst
index d3ceb2df84..55bb4a317d 100644
--- a/Help/command/ctest_build.rst
+++ b/Help/command/ctest_build.rst
@@ -30,9 +30,11 @@ The options are:
   :variable:`CTEST_BINARY_DIRECTORY` variable is used.
 
 ``APPEND``
-  Mark results for append to those previously submitted to a
+  Mark ``Build.xml`` for append to results previously submitted to a
   dashboard server since the last :command:`ctest_start` call.
   Append semantics are defined by the dashboard server in use.
+  This does *not* cause results to be appended to a ``.xml`` file
+  produced by a previous call to this command.
 
 ``CONFIGURATION <config>``
   Specify the build configuration (e.g. ``Debug``).  If not
diff --git a/Help/command/ctest_configure.rst b/Help/command/ctest_configure.rst
index b11e77c4aa..2dea07b16f 100644
--- a/Help/command/ctest_configure.rst
+++ b/Help/command/ctest_configure.rst
@@ -23,9 +23,11 @@ The options are:
   :variable:`CTEST_SOURCE_DIRECTORY` variable is used.
 
 ``APPEND``
-  Mark results for append to those previously submitted to a
+  Mark ``Configure.xml`` for append to results previously submitted to a
   dashboard server since the last :command:`ctest_start` call.
   Append semantics are defined by the dashboard server in use.
+  This does *not* cause results to be appended to a ``.xml`` file
+  produced by a previous call to this command.
 
 ``OPTIONS <options>``
   Specify command-line arguments to pass to the configuration tool.
diff --git a/Help/command/ctest_coverage.rst b/Help/command/ctest_coverage.rst
index ec1ee25941..8d27b9c1b1 100644
--- a/Help/command/ctest_coverage.rst
+++ b/Help/command/ctest_coverage.rst
@@ -22,9 +22,11 @@ The options are:
   :variable:`CTEST_BINARY_DIRECTORY` variable is used.
 
 ``APPEND``
-  Mark results for append to those previously submitted to a
+  Mark ``Coverage.xml`` for append to results previously submitted to a
   dashboard server since the last :command:`ctest_start` call.
   Append semantics are defined by the dashboard server in use.
+  This does *not* cause results to be appended to a ``.xml`` file
+  produced by a previous call to this command.
 
 ``LABELS``
   Filter the coverage report to include only source files labeled
diff --git a/Help/command/ctest_test.rst b/Help/command/ctest_test.rst
index 551bc58608..ce50d4297c 100644
--- a/Help/command/ctest_test.rst
+++ b/Help/command/ctest_test.rst
@@ -32,9 +32,11 @@ The options are:
   :variable:`CTEST_BINARY_DIRECTORY` variable is used.
 
 ``APPEND``
-  Mark results for append to those previously submitted to a
+  Mark ``Test.xml`` for append to results previously submitted to a
   dashboard server since the last :command:`ctest_start` call.
   Append semantics are defined by the dashboard server in use.
+  This does *not* cause results to be appended to a ``.xml`` file
+  produced by a previous call to this command.
 
 ``START <start-number>``
   Specify the beginning of a range of test numbers.
-- 
GitLab