svn commit: r186737 - head/sbin/geom/class/virstor

[Christian Brueffer]

On Sun, Jan 04, 2009 at 06:14:56PM +0100, Simon L. Nielsen wrote:
> 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.
> 

Right, I think ru simply forgot to document it or didn't document it
because mdoc(7) is a vendor manpage and EXIT STATUS is a "non-standard
mdoc" FreeBSD-specific section.

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

Yes, also a nice example of a utility that uses more than just 0 and 1
as exit status.

- Christian

-- 
Christian Brueffer	chris at unixpages.org	brueffer at FreeBSD.org
GPG Key:	 http://people.freebsd.org/~brueffer/brueffer.key.asc
GPG Fingerprint: A5C8 2099 19FF AACA F41B  B29B 6C76 178C A0ED 982D
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20090105/cc972a1d/attachment.sig>