From debbugs-submit-bounces@debbugs.gnu.org Fri Mar 23 18:18:00 2012 Received: (at submit) by debbugs.gnu.org; 23 Mar 2012 22:18:00 +0000 Received: from localhost ([127.0.0.1]:35819 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SBCo2-0006tz-3t for submit@debbugs.gnu.org; Fri, 23 Mar 2012 18:18:00 -0400 Received: from eggs.gnu.org ([208.118.235.92]:37856) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SBCnk-0006tb-Ps for submit@debbugs.gnu.org; Fri, 23 Mar 2012 18:17:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SBCJn-0006SB-Tv for submit@debbugs.gnu.org; Fri, 23 Mar 2012 17:46:45 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, T_DKIM_INVALID, T_TVD_MIME_NO_HEADERS autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:41888) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SBCJn-0006S7-Nt for submit@debbugs.gnu.org; Fri, 23 Mar 2012 17:46:43 -0400 Received: from eggs.gnu.org ([208.118.235.92]:36673) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SBCJm-0004Xd-0A for bug-automake@gnu.org; Fri, 23 Mar 2012 17:46:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SBCJj-0006RY-EX for bug-automake@gnu.org; Fri, 23 Mar 2012 17:46:41 -0400 Received: from mo-p00-ob.rzone.de ([81.169.146.160]:63842) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SBCJj-0006R8-58 for bug-automake@gnu.org; Fri, 23 Mar 2012 17:46:39 -0400 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; t=1332539196; l=4553; s=domk; d=tim-landscheidt.de; h=Content-Type:MIME-Version:Date:Subject:To:From:X-RZG-CLASS-ID: X-RZG-AUTH; bh=L6jvdcXV6zispmuFuVdcorKQPa8=; b=Bw3OGcqHkosKK7Rsf0iIdpgch5sQrY/hc9taZXo7Oo2ouKWcWYt/rBVuyckElssH5kv PlRjgo9J+/2//vQtAtlhPERDfYsd/7yvdqUJdnbJsa/TvoVuvYycOoQY++r3ZM7IxW6na dL7T959NUP6TQqiOlgk1zMydHOFBug+6hRw= X-RZG-AUTH: :O2kGeEG7b/pS1FmwRjK/iE70SAFAhFmfc+zHXduyf9BrI1bL11XibYEqV1cd277VMJZuRfrJeg== X-RZG-CLASS-ID: mo00 Received: from passepartout.tim-landscheidt.de (f054052092.adsl.alicedsl.de [78.54.52.92]) by smtp.strato.de (klopstock mo4) (RZmta 28.2 DYNA|AUTH) with ESMTPA id h00957o2NLbKPZ for ; Fri, 23 Mar 2012 22:46:36 +0100 (MET) From: Tim Landscheidt To: bug-automake@gnu.org Subject: master: Small typos in TAP documentation Organization: Date: Fri, 23 Mar 2012 21:46:35 +0000 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) --=-=-= Hi, the attached patch fixes some small typos in the TAP docu- mentation. The latter also contains one unfinished sen- tence that the former marks with FIXME. Tim --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-Fix-some-small-typos.patch >From dd7dcf17962f9987b0558c2c2cec6456d173b255 Mon Sep 17 00:00:00 2001 From: Tim Landscheidt Date: Fri, 23 Mar 2012 21:41:19 +0000 Subject: [PATCH] Fix some small typos. * doc/automake.texi (Using the TAP test protocol): Here ... * tests/tap-doc2.test: ... and here. --- doc/automake.texi | 15 ++++++++------- tests/tap-doc2.test | 2 +- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/doc/automake.texi b/doc/automake.texi index 3bb365b..ef65d8d 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -9588,7 +9588,7 @@ use TAP in their testsuite. Currently, the TAP driver that comes with Automake requires some by-hand steps on the developer's part (this situation should hopefully be improved -in future Automake versions). You'll have grab the @file{tap-driver.sh} +in future Automake versions). You'll have to grab the @file{tap-driver.sh} script from the Automake distribution by hand, copy it in your source tree, add a call to @code{AC_PROG_AWK} in @file{configure.ac} to search for a proper awk program, and use the Automake support for third-party test @@ -9605,12 +9605,13 @@ compatibility with the @command{prove} utility. @c Keep in sync with 'tap-exit.test' and 'tap-signal.test'. @item --ignore-exit Causes the test driver to ignore the exit status of the test scripts; -by default, the driver will report an error if the script exit with a +by default, the driver will report an error if the script exits with a non-zero status. This option has effect also +@c FIXME: The sentence above has no end. @item --comments Instruct the test driver to display TAP diagnostic (i.e., lines beginning with the @samp{#} character) in the testsuite progress output too; by -default, TAP diagnostic is only copied in the @file{.log} file. +default, TAP diagnostic is only copied to the @file{.log} file. @item --no-comments Revert the effects of @option{--comments}. @item --merge @@ -9628,7 +9629,7 @@ Revert the effects of @option{--merge}. Change the string that introduces TAP diagnostic from the default value of ``@code{#}'' to @code{@var{STRING}}. This can be useful if your TAP-based test scripts produce verbose output on which they have limited -control (because, say, the output comes by other tools invoked in the +control (because, say, the output comes from other tools invoked in the scripts), and it might contain text that gets spuriously interpreted as TAP diagnostic: such an issue can be solved by redefining the string that activates TAP diagnostic to a value you know won't appear by chance in @@ -9678,7 +9679,7 @@ echo 'ok 3 - This will not be seen.' #!/bin/sh echo 1..1 echo ok 1 -# Exit with error, even if all the test case has been successful. +# Exit with error, even if all the tests have been successful. exit 7 % @kbd{cp @var{PREFIX}/share/automake-@var{APIVERSION}/tap-driver.pl .} @@ -9724,13 +9725,13 @@ mainstream versions, which you should be aware of. @itemize @bullet @item A @code{Bail out!} directive doesn't stop the whole testsuite, but only -the test script it occurs into. This doesn't follows TAP specifications, +the test script it occurs in. This doesn't follow TAP specifications, but on the other hand it maximizes compatibility (and code sharing) with the ``hard error'' concept of the default @option{parallel-tests} driver. @item The @code{version} and @code{pragma} directives are not supported. @item -The @option{--diagnostic-string} option of out driver allows to modify +The @option{--diagnostic-string} option of our driver allows to modify the string that introduces TAP diagnostic from the default value of ``@code{#}''. The standard TAP protocol has currently no way to allow this, so if you use it your diagnostic will be lost to more diff --git a/tests/tap-doc2.test b/tests/tap-doc2.test index 4946a2c..76e1ade 100755 --- a/tests/tap-doc2.test +++ b/tests/tap-doc2.test @@ -62,7 +62,7 @@ cat > baz.test <<'END' #!/bin/sh echo 1..1 echo ok 1 -# Exit with error, even if all the test case has been successful. +# Exit with error, even if all the tests have been successful. exit 7 END -- 1.6.2.5 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sat Mar 24 12:26:38 2012 Received: (at 11079) by debbugs.gnu.org; 24 Mar 2012 16:26:38 +0000 Received: from localhost ([127.0.0.1]:37057 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SBTnZ-0002Zq-Lt for submit@debbugs.gnu.org; Sat, 24 Mar 2012 12:26:38 -0400 Received: from mail-we0-f172.google.com ([74.125.82.172]:47333) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SBTn0-0002Z3-MN; Sat, 24 Mar 2012 12:26:36 -0400 Received: by werb10 with SMTP id b10so3979038wer.3 for ; Sat, 24 Mar 2012 08:55:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:mime-version:to:cc:subject:references :in-reply-to:content-type; bh=WoH1im0hoZsweIGVfXHiLZtbLbdj4etchdJXWOFj5zE=; b=EqqdyGfshvoXLrBKU5Y4yvnuIuZi4kxI1vVqlzP1zJn4xwf45f3jKL8YZrOLRNbGMN 7sDyFg9gUiJmrldyjHZu5tNPvTS7CenFdlGlVAICrQQGidGZViGbzQ9+RYv/+Xq5mKzW 4yQAsT4FaKUxWUGiLsPfR0LqDFOaKb/Y9vyOqwDrlR7hfNYGHxSYCPygc5KMJvDZK6wN 6ybBk89XT0K91A3v2AKOElVT2Dv1r7KPEjTz36tMaZAzsh5aN3sYsaEvMjvYSLG3az07 SYjXO75Fo0NB9MlIHHRva6+vbABbk4HF0SLPhTxaPHA8AZDrsmpEk7ShtLsAP/vfwujK VhPw== Received: by 10.216.203.146 with SMTP id f18mr9163902weo.21.1332604502622; Sat, 24 Mar 2012 08:55:02 -0700 (PDT) Received: from [82.58.48.60] (host60-48-dynamic.58-82-r.retail.telecomitalia.it. [82.58.48.60]) by mx.google.com with ESMTPS id k6sm23789109wie.9.2012.03.24.08.55.00 (version=SSLv3 cipher=OTHER); Sat, 24 Mar 2012 08:55:01 -0700 (PDT) Message-ID: <4F6DEE4C.9070403@gmail.com> Date: Sat, 24 Mar 2012 16:54:52 +0100 From: Stefano Lattarini MIME-Version: 1.0 To: Tim Landscheidt Subject: Re: bug#11079: master: Small typos in TAP documentation References: In-Reply-To: Content-Type: multipart/mixed; boundary="------------020302080306090102040204" X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 11079 Cc: 11079@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) This is a multi-part message in MIME format. --------------020302080306090102040204 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit tags 11079 patch severity 11079 minor close 11079 thanks On 03/23/2012 10:46 PM, Tim Landscheidt wrote: > Hi, > Hi Tim, thanks for the report and the patch. > the attached patch fixes some small typos in the TAP documentation. > Well spotted! I've applied the patch (with minor tweaks to the commit message). > The latter also contains one unfinished sentence that the former marks > with FIXME. > Thanks for this as well. I've fixed the issued with the attached follow-up patch. I'm thus closing this bug report. Best regards, Stefano --------------020302080306090102040204 Content-Type: text/x-diff; name="0001-docs-terminate-unfinished-sentence-fix-reference-to-.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-docs-terminate-unfinished-sentence-fix-reference-to-.pa"; filename*1="tch" >From 6f245d7344f5bcc580ca2c27b7a06f4bd6d7598c Mon Sep 17 00:00:00 2001 Message-Id: <6f245d7344f5bcc580ca2c27b7a06f4bd6d7598c.1332604248.git.stefano.lattarini@gmail.com> From: Stefano Lattarini Date: Sat, 24 Mar 2012 16:50:38 +0100 Subject: [PATCH] docs: terminate unfinished sentence, fix reference to a test case * doc/automake.texi (Using the TAP test protocol): Here. Signed-off-by: Stefano Lattarini --- doc/automake.texi | 6 +++--- 1 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/automake.texi b/doc/automake.texi index ef65d8d..7d548c7 100644 --- a/doc/automake.texi +++ b/doc/automake.texi @@ -9602,12 +9602,12 @@ supports the following options, whose names are chosen for enhanced compatibility with the @command{prove} utility. @table @option -@c Keep in sync with 'tap-exit.test' and 'tap-signal.test'. +@c Keep in sync with 'tap-exit.test' and 'tap-signal.tap'. @item --ignore-exit Causes the test driver to ignore the exit status of the test scripts; by default, the driver will report an error if the script exits with a -non-zero status. This option has effect also -@c FIXME: The sentence above has no end. +non-zero status. This option has effect also on non-zero exit statuses +due to termination by a signal. @item --comments Instruct the test driver to display TAP diagnostic (i.e., lines beginning with the @samp{#} character) in the testsuite progress output too; by -- 1.7.9 --------------020302080306090102040204-- From unknown Mon Aug 18 04:42:18 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 22 Apr 2012 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator