Automatic conversion of the NetBSD pkgsrc CVS module, use with care
Find a file
jtb 80353eeae6 Use makeinfo to format the info manual. It seems that sometimes Emacs
just can't get enough memory:

Formatting: Frame Configuration ...
Memory exhausted--use M-x save-some-buffers RET
*** Error code 255

(From recent pkgsrc/i386 bulk build).
2000-12-13 23:14:07 +00:00
archivers Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
audio Fix typo in MASTER_SITES. Closes pkg/11723 by zuntum@eik.pl. 2000-12-13 16:35:23 +00:00
benchmarks Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
biology Add and enable "chemtool". Fixes PR pkg/11377 by Jason Beegan. 2000-11-25 20:14:30 +00:00
cad Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
comms Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
converters Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
cross Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
databases Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
devel Make sure we install cweb with the same PREFIX as teTeX (TeX won't find 2000-12-13 22:27:11 +00:00
distfiles These files belong to $MASTER_SITE_LOCAL - moved them there! 2000-12-05 00:23:05 +00:00
editors add and enable gnotepad 2000-12-13 01:25:14 +00:00
emulators Slurp in suse_png-7.0, and bump to suse_linux-6.3nb3 2000-12-13 20:59:44 +00:00
finance Move gnofin from misc to finance. 2000-12-13 22:40:57 +00:00
fonts add caveat. some fonts seem to have wrong font metric. 2000-11-02 04:20:07 +00:00
games Create and remove directory "share/doc/kde/HTML/pt" in "kdebase" package 2000-12-13 11:46:37 +00:00
graphics Apply the four available (official) patches for this package, noted in 2000-12-13 19:21:42 +00:00
ham sort 2000-10-24 10:13:35 +00:00
japanese make call to getpeername IPv6-friendly. 2000-12-01 03:15:33 +00:00
lang Cosmetic changes. 2000-12-13 22:33:25 +00:00
mail Use makeinfo to format the info manual. It seems that sometimes Emacs 2000-12-13 23:14:07 +00:00
math Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
mbone Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
meta-pkgs Wildcard DEPENDS - half were broken. 2000-12-12 17:52:32 +00:00
misc Move gnofin from misc to finance. 2000-12-13 22:40:57 +00:00
mk Add authoritative CPAN ftp site as a last resort in case packages have 2000-12-12 01:04:16 +00:00
net Add and enable fair-identd 2000-12-12 10:29:19 +00:00
news Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
packages Add .cvsignore to stop cvs update listing every distfile and more 1999-11-24 11:53:24 +00:00
parallel remove trailing whitespace 2000-10-21 22:52:37 +00:00
pkgtools add and enable bsdpak 2000-12-09 00:44:26 +00:00
plan9 Complete move of 9wm from category plan9 to wm. 2000-12-12 13:07:14 +00:00
print Add and enable "LPRng-core" and "LPRng-doc" packages. 2000-12-13 00:40:06 +00:00
security Rename pwcheck' rc.d control script to sasl_pwcheck' to avoid name clash 2000-12-13 16:24:50 +00:00
shells Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
sysutils Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
templates Change substitution of %%PKG%% so it's expanded to ${PKGNAME} directly, not 2000-11-09 23:46:29 +00:00
textproc Unify Makefiles -- mostly headers: remove FreeBSD Ids. 2000-12-12 01:30:36 +00:00
wm Complete move of 9wm from category plan9 to wm. 2000-12-12 13:07:14 +00:00
www add some mirrors, and pull in suse_libpng 2000-12-13 21:07:27 +00:00
x11 Remove trailing / from dirname 2000-12-13 17:49:39 +00:00
Makefile Added wm category to main Makefile; remove packages that have been moved 2000-12-12 02:10:16 +00:00
Packages.txt REQ is no more, its place is taken by INSTALL & friends. 2000-12-08 10:17:36 +00:00
pkglocate fix to really exit if glimpse is not installed 2000-04-11 16:59:17 +00:00
README No paragraph (picking nits). 2000-07-23 18:02:33 +00:00

$NetBSD: README,v 1.11 2000/07/23 18:02:33 fredb 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 where you found this README, or in your top-level pkgsrc
directory.