From patchwork Thu Oct 30 16:48:59 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Wood X-Patchwork-Id: 5198941 Return-Path: X-Original-To: patchwork-intel-gfx@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 994BD9F30B for ; Thu, 30 Oct 2014 16:49:17 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 9CDAB2015D for ; Thu, 30 Oct 2014 16:49:16 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id CE46F201FE for ; Thu, 30 Oct 2014 16:49:13 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D609E6E52E; Thu, 30 Oct 2014 09:49:12 -0700 (PDT) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mail-wg0-f45.google.com (mail-wg0-f45.google.com [74.125.82.45]) by gabe.freedesktop.org (Postfix) with ESMTP id 385626E0B6 for ; Thu, 30 Oct 2014 09:49:10 -0700 (PDT) Received: by mail-wg0-f45.google.com with SMTP id x12so4759604wgg.18 for ; Thu, 30 Oct 2014 09:49:09 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=G2aBz8ESt+YdC14QgZ3YLX0tVUeI5hdoE94H57fj3j0=; b=IhpmeZVPKLvm52yKYGoB352aUQNsKlJeSZWXI/W/1MljqWnzb6AfteXx8z4PSOyj8W 4PHHV81Hy6i+rDL60D+iI1cZxrIVEkogN3jmdJdpRHH4jWdf7R0m/6jby7nU904DNMts tu3r/MhNfVPxbCDbaMiPPGvUjiFvcxsJUzKwh9urimX8v0FBo1dsqXNKRh6XWwqsFvfZ dsAU779fYLa1SPNEyoHioaU+prdkYvX4GJ3TzXLRCNYMU4rhp+5MUxMbijsBrEIde358 mX5CpPcMIKs1Dzn9IlAPDQhljkdn8I8aDRQ/uql7ZQwBigNB4CAqGcVHJmUSdVfcUFiW eFqQ== X-Gm-Message-State: ALoCoQlafo/LdysBWo+5fgEG/2/pV5IRThta2H+y1PwaUztOgaZNGAYPNNsgZzt7jgwv7KUt7Uqv X-Received: by 10.180.19.234 with SMTP id i10mr15627007wie.28.1414687749122; Thu, 30 Oct 2014 09:49:09 -0700 (PDT) Received: from pistachio.icx.intel.com ([83.217.123.106]) by mx.google.com with ESMTPSA id k10sm9264702wjb.28.2014.10.30.09.49.07 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 30 Oct 2014 09:49:08 -0700 (PDT) From: Thomas Wood To: intel-gfx@lists.freedesktop.org Date: Thu, 30 Oct 2014 16:48:59 +0000 Message-Id: <1414687741-7830-5-git-send-email-thomas.wood@intel.com> X-Mailer: git-send-email 2.1.0 In-Reply-To: <1414687741-7830-1-git-send-email-thomas.wood@intel.com> References: <1414687741-7830-1-git-send-email-thomas.wood@intel.com> Subject: [Intel-gfx] [PATCH i-g-t v2 4/6] docs: include descriptions for the test programs X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Spam-Status: No, score=-4.8 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP v2: fix various distcheck issues Signed-off-by: Thomas Wood --- docs/reference/intel-gpu-tools/.gitignore | 1 + docs/reference/intel-gpu-tools/Makefile.am | 27 +++++++-- .../intel-gpu-tools/igt_test_programs.xml.header | 65 ++++++++++++++++++++++ .../intel-gpu-tools/intel-gpu-tools-docs.xml | 1 + 4 files changed, 90 insertions(+), 4 deletions(-) create mode 100644 docs/reference/intel-gpu-tools/igt_test_programs.xml.header diff --git a/docs/reference/intel-gpu-tools/.gitignore b/docs/reference/intel-gpu-tools/.gitignore index 9415974..303929b 100644 --- a/docs/reference/intel-gpu-tools/.gitignore +++ b/docs/reference/intel-gpu-tools/.gitignore @@ -3,6 +3,7 @@ /html-build.stamp /html.stamp /html/ +/igt_test_programs.xml /intel-gpu-tools-decl-list.txt /intel-gpu-tools-decl.txt /intel-gpu-tools-overrides.txt diff --git a/docs/reference/intel-gpu-tools/Makefile.am b/docs/reference/intel-gpu-tools/Makefile.am index 3368e3e..e02308a 100644 --- a/docs/reference/intel-gpu-tools/Makefile.am +++ b/docs/reference/intel-gpu-tools/Makefile.am @@ -1,5 +1,22 @@ ## 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 "$$test" >> $@; \ + if [ -x $(top_builddir)/tests/$$test ]; then \ + ./$(top_builddir)/tests/$$test --help-description >> $@; \ + else \ + ./$(top_srcdir)/tests/$$test --help-description >> $@; \ + fi; \ + echo "" >> $@; \ + done; \ + echo "" >> $@; + # We require automake 1.6 at least. AUTOMAKE_OPTIONS = 1.6 @@ -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 -content_files= +content_files=igt_test_programs.xml # 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 -expand_content_files= +expand_content_files=igt_test_programs.xml # 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 += +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 +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 diff --git a/docs/reference/intel-gpu-tools/igt_test_programs.xml.header b/docs/reference/intel-gpu-tools/igt_test_programs.xml.header new file mode 100644 index 0000000..662242e --- /dev/null +++ b/docs/reference/intel-gpu-tools/igt_test_programs.xml.header @@ -0,0 +1,65 @@ + + + +]> + + +Test Programs +1 + + INTEL-GPU-TOOLS Library + + + +Tests Programs +Test cases for features and bugs + + + +Description +Test cases for bugs, features and regression testing. All tests support the +following common options: + + + + + +list the available subtests and exit + + + + + + +run the specified subtest + + + + + + +print extra debugging information when running tests + + + + + + +print a short description of the test and exit + + + + + + +print help and exit + + + + + + +Programs diff --git a/docs/reference/intel-gpu-tools/intel-gpu-tools-docs.xml b/docs/reference/intel-gpu-tools/intel-gpu-tools-docs.xml index 3d9caf8..07ced05 100644 --- a/docs/reference/intel-gpu-tools/intel-gpu-tools-docs.xml +++ b/docs/reference/intel-gpu-tools/intel-gpu-tools-docs.xml @@ -25,6 +25,7 @@ +