From patchwork Tue Oct 28 15:03:56 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Wood X-Patchwork-Id: 5177981 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 E476D9F3ED for ; Tue, 28 Oct 2014 15:04:12 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D5A2920266 for ; Tue, 28 Oct 2014 15:04:11 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id E7E4220254 for ; Tue, 28 Oct 2014 15:04:08 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 723406E714; Tue, 28 Oct 2014 08:04:08 -0700 (PDT) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mail-wg0-f48.google.com (mail-wg0-f48.google.com [74.125.82.48]) by gabe.freedesktop.org (Postfix) with ESMTP id A87046E73B for ; Tue, 28 Oct 2014 08:04:06 -0700 (PDT) Received: by mail-wg0-f48.google.com with SMTP id m15so1078115wgh.19 for ; Tue, 28 Oct 2014 08:04:05 -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=aHEUYzOIT6kShdogeVvwxf6F9JU4Kvz488bxVEmbADM=; b=dm5qfNQBsPClOzQ7PLHuOrLBhrdTYuoxLNCWGrpxry34ZBSsYN6KfT02nMSzKXB3r/ KalOu+Mk04LW6qjVFeSu7aB3X7gNB0iDI1PgfOr/OqLA6bg0FpvsdEl/fPBPMe2fbdi9 ZrznAtFR79eHGC95bWJ5g9EprjvDoAAeuqB07ozuC+FIGslhobMzdP99BMBuGo3KRf8U NfE+HC9TD/XvUI6rKPkxknKPd6VtJnjD3/7WaOlyJq/09iRNWYrI4HsQejh/BQbGC7nI kKTAE2Ksb5AkDc4h4RcRvkN0lzaRJwQlnmoEjFHdIW0MCsuVvQMtcXhT4EV2BJEx/SLe d8BQ== X-Gm-Message-State: ALoCoQmrhWE1CqENC9iIL4jhRJpYgbAbkip3FMckOQH0Z9SrL5l7NkSV6g9MB5xiaH3gJwq+atAe X-Received: by 10.180.36.205 with SMTP id s13mr28128118wij.11.1414508645879; Tue, 28 Oct 2014 08:04:05 -0700 (PDT) Received: from pistachio.icx.intel.com ([83.217.123.106]) by mx.google.com with ESMTPSA id ic4sm15688465wid.19.2014.10.28.08.04.02 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Oct 2014 08:04:04 -0700 (PDT) From: Thomas Wood To: intel-gfx@lists.freedesktop.org Date: Tue, 28 Oct 2014 15:03:56 +0000 Message-Id: <1414508636-13543-4-git-send-email-thomas.wood@intel.com> X-Mailer: git-send-email 2.1.0 In-Reply-To: <1414508636-13543-1-git-send-email-thomas.wood@intel.com> References: <1414508636-13543-1-git-send-email-thomas.wood@intel.com> Subject: [Intel-gfx] [PATCH i-g-t 4/4] doc: 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 Signed-off-by: Thomas Wood --- docs/reference/intel-gpu-tools/Makefile.am | 20 ++++++- .../intel-gpu-tools/igt_test_programs.xml.header | 65 ++++++++++++++++++++++ .../intel-gpu-tools/intel-gpu-tools-docs.xml | 1 + 3 files changed, 84 insertions(+), 2 deletions(-) create mode 100644 docs/reference/intel-gpu-tools/igt_test_programs.xml.header diff --git a/docs/reference/intel-gpu-tools/Makefile.am b/docs/reference/intel-gpu-tools/Makefile.am index 3368e3e..bd02f5f 100644 --- a/docs/reference/intel-gpu-tools/Makefile.am +++ b/docs/reference/intel-gpu-tools/Makefile.am @@ -1,5 +1,21 @@ ## Process this file with automake to produce Makefile.in +#noinst_PROGRAMS=igt-test-scan +# +#AM_CFLAGS="-DTESTDIR=\"$(abs_top_srcdir)/tests\"" + +igt_test_programs.xml: + cat igt_test_programs.xml.header > $@; \ + for test in `cat $(top_builddir)/tests/single-tests.txt $(top_builddir)/tests/multi-tests.txt`; do \ + if [ "$$test" = "TESTLIST" -o "$$test" = "END" ]; then \ + continue; \ + fi; \ + echo "$$test" >> $@;\ + ./$(top_srcdir)/tests/$$test --help-description >> $@; \ + echo "" >> $@; \ + done; \ + echo "" >> $@; + # We require automake 1.6 at least. AUTOMAKE_OPTIONS = 1.6 @@ -68,12 +84,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 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 @@ +