NetBSD Problem Report #23035
Received: (qmail 15511 invoked by uid 605); 2 Oct 2003 07:47:57 -0000
Date: Thu, 2 Oct 2003 09:48:27 +0200 (CEST)
Subject: Pkgsrc documentation incomplete
>Synopsis: Pkgsrc documentation incomplete
>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
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
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.
Write about it ;)
State-Changed-When: Thu Dec 11 04:19:30 UTC 2003
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>
Subject: Re: pkg/23035
Date: Tue, 20 Jan 2004 07:42:44 +0100
Content-Type: text/plain; charset=us-ascii
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:
Shows the list of packages the current package depends on for building.
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=
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.
"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
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (NetBSD)
-----END PGP SIGNATURE-----
State-Changed-When: Tue Jul 27 15:59:35 UTC 2004
Responsible-Changed-When: Sun, 24 Sep 2006 19:57:49 +0000
Roland handles most of the Guide in the current age.
Let him decide what is still missing.
Responsible-Changed-When: Thu, 01 Mar 2012 22:37:24 +0000
back to role account, rillig resigned
Responsible-Changed-When: Mon, 24 Nov 2014 09:19:40 +0000
I am going to do the edit, 11 years later.
This sounds like a useful thing to have.
From: "Benny Siegert" <email@example.com>
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
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-When: Fri, 08 May 2015 20:31:40 +0000
Fix committed. I did not regenerate the pkgsrc guide yet though.
$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.