Subject: pkg/24368: netpbm provides no local man pages
To: None <gnats-bugs@gnats.netbsd.org>
From: None <cjb@brushtail.apana.org.au>
List: netbsd-bugs
Date: 02/09/2004 07:13:20
>Number:         24368
>Category:       pkg
>Synopsis:       netpbm provides no local man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun Feb 08 20:15:00 UTC 2004
>Closed-Date:
>Last-Modified:
>Originator:     Chris Baird
>Release:        NetBSD 1.6ZI
>Organization:
Australian Public Access Network Association, Angry Cyclists Division.
>Environment:
System: NetBSD brushtail.apana.org.au 1.6ZI NetBSD 1.6ZI (Brushtail) #187: Thu Feb 5 07:32:30 EST 2004 cjb@brushtail.apana.org.au:/root/Brushtail i386
Architecture: i386
Machine: i386
Pkgsrc: last rsync'd on 6 Feb 2004
>Description:

Netpbm's current maintainer doesn't believe in man pages (or a
"--help" flag, for that matter), and insists users refer to online
documentation.
	
>How-To-Repeat:

Go on a long-distance cycling/hiking trip, and while trying to process
digital camera images so to free up diskspace on a laptop, discover
that the options to various netpbm tools have changed. Note that the
existing faux man page refers to online documentation, and even
"strings" on the executables is of little help.

>Fix:

Suggestion 1: Slap Bryan Henderson about the head for an hour until he
gets the hint that exclusively online documentation is retarded.

Suggestion 2: provide a graphics/netpbm-doc package in pkgsrc, that
either spiders the online documentation and preferably munges it into
man-page format, or alternatively, installs from a snapshot of
pre-prepared documentation from our LOCAL_PORTS archive.
>Release-Note:
>Audit-Trail:
>Unformatted: