Subject: Re: standard MAN page format
To: None <tech-userlevel@netbsd.org>
From: Michael Richardson <mcr@sandelman.ottawa.on.ca>
List: tech-userlevel
Date: 10/17/2001 15:36:25
>>>>> "Wiz" == Wiz  <wiz@danbala.ifoer.tuwien.ac.at> writes:
    Wiz> In article <200110121822.f9CIM7p15272@marajade.sandelman.ottawa.on.ca> you wrote:

    >> > 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.
    Wiz> [and later]
    >> 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.

    Wiz> I think the better answer is to educate your users in this case:
    Wiz> `pkg_info packagename' includes the Homepage URL.

  Hmm. Never noticed that.

    Wiz> If you want to have the homepage included in the man page, I think you
    Wiz> should take up this discussion with the groff maintainers.  There
    Wiz> actually is a .URL even in the groff in -current, but I think it's
    Wiz> only honored if you convert to HTML.

    Wiz> The problem is that we'd have to patch literally thousands of man
    Wiz> pages in pkgsrc, and I don't think that's realistic, or useful.

  Perhaps some hack to "man" (or man -k) to look up the package for an
argument to point people at running "pkg_info" in some way. 

]       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");  [