Automatic conversion of the NetBSD pkgsrc CVS module, use with care
Find a file
1998-11-13 01:26:58 +00:00
archivers Set EXTRACT_SUFX and WRKSRC to keep pkglint happy. 1998-11-12 15:22:56 +00:00
audio Fix some more pkglint nits. 1998-11-12 23:03:39 +00:00
benchmarks s/echo/${ECHO}/ 1998-11-12 16:15:29 +00:00
cad Enable pcb. 1998-11-07 14:33:39 +00:00
comms Add missing NetBSD RCS Id. 1998-11-12 16:18:27 +00:00
converters Update for the qt 1.41. 1998-11-06 05:15:41 +00:00
corba Fix some more pkglint nits. 1998-11-12 23:03:39 +00:00
cross Fix location of wmemu2b.zip. 1998-08-26 19:35:37 +00:00
databases minor pkglint nits. 1998-11-13 00:47:51 +00:00
devel Fix some more pkglint nits. 1998-11-12 23:03:39 +00:00
distfiles Explain what goes here. 1997-12-17 09:25:18 +00:00
editors Fix some more pkglint nits. 1998-11-12 23:03:39 +00:00
emulators Some more pkglint stuff. 1998-11-12 23:20:09 +00:00
fonts/Xg Add NetBSD RCS Ids. 1998-08-07 13:27:33 +00:00
games Some more for pkglint. 1998-11-12 23:34:30 +00:00
graphics pkglint: $(VARIABLE) -> ${VARIABLE}; move PATCH* where it belongs. 1998-11-13 01:12:57 +00:00
japanese Initial import of new japanese category, and it's very first pkg, 1998-10-28 18:12:10 +00:00
lang pkglint: move NOT_FOR_ARCHS where it belongs. 1998-11-13 01:16:35 +00:00
mail pkglint: move NOT_FOR_ARCHS where it belongs. 1998-11-13 01:16:35 +00:00
math pkglint: move NOT_FOR_ARCHS and WRKSRC where it belongs; tr -> {TR}. 1998-11-13 01:25:12 +00:00
mbone pkglint: move NOT_FOR_ARCHS where it belongs. 1998-11-13 01:26:58 +00:00
meta-pkgs As apache got upgraded to 1.3.1, adjust DEPENDS on it as well. 1998-08-14 10:17:44 +00:00
misc pkglint: move NOT_FOR_ARCHS where it belongs. 1998-11-13 01:26:58 +00:00
mk bump PKGTOOLS_REQD to 19981107 1998-11-09 15:45:11 +00:00
net Add missing rcs ids. 1998-11-12 23:40:20 +00:00
news Add missing rcs ids. 1998-10-31 23:06:31 +00:00
packages Explain what goes here. 1997-12-17 09:25:18 +00:00
parallel Add missing rcs id. 1998-11-12 23:45:54 +00:00
pkgtools Add missing rcs ids. 1998-11-12 23:40:20 +00:00
plan9 Enable "#define PROTECT_ENV", closes pr 6266 by Sean Doran. 1998-10-25 10:14:06 +00:00
print Add missing NetBSD RCS Id. 1998-11-12 14:37:14 +00:00
security Some pkglint nits and add all missing rcs ids. 1998-11-12 23:48:35 +00:00
shells Enable "#define PROTECT_ENV", closes pr 6266 by Sean Doran. 1998-10-25 10:14:06 +00:00
sysutils Add missing rcs id. 1998-11-12 23:50:33 +00:00
templates Packages.txt moved. 1998-08-23 01:32:19 +00:00
textproc Remove unnecessary blank line. 1998-11-12 23:51:12 +00:00
www Correct rcs id. 1998-11-13 00:01:49 +00:00
x11 Minor formatting changes. 1998-11-12 15:02:05 +00:00
Makefile Enable new japanese category, and document addition of category, and 1998-10-28 18:16:50 +00:00
Packages.txt Add a cdrom-readme target, a clone of the readme target, for ease of use. 1998-09-23 13:09:32 +00:00
README Minor mods to clean up the English. 1998-09-01 11:03:23 +00:00

$NetBSD: README,v 1.8 1998/09/01 11:03:23 agc 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 && 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".

+ 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.

+ 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 pksrc/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.

For more information on the packages collection see the file
Packages.txt in this directory.