Automatic conversion of the NetBSD pkgsrc CVS module, use with care
Find a file
zuntum e30ad1338f Add some of my ideas (various updates and qmail addition)
I added new entry "suggested package updates", not sure whether
you like it. Feel free to modify.
2001-05-04 12:59:30 +00:00
archivers Make $(localdir) and $(gnulocaledir) equal so that the locale files 2001-04-28 02:05:57 +00:00
audio Install html documentation in share/doc/html instead of share/doc. 2001-05-02 13:59:33 +00:00
benchmarks Add distinfo file. 2001-04-27 23:33:24 +00:00
biology Remove redundant echoing, quoting, and input redirection to sed. 2001-04-28 23:59:17 +00:00
cad Add some defaults for EVAL_PREFIX. 2001-05-03 22:02:59 +00:00
chat add & enable tirc 2001-04-27 11:04:08 +00:00
comms Update hylafax dependency to 4.1b3 2001-04-26 14:14:04 +00:00
converters Move to sha1 digests, and add distfile sizes. 2001-04-18 16:28:00 +00:00
cross Move to sha1 digests, and add distfile sizes. 2001-04-21 09:36:23 +00:00
databases Share a common distinfo file with the postgresql package. 2001-05-04 01:05:19 +00:00
devel Deal with "unix no longer predefined" warning. Modify Makefile so we don't 2001-05-04 01:28:14 +00:00
distfiles These files belong to $MASTER_SITE_LOCAL - moved them there! 2000-12-05 00:23:05 +00:00
editors The dired package has been modified without changing its version number. 2001-05-03 16:00:02 +00:00
emulators Added LibXm (OpenMotif) requiered by the JDK (PR pkg/12764), also added 2001-04-30 23:01:58 +00:00
finance Change build dependency from perl-5.* to perl>=${PERL5_REQD}. Also change 2001-04-30 04:16:08 +00:00
fonts Change build dependency from perl-5.* to perl>=${PERL5_REQD}. Also change 2001-04-30 04:16:08 +00:00
games * Unintentionally depended readline but works well with the libtermcap. 2001-05-03 00:45:56 +00:00
graphics Correct the distfile name for the Alpha 2001-05-04 12:42:45 +00:00
ham Add some missing PLIST entries. 2001-04-28 04:44:05 +00:00
japanese Don't continue DEPENDS lines with '\' Instead, insert "DEPENDS+= " in 2001-05-03 11:21:32 +00:00
lang Add sparc distfile digest and size. 2001-05-04 12:49:40 +00:00
licenses Add PalmOS SDK licenses. 2001-04-25 17:52:45 +00:00
mail Remove superfluous echoing. 2001-05-03 21:46:31 +00:00
math Add defaults for all instances of EVAL_PREFIX. 2001-05-03 22:16:50 +00:00
mbone Move to sha1 digests, and add distfile sizes. 2001-04-18 14:24:33 +00:00
meta-pkgs Update to new COMMENT style: COMMENT var in Makefile instead of pkg/COMMENT. 2001-02-17 17:52:59 +00:00
misc Add and enable p5-Business-UPS. 2001-05-03 17:33:07 +00:00
mk keep a snapshot of the bulk cache files. 2001-05-03 21:46:32 +00:00
net Fix typo in COMMENT, noted while reading the 'Changes in the NetBSD 2001-05-02 19:34:54 +00:00
news Don't disable slrnpull and spool; addresses pkg/12542. 2001-05-03 17:50:28 +00:00
packages Add .cvsignore to stop cvs update listing every distfile and more 1999-11-24 11:53:24 +00:00
parallel Move to sha1 digests, and add distfile sizes. 2001-04-18 15:22:45 +00:00
pkgtools Update pkglint to 2.50 2001-05-03 19:18:55 +00:00
print Change HOMEPAGE from sourceforge's project page to real homepage 2001-05-04 07:51:35 +00:00
security o we don't want it to depend on X, so disable X support -> don't built nifty 2001-05-02 10:14:02 +00:00
shells Use ${MASTER_SITE_BACKUP}. The original master site (and homepage) 2001-05-03 21:39:25 +00:00
sysutils Add and enable bkpupsd; sort safetynet. 2001-05-04 11:07:26 +00:00
templates Note how to report problems, or send updates or suggestions. 2001-03-19 17:44:30 +00:00
textproc Add to databases category. Some cosmetic changes also. 2001-05-03 22:23:56 +00:00
time Add libexec/cgi-bin directory to standard /usr/pkg hierarchy. Remove all 2001-05-02 22:22:42 +00:00
wm Make this package depend on gtk, should fix bulk build 2001-05-02 09:35:47 +00:00
www Add distfile size 2001-05-04 10:49:04 +00:00
x11 Add explicit dependency on MESA with USE_MESA. 2001-05-04 11:26:06 +00:00
Makefile echo -> ${ECHO} 2001-02-27 20:23:59 +00:00
Packages.txt Add entry on automated security checking 2001-05-03 21:38:29 +00:00
pkglocate Update the usage message to explain what each option letter does. 2001-04-03 09:28:32 +00:00
README No paragraph (picking nits). 2000-07-23 18:02:33 +00:00
TODO Add some of my ideas (various updates and qmail addition) 2001-05-04 12:59:30 +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.