Subject: Re: standard MAN page format
To: Hubert Feyrer <hubert.feyrer@informatik.fh-regensburg.de>
From: Michael Richardson <mcr@sandelman.ottawa.on.ca>
List: tech-userlevel
Date: 10/12/2001 14:22:06
>>>>> "Hubert" == Hubert Feyrer <hubert.feyrer@informatik.fh-regensburg.de> 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[
] mcr@sandelman.ottawa.on.ca http://www.sandelman.ottawa.on.ca/ |device driver[
] panic("Just another NetBSD/notebook using, kernel hacking, security guy");  [