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
>Last-Modified: Thu Mar 01 22:37:24 +0000 2012
>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
$NetBSD: query-full-pr,v 1.36 2007/11/24 03:27:39 kano 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.