We are currently experiencing downtime impacting viewing & cloning the Mesa repo, and some GitLab pages returning 503. Please see #freedesktop on IRC for more updates.

Commit 98188b4b authored by Thomas Wood's avatar Thomas Wood

docs: include descriptions for the test programs

v2: fix various distcheck issues
Signed-off-by: default avatarThomas Wood <thomas.wood@intel.com>
parent e6fec38c
......@@ -3,6 +3,7 @@
## Process this file with automake to produce Makefile.in
TESTLISTS = $(top_builddir)/tests/single-tests.txt $(top_builddir)/tests/multi-tests.txt
igt_test_programs.xml: igt_test_programs.xml.header $(TESTLISTS)
cat $(srcdir)/igt_test_programs.xml.header > $@; \
for test in `cat $(TESTLISTS)`; do \
if [ "$$test" = "TESTLIST" -o "$$test" = "END" ]; then \
continue; \
fi; \
echo "<refsect2 id=\"$$test\"><title>$$test</title><para>" >> $@; \
if [ -x $(top_builddir)/tests/$$test ]; then \
./$(top_builddir)/tests/$$test --help-description >> $@; \
else \
./$(top_srcdir)/tests/$$test --help-description >> $@; \
fi; \
echo "</para></refsect2>" >> $@; \
done; \
echo "</refsect1></refentry>" >> $@;
# We require automake 1.6 at least.
......@@ -68,12 +85,12 @@ HTML_IMAGES=
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
# These files must be listed here *and* in content_files
# e.g. expand_content_files=running.sgml
# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
# Only needed if you are using gtkdoc-scangobj to dynamically query widget
......@@ -88,12 +105,14 @@ include $(top_srcdir)/gtk-doc.make
# Other files to distribute
# e.g. EXTRA_DIST += version.xml.in
EXTRA_DIST += igt_test_programs.xml.header
# Files not to distribute
# for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
# for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
DISTCLEANFILES = $(DOC_MODULE)-sections.txt igt_test_programs.xml
CLEANFILES += igt_test_programs.xml
# Comment this out if you want 'make check' to test you doc status
# and run some sanity checks
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<refentry id="intel-gpu-tools-test-programs">
<refentrytitle role="top_of_page" id="intel-gpu-tools-test-programs.top_of_page">Test Programs</refentrytitle>
<refname>Tests Programs</refname>
<refpurpose>Test cases for features and bugs</refpurpose>
<refsect1 id="intel-gpu-tools-test-programs.description" role="desc">
<title role="desc.title">Description</title>
Test cases for bugs, features and regression testing. All tests support the
following common options:
list the available subtests and exit
<term><option>--run-subtest <replaceable>subtest</replaceable></option></term>
run the specified subtest
print extra debugging information when running tests
print a short description of the test and exit
print help and exit
......@@ -25,6 +25,7 @@
<xi:include href="xml/intel_batchbuffer.xml"/>
<xi:include href="xml/intel_chipset.xml"/>
<xi:include href="xml/intel_io.xml"/>
<xi:include href="xml/igt_test_programs.xml"/>
<xi:include href="xml/igt_edid.xml"/>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment