NetBSD Problem Report #23035

Received: (qmail 15511 invoked by uid 605); 2 Oct 2003 07:47:57 -0000
Message-Id: <200310020748.h927mRGb017762@vhe-382807.sshn.net>
Date: Thu, 2 Oct 2003 09:48:27 +0200 (CEST)
From: Peter.Bex@student.kun.nl
Sender: gnats-bugs-owner@NetBSD.org
Reply-To: Peter.Bex@student.kun.nl
To: gnats-bugs@gnats.netbsd.org
Subject: Pkgsrc documentation incomplete
X-Send-Pr-Version: 3.95

>Number:         23035
>Category:       pkg
>Synopsis:       Pkgsrc documentation incomplete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Oct 02 07:48:00 +0000 2003
>Closed-Date:    
>Last-Modified:  Thu Mar 01 22:37:24 +0000 2012
>Originator:     Peter Bex
>Release:        NetBSD 1.6ZC
>Organization:
>Environment:


System: NetBSD frohike 1.6ZC NetBSD 1.6ZC (FROHIKE) #3: Wed Sep 24 01:32:20 CEST 2003 airhead@frohike:/usr/src/sys/arch/i386/compile/FROHIKE i386
Architecture: i386
Machine: i386
>Description:
Pkgsrc's documentation (on the site as well as in Packages.txt) on make targets
is very incomplete. This is annoying for users as well as developers, since
people have to ask about the same things over and over.
Examples of often asked questions are:
- How to show dependencies of packages
- How to know which mk.conf options are available for the current package
- How to request the version of the package
(There surely are more, but I don't know about them so I can't list them)

Even though, for example, 'make readme' is described (which will also show
version and dependencies), I think the targets should be listed somewhere at
the very least.

>How-To-Repeat:
n/a
>Fix:
Write about it ;)
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: jschauma 
State-Changed-When: Thu Dec 11 04:19:30 UTC 2003 
State-Changed-Why:  

Could you be so kind and provide patches against the documentation?  It would 
save us a lot of work... :)  Thanks! 


From: Peter Bex <Peter.Bex@student.kun.nl>
To: gnats-bugs@netbsd.org
Cc:  
Subject: Re: pkg/23035
Date: Tue, 20 Jan 2004 07:42:44 +0100

 --bg08WKrSYDhXBjb5
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable

 Hello all,

 I've submitted the PR because I found it quite annoying that many things
 aren't documented, even though I knew they should be possible.

 Here are two quite important examples which are omitted from Packages.txt:

 print-build-depends-list
 	Shows the list of packages the current package depends on for building.

 print-run-depends-list
 	Shows the list of packages the current package depends on for running.

 If these are elsewhere, I'd appreciate it if someone would post an URL, but
 I thought Packages.txt is the definate documentation.
 I'm not a pkgsrc developer myself, so I don't know most targets myself, eit=
 her.

 Perhaps it would be a good idea to make an introductory text and a text with
 a full listing of the targets?  Then the introductory text wouldn't become
 too cluttered with `difficult' or too many targets.

 Sorry I can't help more.

 Regards,
 Peter
 --=20
 http://www.student.kun.nl/peter.bex
 --
 "The process of preparing programs for a digital computer
  is especially attractive, not only because it can be economically
  and scientifically rewarding, but also because it can be an aesthetic
  experience much like composing poetry or music."
 							-- Donald Knuth

 --bg08WKrSYDhXBjb5
 Content-Type: application/pgp-signature
 Content-Disposition: inline

 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.3 (NetBSD)

 iD8DBQFADM3kLg33BXzVMqsRAraDAJ0Z5xFF7zfkRy3C6Z+kROWeyqFkGwCfaEbz
 rbwYgrxURREK5Cl6ZMS/JWw=
 =kthj
 -----END PGP SIGNATURE-----

 --bg08WKrSYDhXBjb5--
State-Changed-From-To: feedback->open 
State-Changed-By: wiz 
State-Changed-When: Tue Jul 27 15:59:35 UTC 2004 
State-Changed-Why:  
Feedback supplied. 
Responsible-Changed-From-To: pkg-manager->rillig
Responsible-Changed-By: joerg@netbsd.org
Responsible-Changed-When: Sun, 24 Sep 2006 19:57:49 +0000
Responsible-Changed-Why:
Roland handles most of the Guide in the current age.
Let him decide what is still missing.


Responsible-Changed-From-To: rillig->pkg-manager
Responsible-Changed-By: wiz@NetBSD.org
Responsible-Changed-When: Thu, 01 Mar 2012 22:37:24 +0000
Responsible-Changed-Why:
back to role account, rillig resigned


>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2007 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.