From owner-freebsd-doc@FreeBSD.ORG  Sun Jan  4 17:14:58 2009
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 810561065672;
	Sun,  4 Jan 2009 17:14:58 +0000 (UTC) (envelope-from simon@nitro.dk)
Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38])
	by mx1.freebsd.org (Postfix) with ESMTP id 0BC978FC08;
	Sun,  4 Jan 2009 17:14:58 +0000 (UTC) (envelope-from simon@nitro.dk)
Received: from arthur.nitro.dk (arthur.bofh [192.168.2.3])
	by mx.nitro.dk (Postfix) with ESMTP id 39B741E8C1D;
	Sun,  4 Jan 2009 17:14:56 +0000 (UTC)
Received: by arthur.nitro.dk (Postfix, from userid 1000)
	id 2D2CF5C86; Sun,  4 Jan 2009 18:14:56 +0100 (CET)
Date: Sun, 4 Jan 2009 18:14:56 +0100
From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Daniel Gerzo <danger@FreeBSD.org>
Message-ID: <20090104171455.GC1208@arthur.nitro.dk>
References: <200901041541.n04Ff1Oh060753@svn.freebsd.org>
	<20090104155832.GA1257@haakonia.hitnet.RWTH-Aachen.DE>
	<287359450.20090104174842@rulez.sk>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <287359450.20090104174842@rulez.sk>
User-Agent: Mutt/1.5.18 (2008-05-17)
Cc: doc@freebsd.org, Christian Brueffer <brueffer@FreeBSD.org>
Subject: Re: svn commit: r186737 - head/sbin/geom/class/virstor
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 04 Jan 2009 17:14:58 -0000

On 2009.01.04 17:48:42 +0100, Daniel Gerzo wrote:
> Hello Christian,
> 
> Sunday, January 4, 2009, 4:58:32 PM, you wrote:
> 
> > While using .Ex is good, collapsing EXIT STATUS into DIAGNOSTICS is not.
> > EXIT STATUS is a standard section in our manpages and it's orthogonal to
> > DIAGNOSTICS.
> 
> I am fine to revert this part, however I have trimmed this section
> just because I didn't see it listed in the PAGE STRUCTURE DOMAIN
> section of the mdoc(7) manual page.
> 
> Interestingly, it lists the DIAGNOSTICS section and explicitly
> says that .Ex macro should be used there.
> 
> If is it still preferred to revert this change, I would like to see
> this section added to the mdoc(7). Thoughts?

I really like having EXIT STATUS as a seperate section so I can
quickly find out what a program can return with.

The example(1) (/usr/share/examples/mdoc/example.1) does have EXIT
STATUS.

I think mentioning it in mdoc(7) seems like a good idea, but you
should probably get ru@'s input on that.

PS. ping(1) uses RETURN VALUES section instead which should probably
be changed.

-- 
Simon L. Nielsen