From owner-svn-src-head@FreeBSD.ORG Thu Jan 17 03:41:23 2013 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id B27AB331 for ; Thu, 17 Jan 2013 03:41:23 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-la0-f44.google.com (mail-la0-f44.google.com [209.85.215.44]) by mx1.freebsd.org (Postfix) with ESMTP id 274F579B for ; Thu, 17 Jan 2013 03:41:22 +0000 (UTC) Received: by mail-la0-f44.google.com with SMTP id eb20so1011892lab.3 for ; Wed, 16 Jan 2013 19:41:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=x-received:mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type; bh=teeKrHj9lJDjzm17y09JVV6TCs9lMPkl+GjnDlFmRAo=; b=No3hWx1G/aG4/ygIunsEJYWmv2QF/pG4tD4buqH/tlXQe7PG1QBBG203rOENc0+Mr7 M1Amt2czeKr8DT9vjAMAh9HJW6pHTgE1I/NAhXLH51pjPBTdwOZvVbw9Mp0yXnyRf9bc je9IDV8Q9A+hqg+tj4BG4WD6vUIRMOBXqrJL0= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=x-received:mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :x-gm-message-state; bh=teeKrHj9lJDjzm17y09JVV6TCs9lMPkl+GjnDlFmRAo=; b=lytgErtu2QijjJELk9xSTINGZ9BUawhBxgXInK/7cCmCoGrqDzQXbvCB5kP+uXZQhp wkQIHkC1ThGDhM/I1uFr0pAF5Iqx3jYIv5Mgw4CDjBs86BMFmSsR2YlEeh1ZOPlsku42 edGlT1w9yvUVnFCcR6CC1mU7s0y86p/iWjMqp0ZgnOW332Oj7OmpOCw1v1TDHzR1N1XA E28SR/mCL76J3S0cgEAYsYLNIPO1LRS118XkI97xmw4eS4lFP1v+6F7szkrLfcPpjdmi Nt4QQEWi9iTtoL5y4t3VY7sBvsuRqg2csUn03/mErFqTUQdbJtNRt/8bu1dzc+DZMwy7 p6LA== X-Received: by 10.152.125.136 with SMTP id mq8mr3286904lab.41.1358394081599; Wed, 16 Jan 2013 19:41:21 -0800 (PST) MIME-Version: 1.0 Sender: lists@eitanadler.com Received: by 10.112.30.131 with HTTP; Wed, 16 Jan 2013 19:40:51 -0800 (PST) In-Reply-To: <20130117130740.I1066@besplex.bde.org> References: <201301161815.r0GIFQPk007553@svn.freebsd.org> <20130117130740.I1066@besplex.bde.org> From: Eitan Adler Date: Wed, 16 Jan 2013 22:40:51 -0500 X-Google-Sender-Auth: MvjbaOfpgIqbw6yjJMROFwC1Rfs Message-ID: Subject: Re: svn commit: r245506 - head/bin/pwait To: Bruce Evans Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQkzz0ZiYT8Ofm7FJ4ZPNOtiEnZgDwpoY/xPut7yWGAcrzEcCuDX+/Te53GDF+rfptj3BIzM Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org, Xin LI X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Jan 2013 03:41:23 -0000 On 16 January 2013 21:25, Bruce Evans wrote: > This uses the sysexits mistake. style(9) was fixed to not give an example > of this mistake. Before this, sysexits was used a whole once in pwait(1) > (for EX_USAGE) in usage(). EX_USAGE happens to be 64. As usual when the > mistake is used, this is useless for humans (the usage message gives more > info) and unusable for programs, especially since it is undocmented > (pwait(1)'s man page just says ">0 if an error occurs". It doesn't even > use '.Std' for this, but hard-codes it. IMHO using sysexits gives more signal than using a binary 0 or 1. It is a mistake to have changed style(9) to avoid using sysexits. Instead the man page should detail the specific error that occurs directly, or by reference to sysexit. -- Eitan Adler Source, Ports, Doc committer Bugmeister, Ports Security teams