Return-Path: owner-linux-activists@Niksula.hut.fi Return-Path: 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" To: "Linux-Activists" Reply-To: "Linux-Activists" 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 > > 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 ***************** ------- .