Subject: pkg/12349: packages(7) documents too much of Packages.txt
To: None <gnats-bugs@gnats.netbsd.org>
From: Nathan J. Williams <nathanw@dream.ai.mit.edu>
List: netbsd-bugs
Date: 03/07/2001 14:53:59
>Number:         12349
>Category:       pkg
>Synopsis:       packages(7) documents too much of Packages.txt
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Mar 07 11:55:00 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Nathan J. Williams
>Release:        NetBSD-current 20010306
>Organization:
	Massachvsetts Institvte of Technology
>Environment:
	
System: NetBSD dream.ai.mit.edu 1.5S NetBSD 1.5S (DREAM) #49: Thu Mar 1 15:15:58 EST 2001 nathanw@dream.ai.mit.edu:/u1/nbsd/src/sys/arch/i386/compile/DREAM i386
Architecture: i386
Machine: i386
>Description:
	The packages(7) man page purports to document the variables
that a user of pkgsrc may use to alter the building of packages. It
does this, and then proceeds to document many of the internal
variables used by package authors. This second part is not useful to
end-users of pkgsrc, and duplicates Packages.txt in such a way that it
is possible to (incorrectly) think that you don't need to read that
document.

>How-To-Repeat:
	man 7 packages

>Fix:
	Delete everything after the "COMMON VARIABLES" section.

>Release-Note:
>Audit-Trail:
>Unformatted: