Subject: Re: standard MAN page format
To: Hubert Feyrer <firstname.lastname@example.org>
From: Michael Richardson <email@example.com>
Date: 10/12/2001 14:22:06
>>>>> "Hubert" == Hubert Feyrer <firstname.lastname@example.org> writes:
Hubert> On Fri, 12 Oct 2001, Michael Richardson wrote:
>> I think that we should introduce a new standard header: HOMEPAGE.
>> A URL could go under HISTORY instead I suppose.
>> This isn't too important for stuff distributed with the system, but
>> is for pkg's. I'd actually advocate putting the pkg-name as well into the man
>> page via some standard way, but I suspect that is a PITA.
>> The key thing is to put this into our reference (mdoc(7), mdoc.samples(7))
>> pages. I will do that if there are no objections.
Hubert> I think this kind of information is fine where it is - in the pkg's
Hubert> Makefile for pkgsrc, and in installed pkgs you can get it with "pkg_info
Hubert> pkgname". No need to frob that into manpages!
uh, the Makefile isn't installed with the pkg.
A *user* of a system may not even know about "pkg".
They just know that "man foo" tells them about the program.
] ON HUMILITY: to err is human. To moo, bovine. | firewalls [
] Michael Richardson, Sandelman Software Works, Ottawa, ON |net architect[
] email@example.com http://www.sandelman.ottawa.on.ca/ |device driver[
] panic("Just another NetBSD/notebook using, kernel hacking, security guy"); [