\lyxformat 503
\begin_document
\begin_header
-\origin unavailable
+\origin /systemlyxdir/doc/
\textclass scrartcl
\options BCOR8mm,captions=tableheading
\use_default_options false
\end_layout
\begin_layout Subsection
-\SpecialChar LyX
- tests
+unit tests
\end_layout
\begin_layout Standard
-Some tests are located in the
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-development/autotests
-\end_layout
-
-\end_inset
-
- subfolder of the \SpecialChar LyX
- source code distribution.
-\end_layout
-
-\begin_layout Subsubsection
-Running the tests
+There are attempts to set up a suite of unit tests for LyX.
\end_layout
\begin_layout Standard
-cmake is required to run the \SpecialChar LyX
- tests, running them is not implemented for
- autotools.
- The \SpecialChar LyX
- tests can be run by the commands
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-ctest
-\end_layout
-
-\end_inset
-
- (all platforms) or
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-make test
-\end_layout
-
-\end_inset
-
- (when using a make based build system and not MSVC) in the
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-autotests
-\end_layout
-
-\end_inset
-
- subfolder of the build directory.
+TODO: describe what is done and what is still to do.
\end_layout
\begin_layout Subsection
\end_layout
\begin_layout Subsection
-Export tests (cmake only)
+automatic LyX tests (cmake only)
+\end_layout
+
+\begin_layout Standard
+Some tests are located in the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+development/autotests
+\end_layout
+
+\end_inset
+
+ subfolder of the \SpecialChar LyX
+ source code distribution.
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+cmake
+\end_layout
+
+\end_inset
+
+ is required to run the automatic \SpecialChar LyX
+ tests, running them is not implemented
+ for autotools.
+
+\end_layout
+
+\begin_layout Standard
+The \SpecialChar LyX
+ tests can be run by the commands
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+ctest
+\end_layout
+
+\end_inset
+
+ (all platforms) or
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+make test
+\end_layout
+
+\end_inset
+
+ (when using a make based build system and not MSVC) in the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+autotests
+\end_layout
+
+\end_inset
+
+ subfolder of the build directory.
+\end_layout
+
+\begin_layout Subsubsection
+Export tests
\end_layout
\begin_layout Standard
build system
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
Expectations of LyX developers
\end_layout
.
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
Configuring the tests
\end_layout
).
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
Running the tests
\end_layout
) the full list of command line options.
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
\begin_inset CommandInset label
LatexCommand label
name "subsec:Interpreting-export-tests"
file lists the times that it took to run the tests.
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
Inverted tests
\end_layout
\end_layout
\end_deeper
-\begin_layout Subsubsection
+\begin_layout Paragraph
Unreliable tests
\end_layout
\end_layout
\end_deeper
-\begin_layout Subsection
+\begin_layout Paragraph
Export test filtering
\end_layout
\end_layout
-\begin_layout Subsection
+\begin_layout Subsubsection
check_load tests
\end_layout
Under cmake, the tests are labeled as 'load'.
\end_layout
-\begin_layout Subsection
-URL tests (cmake only)
+\begin_layout Subsubsection
+URL tests
\end_layout
\begin_layout Standard
'url'.
\end_layout
-\begin_layout Subsubsection
+\begin_layout Paragraph
Running URL tests
\end_layout
of the form 'LastFailed.*URLS.log'
\end_layout
-\begin_layout Subsection
-Test labels (cmake only)
+\begin_layout Subsubsection
+Test labels
\end_layout
\begin_layout Standard