Automatic conversion of the NetBSD pkgsrc CVS module, use with care
Find a file
hubertf 0a38992063 fetch-list: properly quote URLs printed, as they may contain things that
the shell doesn't like.

Fixes PR 14347 by Ben Wong <Benjamin.Wong@cc.gatech.edu>
2001-11-26 19:56:06 +00:00
archivers Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
audio Buildlinkify, and use REPLACE_PERL instead of home-grown method of 2001-11-26 10:00:36 +00:00
benchmarks Move pkg/ files into package's toplevel directory 2001-10-31 22:52:58 +00:00
biology Replace "${GTAR} cf - . | (cd ... ; ${GTAR} xf - )" pipelines with a 2001-11-14 14:47:53 +00:00
cad add and enable gerbv, gnucap, and mcalc. 2001-11-15 04:00:22 +00:00
chat PKG_SYSCONFDIR is where the configuration files for a package may be found. 2001-11-25 18:59:45 +00:00
comms Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
converters Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
cross Move pkg/ files into package's toplevel directory 2001-10-31 22:03:21 +00:00
databases Forgot a CONFDIR -> PKG_SYSCONFDIR replacement. 2001-11-26 07:30:44 +00:00
devel Update to 5.0, provided by Shell Hung in pkg/14694. 2001-11-26 17:38:11 +00:00
distfiles These files belong to $MASTER_SITE_LOCAL - moved them there! 2000-12-05 00:23:05 +00:00
editors Updated to 0.9.5. 2001-11-26 13:08:24 +00:00
emulators Update xmame to 0.56.1: 2001-11-23 23:51:23 +00:00
finance Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
fonts Upgrade mkttfdir from 1.0 to 1.1. Provided in PR 14641 by Rui-Xiang Guo 2001-11-22 13:42:08 +00:00
games Use the general INSTALL/DEINSTALL scripts instead of the homegrown ones. 2001-11-19 23:33:03 +00:00
graphics remove some more locale dirs 2001-11-26 13:32:49 +00:00
ham Move pkg/ files into package's toplevel directory 2001-10-31 20:59:00 +00:00
japanese Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
lang Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
licenses VMWare license in preparation for the package in emulators/vmware. 2001-07-07 14:24:21 +00:00
mail Forgot a CONFDIR -> PKG_SYSCONFDIR replacement. 2001-11-26 07:30:44 +00:00
math Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
mbone Move pkg/ files into package's toplevel directory 2001-10-31 20:59:00 +00:00
meta-pkgs Move pkg/ files into package's toplevel directory 2001-10-31 20:59:00 +00:00
misc Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
mk fetch-list: properly quote URLs printed, as they may contain things that 2001-11-26 19:56:06 +00:00
net Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
news Move pkg/ files into package's toplevel directory 2001-10-31 20:59:00 +00:00
packages Add .cvsignore to stop cvs update listing every distfile and more 1999-11-24 11:53:24 +00:00
parallel Move pkg/ files into package's toplevel directory 2001-10-31 22:52:58 +00:00
pkgtools Update pkgchk to 1.19 2001-11-21 23:01:56 +00:00
print Forgot a CONFDIR -> PKG_SYSCONFDIR replacement. 2001-11-26 07:30:44 +00:00
security Forgot a CONFDIR -> PKG_SYSCONFDIR replacement. 2001-11-26 07:30:44 +00:00
shells Move pkg/ files into package's toplevel directory 2001-10-31 22:18:56 +00:00
sysutils Update to 2.11, with 'new' NetBSD-apm supported provided by Love. 2001-11-26 19:55:40 +00:00
templates Fix the location of DESCR for the readme files 2001-11-03 03:26:08 +00:00
textproc Buildlinkify, in the sense that only the perl headers are found in 2001-11-26 06:49:36 +00:00
time Strongly buildlinkify, and make this package work on Solaris by following 2001-11-15 07:58:50 +00:00
wm scwm has been broken for over a year now (because it doesn't work with 2001-11-09 00:43:12 +00:00
www Add missing file "share/omf/galeon/galeon-manual-C.omf". 2001-11-26 15:41:15 +00:00
x11 Add PREFIX to configure environment. The configure script needs it. 2001-11-26 14:47:06 +00:00
Makefile Use better expressions for grep, to avoid tagging non-IPv6 enabled packages 2001-07-17 13:11:51 +00:00
Packages.txt Add description of PKG_SYSCONFDIR and related variables, and note that 2001-11-25 19:10:27 +00:00
pkglocate Apply mods from PR 14495, from Ryo HAYASAKA (ryoh@jaist.ac.jp), so that 2001-11-07 22:11:13 +00:00
README update a bit 2001-06-06 19:41:05 +00:00
TODO Added the gnome Nautilus file manager to be made into a pkg 2001-10-30 14:17:19 +00:00

$NetBSD: README,v 1.12 2001/06/06 19:41:05 hubertf Exp $

Welcome to the NetBSD Packages Collection
=========================================

In brief, the NetBSD Packages Collection is a set of software
utilities and libraries which have been ported to NetBSD.

The packages collection software can retrieve the software from its
home site, assuming you are connected in some way to the Internet,
verify its integrity, apply any patches, configure the software for
NetBSD, and build it.  Any prerequisite software will also be built
and installed for you.  Installation and de-installation of software
is managed by the packaging utilities.

The packages collection is made into a tar_file every week: 

	ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz

and you can sup the pkgsrc tree using the `pkgsrc' name for the
collection.

The pkgsrc tree is laid out in various categories, and, within that,
the various packages themselves.

You need to have root privileges to install packages.  We are looking
at ways to remove this restriction.

+ To install a package on your system, you need to change into the
directory of the package, and type "make install".

+ If you've made a mistake, and decided that you don't want that
package on your system, then type "pkg_delete <pkg-name>", or "make
deinstall" while in the directory for the package.

+ To find out all the packages that you have installed on your system,
type "pkg_info".

+ To remove the work directory, type "make clean", and "make
clean-depends" will clean up any working directories for other
packages that are built in the process of making your package.

+ Optionally, you can periodically run "make clean" from the top
level pkgsrc directory. This will delete extracted and built files,
but will not affect the retreived source sets in pkgsrc/distfiles.

+ You can set variables to customise the behaviour (where packages are
installed, various options for individual packages etc), by setting
variables in /etc/mk.conf.  The pkgsrc/mk/mk.conf.example file
provides some examples for customisation.

The best way to find out what packages are in the collection is to
move to the top-level pkgsrc directory (this will usually be
/usr/pkgsrc), and type "make readme".  This will create a file called
README.html in the top-level pkgsrc directory, and also in all
category and package directories.  You can then see what packages are
available, along with a short (one-line) comment about the function of
the package, and a pointer to a fuller description, by using a browser
like lynx (see pkgsrc/www/lynx) or Mozilla (pkgsrc/www/mozilla), or
Communicator.  This is also available online as
ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html.

Another way to find out what packages are in the collection is to
move to the top-level pkgsrc directory and type "make index". This
will create pkgsrc/INDEX which can be viewed via "make print-index | more".
You can also search for particular packages or keywords via
"make search key=<somekeyword>".

It is also possible to use the packaging software to install
pre-compiled binary packages by typing "pkg_add <URL-of-binary-pkg>". 
To see what binary packages are available, see:

	ftp://ftp.netbsd.org/pub/NetBSD/packages/<release>/<arch>/All/

where <release> is the NetBSD release, and <arch> is the hardware
architecture.

One limitation of using binary packages provided from ftp.netbsd.org
is that all mk.conf options were set to the defaults at compile time.
LOCALBASE, in particular, defaults to /usr/pkg, so non-X binaries
will be installed in /usr/pkg/bin, man pages will be installed in
/usr/pkg/man...

When a packaged tool has major compile time choices, such as support
for multiple graphic toolkit libraries, the different options may
be available as separate packages.

For more information on the packages collection see the file
Packages.txt file in the same place where you found this README,
usually in the top-level pkgsrc dir.
directory.