Automatic conversion of the NetBSD pkgsrc CVS module, use with care
Find a file
agc cb0e38446b Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to
generalise the linker flags used to export symbols by setting them on
a per-OS basis.

> many packages force -Wl,-export-dynamic which is not portable outside GNU ld
> and cause problems e.g. on Solaris.  some of these packages use if
> conditionals either only for NetBSD or except SunOS, but the state is not
> coherent and it may complicate later when support for new OS is added to
> pkgsrc (e.g. ongoing work on HP-UX support).
>
> jlam proposed the following framework in discussion on tech-pkg:
>
>   http://mail-index.netbsd.org/tech-pkg/2002/06/21/0009.html
>
> now, ${EXPORT_SYMBOLS_LDFLAGS} is used instead of directly defining
> -Wl,-export-dynamic which is set in appropriate defs.*.mk to reasonable
> values.  packages should be converted to this framework by:
>
> 1) replacing LDFLAGS+= -Wl,-export-dynamic and LIBS+= -export-dynamic with:
>
>    LDFLAGS+= ${EXPORT_SYMBOLS_LDFLAGS}
>
> 2) for use in patchfiles, add this variable to MAKE_ENV if needed:
>
>    MAKE_ENV+= EXPORT_SYMBOLS_LDFLAGS=${EXPORT_SYMBOLS_LDFLAGS}
>
> 3) replace occurances of -Wl,-export-dynamic and -export-dynamic in patch
>    files with:
>
>    $(EXPORT_SYMBOLS_LDFLAGS)
2002-09-04 14:47:32 +00:00
archivers Unused. 2002-08-31 15:25:51 +00:00
audio Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to 2002-09-04 14:47:32 +00:00
benchmarks Cosmetic nit: don't use -DFreeBSD - this is NetBSD! 2002-08-21 06:36:35 +00:00
biology Small pkglint white-space complaint. 2002-06-07 11:34:40 +00:00
cad update to verilog-current-20020828 2002-08-29 11:15:56 +00:00
chat Update epic4 to 1.1.6, including native IPv6 support. 2002-09-01 16:34:42 +00:00
comms Updated hylafax to 4.1nb4: 2002-08-28 20:59:38 +00:00
converters Rejoin NetBSD and Solaris package lists which fixes package list problems 2002-09-01 20:24:17 +00:00
cross Sync with PEACE repositry 2002-08-21 12:42:44 +00:00
databases Update to 7.2.2 for security reasons. Only a security fix since 7.2.1 2002-09-01 01:14:29 +00:00
devel Backout last change because Solaris' "curses" library has I18N issues as 2002-09-02 20:35:09 +00:00
distfiles These files belong to $MASTER_SITE_LOCAL - moved them there! 2000-12-05 00:23:05 +00:00
editors Update tamago package to 4.0.6nb1. 2002-09-04 14:42:41 +00:00
emulators Update to 20020901. 2002-09-01 15:13:52 +00:00
finance Updated to 1.6.8 2002-08-23 11:52:51 +00:00
fonts Add a couple of MASTER_SITES that work -> comment out BROKEN due to 2002-09-01 16:17:06 +00:00
games regen (removing patch-al -- forgotten cvs add?) 2002-09-01 23:24:13 +00:00
graphics Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to 2002-09-04 14:47:32 +00:00
ham Add RCS Id. 2002-07-02 12:53:10 +00:00
inputmethod Merge changes in packages from the buildlink2 branch that have 2002-08-25 19:21:43 +00:00
lang pass the MAKE_ENV to distutils builds 2002-09-04 14:28:37 +00:00
licenses Add TRPlayer license, in support of soon-to-be-imported TRPlayer package. 2002-08-31 19:51:17 +00:00
mail Remove work arround for bug in buildlink2 framework which was fixed 2002-09-04 12:48:36 +00:00
math Remove debugging lines that shouldn't have been committed. 2002-08-29 17:15:15 +00:00
mbone Make this package build on NetBSD-1.6 and later 2002-08-16 16:55:59 +00:00
meta-pkgs Make last change less intrusive: build "gnumeric" version 1.0.0 or newer 2002-08-12 19:00:36 +00:00
misc Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to 2002-09-04 14:47:32 +00:00
mk Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to 2002-09-04 14:47:32 +00:00
net Update ruby-drb package to 1.3.7. 2002-09-04 12:59:13 +00:00
news @@PREFIX@@ -> @PREFIX@, as this is more consistent with other 2002-08-27 15:27:03 +00:00
packages Add .cvsignore to stop cvs update listing every distfile and more 1999-11-24 11:53:24 +00:00
parallel Add and enable linda. 2002-08-20 16:45:15 +00:00
pkgtools Revert last change after buildlink2 problem was fixed by Johnny C. Lam. 2002-09-04 12:53:02 +00:00
print add Verilog-A definitions 2002-08-27 03:00:12 +00:00
security Fix whitespace in PLIST. Closes pkg/18137 by Katsuhiko Fujii. 2002-09-01 08:06:15 +00:00
shells Merge packages from the buildlink2 branch back into the main trunk that 2002-08-25 21:50:52 +00:00
sysutils Update to 0.11.33: 2002-09-02 16:56:57 +00:00
templates Fix the location of DESCR for the readme files 2001-11-03 03:26:08 +00:00
textproc Update namazu package to 2.0.12. 2002-09-04 12:52:24 +00:00
time Use buildlink2. 2002-09-01 18:58:52 +00:00
wm Convert to buildlink2. 2002-08-31 16:07:28 +00:00
www Apply patches from Lubomir Sedlacik <salo@Xtrmntr.org> in PR 18115 to 2002-09-04 14:47:32 +00:00
x11 Revert last change after buildlink2 problem was fixed by Johnny C. Lam. 2002-09-04 12:53:02 +00:00
Makefile Retire japanese category. 2002-05-31 15:26:50 +00:00
Packages.txt PKG_SYSCONFDIR is not supposed to be settable, so change its setting from 2002-08-26 05:17:39 +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 sentence which used to talk about mk.conf.example to explain the 2001-12-03 21:33:56 +00:00
TODO Add one more TODO item -- a version of the graphics/gd package which does 2002-05-20 22:07:09 +00:00

$NetBSD: README,v 1.13 2001/12/03 21:33:56 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 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/bsd.pkg.defaults.mk gives
the defaults which are used in pkgsrc.  This file can be used as a
guide to set values in /etc/mk.conf - it is only necessary to set
values where they differ from the defaults.

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.