minor autotest documentation update

This commit is contained in:
Günter Milde 2015-12-18 17:38:27 +01:00
parent e0dd541634
commit bdc50829cb

View File

@ -2,7 +2,7 @@
\lyxformat 503 \lyxformat 503
\begin_document \begin_document
\begin_header \begin_header
\origin /systemlyxdir/doc/ \origin /systemlyxdir/doc
\textclass scrartcl \textclass scrartcl
\options BCOR8mm,captions=tableheading \options BCOR8mm,captions=tableheading
\use_default_options false \use_default_options false
@ -1492,7 +1492,13 @@ status collapsed
\end_inset \end_inset
Run only the tests whose labels match the given regular expression. Run only the tests whose labels match the given regular expression.
For example, to run only the export tests, you can use A test may have more that one label.
\end_layout
\begin_deeper
\begin_layout Standard
For example, to run only the export tests, you can use
\begin_inset Flex Code \begin_inset Flex Code
status collapsed status collapsed
@ -1506,6 +1512,7 @@ ctest -L export
\end_layout \end_layout
\end_deeper
\begin_layout Labeling \begin_layout Labeling
\labelwidthstring -R \labelwidthstring -R
\begin_inset Flex Code \begin_inset Flex Code
@ -1613,7 +1620,11 @@ We are still working on getting the tests to run in parallel.
pass when run sequentially. pass when run sequentially.
A reasonable approach is to first run the tests in parallel and then run A reasonable approach is to first run the tests in parallel and then run
the failed tests sequentially. the failed tests sequentially.
For example, to run 8 jobs at a time:
\end_layout
\begin_layout Standard
For example, to run 8 jobs at a time:
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -2060,10 +2071,50 @@ status collapsed
Unreliable tests Unreliable tests
\end_layout \end_layout
\begin_layout Standard
These tests are not executed using
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ctest -L export
\end_layout
\end_inset
or
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
ctest -L inverted
\end_layout
\end_inset
.
\end_layout
\begin_layout Standard
They pass or fail for various reasons not related to LyX (nonstandard, erratic)
or pass but should rather fail (wrong output).
\end_layout
\begin_layout Description \begin_layout Description
nonstandard Requires non-standard ressources (\SpecialChar LaTeX nonstandard Documents with additional requirements, e.g.
packages and document classes, a class or package file not on CTAN.
fonts, ...) that are not a requirement for running this test suite.
\begin_inset Note Note
status open
\begin_layout Plain Layout
TODO: rename to "extra"?
\end_layout
\end_inset
\end_layout \end_layout
\begin_deeper \begin_deeper
@ -2075,17 +2126,23 @@ These tests are labeled as
\end_deeper \end_deeper
\begin_layout Description \begin_layout Description
erratic Tests with erratic Tests depending on local configuration, OS, TeX distribution, package
\begin_inset Quotes eld versions, or the phase of the moon.
\begin_inset Note Note
status open
\begin_layout Plain Layout
TODO: use
\emph on
erratic
\emph default
only for the phase-of-moon dependency.
\end_layout
\end_inset \end_inset
arbitrary
\begin_inset Quotes erd
\end_inset
result, depending on local configuration, OS, \SpecialChar TeX
distribution, package versions,
or the phase of the moon.
\end_layout \end_layout
\begin_deeper \begin_deeper
@ -2095,6 +2152,29 @@ These tests are labeled as
'erratic'. 'erratic'.
\end_layout \end_layout
\end_deeper
\begin_layout Description
wrong
\begin_inset space ~
\end_inset
output Export does not fail but the resulting document has errors.
\end_layout
\begin_deeper
\begin_layout Standard
\paragraph_spacing single
These tests are actually not
\emph on
unreliable
\emph default
but
\emph on
invalid
\emph default
(not measuring what they should measure).
\end_layout
\end_deeper \end_deeper
\begin_layout Paragraph \begin_layout Paragraph
Export test filtering Export test filtering