From: Günter Milde <milde@lyx.org>
Date: Sat, 2 Jan 2016 21:31:14 +0000 (+0100)
Subject: Minor ctest documentation edits.
X-Git-Tag: 2.2.0beta1~252
X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=88b3fa32256062775d7e165a6f8c858290a5bb00;p=features.git

Minor ctest documentation edits.

Make sure not to confuse failing test and failing export for inverted tests.
---

diff --git a/lib/doc/Development.lyx b/lib/doc/Development.lyx
index 04a337a7cc..aeff56185d 100644
--- a/lib/doc/Development.lyx
+++ b/lib/doc/Development.lyx
@@ -1326,6 +1326,17 @@ reuse
 
  documentation, template, and example files trying to export them to all
  supported output formats.
+ In addition, there are a number of dedicated sample documents under 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+autotests/export/
+\end_layout
+
+\end_inset
+
+.
 \end_layout
 
 \begin_layout Paragraph
@@ -1399,7 +1410,13 @@ reference "subsec:Interpreting-export-tests"
 \end_layout
 
 \begin_layout Paragraph
-Configuring the tests
+\begin_inset CommandInset label
+LatexCommand label
+name "par:Configuring-ctests"
+
+\end_inset
+
+Configuring the tests 
 \end_layout
 
 \begin_layout Standard
@@ -1509,7 +1526,6 @@ ctest -L export
 \end_inset
 
 .
- 
 \end_layout
 
 \end_deeper
@@ -1996,12 +2012,17 @@ Inverted tests
 \end_layout
 
 \begin_layout Standard
-These tests are expected to always fail.
+These tests fail if the export does 
+\emph on
+not
+\emph default
+ return an error.
+ 
 \end_layout
 
 \begin_layout Description
-inverted These tests are expected to fail, but are subject to be examined.
- It is expected that they will pass in a foreseeable future.
+inverted Export fails, but the test cases are subject to be examined.
+ It is expected that the export will work in a foreseeable future.
  They are labeled 'inverted'.
 \end_layout
 
@@ -2043,8 +2064,8 @@ ctest -L suspended
 
 \begin_deeper
 \begin_layout Standard
-These tests are suspended, because they fail for known reasons which cannot
- ATM be resolved.
+These tests are suspended, because the export fails for known reasons which
+ cannot ATM be resolved.
  But it is expected the reason might disappear in the future.
  Be it new TL or better handling in \SpecialChar LyX
 .
@@ -2181,7 +2202,8 @@ Export test filtering
 \end_layout
 
 \begin_layout Standard
-There are files which control the assignment of a label to a test.
+The assignment of a label to a test is controlled by a set of files with
+ regular expressions that are matched against the test names.
 \end_layout
 
 \begin_layout Description
@@ -2189,7 +2211,15 @@ ignoredTests (small file)
 \begin_inset Newline newline
 \end_inset
 
-Tests selected here are withdrawn
+Tests selected here are withdrawn in the configuration step (cf.
+ 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "par:Configuring-ctests"
+
+\end_inset
+
+).
 \end_layout
 
 \begin_deeper