Return-Path: owner-linux-activists@Niksula.hut.fi
Return-Path: <owner-linux-activists@Niksula.hut.fi>
Received: from joker.cs.hut.fi by hydra.Helsinki.FI (4.1/SMI-4.1/39)
	id AA28525; Mon, 22 Mar 93 18:28:22 +0200
Received: from joker.cs.hut.fi by niksula.hut.fi id <61571-2>; Mon, 22 Mar 1993 18:26:40 +0200
From: "Linux Activists" <linux-activists@Niksula.hut.fi>
To: "Linux-Activists" <linux-activists@Niksula.hut.fi>
Reply-To: "Linux-Activists" <linux-activists@Niksula.hut.fi>
X-Note1: Remember to put 'X-Mn-Key: DOC' to your mail body or header
Subject: Linux-Activists - DOC Channel digest. 93-2-22-12:18
X-Mn-Key: DOC
Sender: owner-linux-activists@Niksula.hut.fi
Message-Id: <93Mar22.182640eet.61571-2@niksula.hut.fi>
Date: Mon, 22 Mar 1993 18:26:38 +0200
Status: RO
X-Status: 


Topics:
	 Re: manual page template


----------------------------------------------------------------------

From: michael@gandalf.moria (Michael Haardt)
Subject: Re: manual page template
Date: Fri, 19 Mar 1993 18:28:43 +0200



At first, sorry for the delays in answering.  I have a new 5.25 inch
drive 0 now, I think that explains something.

> From: Lar Kaufman <lark@ora.com>
>
> I disagree with two aspects of Christensen's manpage organization.
> First, there should be no Bugs section, there should instead
> be notes about any bugs in the appropriate context of the
> DESCRIPTION section.  This is a usability issue.  Second, the
> SEE ALSO section should be the last section - again, to
> facilitate usability.

I disagree with having no BUGS section, I like to have pages as
structured as possible.  It makes reading easier to me because the
structure is more obvious.  Document systems support structure more and
more :)

However, SEE ALSO being the last section seems a good idea to me.  Of
course that means that all pages have to be changed, but they are folded
with Origami now, so this is easy.

Comments?

Michael (u31b3hs@pool.informatik.rwth-aachen.de)



------------------------------

End of DOC Digest
*****************
-------
