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:    bsiegert
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Oct 02 07:48:00 +0000 2003
>Closed-Date:    Fri May 08 20:31:40 +0000 2015
>Last-Modified:  Fri May 08 20:31:40 +0000 2015
>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


Responsible-Changed-From-To: pkg-manager->bsiegert
Responsible-Changed-By: bsiegert@NetBSD.org
Responsible-Changed-When: Mon, 24 Nov 2014 09:19:40 +0000
Responsible-Changed-Why:
I am going to do the edit, 11 years later.
This sounds like a useful thing to have.


From: "Benny Siegert" <bsiegert@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/23035 CVS commit: pkgsrc/doc/guide/files
Date: Fri, 8 May 2015 20:26:19 +0000

 Module Name:	pkgsrc
 Committed By:	bsiegert
 Date:		Fri May  8 20:26:19 UTC 2015

 Modified Files:
 	pkgsrc/doc/guide/files: build.xml

 Log Message:
 Document install-clean, build-clean, print-build-depends-list and
 print-run-depends-list. The former two are from a recent mail on tech-pkg
 (obache@, I believe), the latter two are from PR pkg/23035 (which was filed
 in 2003, oh my).


 To generate a diff of this commit:
 cvs rdiff -u -r1.71 -r1.72 pkgsrc/doc/guide/files/build.xml

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: bsiegert@NetBSD.org
State-Changed-When: Fri, 08 May 2015 20:31:40 +0000
State-Changed-Why:
Fix committed. I did not regenerate the pkgsrc guide yet though.
.


>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-2014 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.