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