From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-2.sys.kth.se (smtp-2.sys.kth.se [130.237.32.160]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7K61pJ9011949 for ; Fri, 20 Aug 2010 02:01:52 -0400 (EDT) Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) by smtp-2.sys.kth.se (Postfix) with ESMTP id C8A2D14F2CE for ; Fri, 20 Aug 2010 08:01:45 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-2.sys.kth.se ([130.237.32.160]) by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024) with LMTP id oBDMP99JJDHr for ; Fri, 20 Aug 2010 08:01:44 +0200 (CEST) X-KTH-Auth: kristaps [85.8.60.63] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: source@mdocml.bsd.lv Received: from lappy.cust.alltele.se (h85-8-60-63.dynamic.se.alltele.net [85.8.60.63]) by smtp-2.sys.kth.se (Postfix) with ESMTP id B03B514F2CD for ; Fri, 20 Aug 2010 08:01:43 +0200 (CEST) Message-ID: <4C6E1A59.7080300@bsd.lv> Date: Fri, 20 Aug 2010 08:02:01 +0200 From: Kristaps Dzonsons User-Agent: Thunderbird 2.0.0.23 (X11/20100318) X-Mailinglist: mdocml-source Reply-To: source@mdocml.bsd.lv MIME-Version: 1.0 To: source@mdocml.bsd.lv Subject: Re: mdocml: Implement a simple, consistent user interface for error References: <201008200102.o7K127sh024959@krisdoz.my.domain> In-Reply-To: <201008200102.o7K127sh024959@krisdoz.my.domain> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit > Log Message: > ----------- > Implement a simple, consistent user interface for error handling. > We now have sufficient practical experience to know what we want, > so this is intended to be final: > - provide -Wlevel (warning, error or fatal) to select what you care about > - provide -Wstop to stop after parsing a file with warnings you care about > - provide consistent exit status codes for those warnings you care about > - fully document what warnings, errors and fatal errors mean > - remove all other cruft from the user interface, less is more: > - remove all -f knobs along with the whole -f option > - remove the old -Werror because calling warnings "fatal" is silly > - always finish parsing each file, unless fatal errors prevent that > This commit also includes a couple of related simplifications behind > the scenes regarding error handling. > Feedback and OK kristaps@; Joerg Sonnenberger (NetBSD) and > Sascha Wildner (DragonFly BSD) agree with the general direction. Ingo, a small thing I don't have the time to ferret out: .Dd $Mdocdate$ .Dt FOO 1 .Os .Sh NAME .Nm foo .Nd bar .Sh DESCRIPTION \( .Bk Different results: % ./mandoc -Wall foo.1 ; echo $? foo.1:8:1: WARNING: bad escape sequence foo.1:9:2: FATAL: scope broken, syntax violated 4 % ./mandoc -Wall,stop foo.1 ; echo $? foo.1:8:1: WARNING: bad escape sequence 2 Am I just being dumb here? Shouldn't the second one roll over the WARNING into the FATAL as well? Kristaps -- To unsubscribe send an email to source+unsubscribe@mdocml.bsd.lv