From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3120 invoked by alias); 14 Dec 2011 19:43:13 -0000 Received: (qmail 3111 invoked by uid 22791); 14 Dec 2011 19:43:12 -0000 X-SWARE-Spam-Status: No, hits=-5.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,SPF_HELO_PASS X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 14 Dec 2011 19:42:53 +0000 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id pBEJgUY1029479 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 14 Dec 2011 14:42:30 -0500 Received: from host2.jankratochvil.net (ovpn-116-16.ams2.redhat.com [10.36.116.16]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id pBEJgLII009363 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Wed, 14 Dec 2011 14:42:26 -0500 Date: Wed, 14 Dec 2011 19:51:00 -0000 From: Jan Kratochvil To: Doug Evans Cc: Joel Brobecker , Tom Tromey , gdb-patches@sourceware.org Subject: [doc patch] gdbint: XFAIL vs. KFAIL [Re: [patch] gcc KFAILs to XFAILs] Message-ID: <20111214194220.GA24281@host2.jankratochvil.net> References: <20111209171630.GA30059@host2.jankratochvil.net> <20111209171937.GA30594@host2.jankratochvil.net> <20111209215319.GA5132@host2.jankratochvil.net> <20111210160145.GA7261@host2.jankratochvil.net> <20111211024742.GN21915@adacore.com> <20111211092552.GA14574@host2.jankratochvil.net> <20111211124213.GO21915@adacore.com> <20111214185650.GA8485@host2.jankratochvil.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-12/txt/msg00466.txt.bz2 On Wed, 14 Dec 2011 20:28:15 +0100, Doug Evans wrote: > Can someone check into gdbint.texi definitions of xfail and kfail? > There's a section "Writing Tests", seems like an appropriate place. FYI I wanted to add it to http://sourceware.org/gdb/wiki/GDBTestcaseCookbook but it already states: Known failing new testcases must produce KFAIL (GDB problem) or XFAIL (environment problem). Not going to check it in without the doc review. Thanks, Jan gdb/doc/ 2011-12-14 Jan Kratochvil * gdbint.texinfo (Testsuite): Describe KFAIL and XFAIL in Writing tests. --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -7846,6 +7846,20 @@ instance, some @value{GDBN} bugs involving the display of source lines would never manifest themselves if the programs used GNU coding style uniformly. +Some testcase results need more detailed explanation: + +@table @code +@item KFAIL +Known problem of @value{GDBN} itself. You must specify the @value{GDBN} bug +report number. + +@item XFAIL +Known problem of environment. This typically includes @value{NGCC} but it +includes also many other system components which cannot be fixed in the +@value{GDBN} project. You should provide bug report number for the failing +component of the environment, if such bug report is available. +@end table + @node Hints @chapter Hints