1
0
mirror of https://git.FreeBSD.org/ports.git synced 2024-11-28 01:06:17 +00:00
Mirror of the FreeBSD ports git repo https://git.FreeBSD.org/ports.git .
Go to file
Baptiste Daroussin cf099c77fa Add support for staging area in the ports tree
The ports tree is now staged by default. With pkgng the sequence hasn't
changed, the main difference is that creating package is now independent
from installing it. With pkg_install, the package is now created first
and make install, do install the package.

New macros:
- STAGEDIR: PATH to the directory where the port will be staged.
- NO_STAGE: Keep the old behaviour of the ports tree (aka no staging area)

Unsupported macro if NO_STAGE is not set:
- MAN* with staging man page compression and handling of hardlinks and
symlinks is automatically done in the stage. the manpages becomes then a
"normal" plist files and should be tracked in pkg-plist.
- MANCOMPRESSED the compress-man target is able to only compress when it
needed.

New target:
- stage: this installs everything into the stage directory
- makeplist: this will create a pkg-plist and print it to stdout. This is
a sample plist and it should always be _reviewed_ not directly used.

NOTE: with staging only what is in the plist will be installed, nothing more,
meaning a port staged cannot have leftovers exect directories left. It is
really important to double check the pkg-plist to make sure all the files
the maintainer want to package are in! make makeplist can help in that area.

The goal is to handle as quickly as possible a full removal of the NO_STAGE
support.

More features can be added once the full ports tree is converted to using the
staging area

Conversion notes:
- Remove NO_STAGE
- in {pre,do,post}-install
  * Before any usage of ${PREFIX}, ${ETCDIR}, ${PORTSDIR}, ${PORTEXAMPLES}
    prepend ${STAGEDIR}
  * Remove any thing that is done by @exec or +INSTALL script it will be
    done automatically when syncing packages
  * Remove any code to show PKG-MESSAGE it will be done automatically when
    syncing packages
  * Directory creation should remain in post-install (in particular because
    pkgng doesn't work like pkg_install in that area and pkgng ignores the
    @exec mkdir but directly pack the directory even if empty)
- PORTDOCS/PORTEXAMPELS
  To support PORTDOCS, PORTEXAMPLES most of the time there is no more need
  for hacks. just add the right %%PORTDOCS%% or %%PORTEXAMPLES%% in your
  plist then the given files from the stagedir will or will not sync
  according to NOPORTDOCS and NOPORTEXAMPLES.

With hat:	portmgr
Reviewed by:	bdrewery
2013-09-23 05:56:35 +00:00
accessibility Fix header conversion 2013-09-20 22:52:20 +00:00
arabic Add NO_STAGE all over the place in accessibility in preparation for the staging support 2013-09-20 11:04:48 +00:00
archivers - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
astro Add NO_STAGE all over the place in preparation for the staging support (cat: astro) 2013-09-20 13:14:04 +00:00
audio - Update to 3.1.1 2013-09-22 20:42:04 +00:00
benchmarks Add NO_STAGE all over the place in preparation for the staging support (cat: benchmarks) 2013-09-20 15:52:44 +00:00
biology Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
cad Add NO_STAGE all over the place in preparation for the staging support (cat: cad) 2013-09-20 15:58:41 +00:00
chinese - Update to 11.1 2013-09-21 15:42:24 +00:00
comms - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
converters Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
databases Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
deskutils Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
devel - Add p5-Term-ReadLine-Perl 1.0303 2013-09-22 20:00:07 +00:00
dns - Update to 1.4.21 2013-09-23 02:39:57 +00:00
editors - Update MASTER_SITES 2013-09-22 09:35:42 +00:00
emulators Give back to the pool upon maintainer's request. 2013-09-22 14:35:31 +00:00
finance Update to version 4.5.3 2013-09-22 14:12:58 +00:00
french Add NO_STAGE all over the place in preparation for the staging support (cat: french) 2013-09-20 17:21:20 +00:00
ftp - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
games Update to the latest version of pcgen. 2013-09-22 22:16:22 +00:00
german Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
graphics - Update to 1.2-3 2013-09-23 05:14:17 +00:00
hebrew Add NO_STAGE all over the place in preparation for the staging support (cat: hebrew) 2013-09-20 18:41:52 +00:00
hungarian Add NO_STAGE all over the place in preparation for the staging support (cat: hungarian) 2013-09-20 18:43:02 +00:00
irc - Update to 20130921 (0.4.2-rc2) 2013-09-22 11:55:30 +00:00
japanese Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
java . Make set_native_priority return a (correct) value on FreeBSD, rather than 2013-09-22 00:39:22 +00:00
Keywords Fix info files with pkgng. 2013-03-14 10:11:19 +00:00
korean Add NO_STAGE all over the place in preparation for the staging support (cat: korean) 2013-09-20 19:49:59 +00:00
lang - Work around failing detection of dlopen() 2013-09-23 04:49:58 +00:00
mail Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
math - Update to 0.96-7 2013-09-23 05:17:38 +00:00
misc Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
Mk Add support for staging area in the ports tree 2013-09-23 05:56:35 +00:00
multimedia Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
net Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
net-im Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
net-mgmt Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
net-p2p - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
news Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
palm Add NO_STAGE all over the place in preparation for the staging support (cat: palm) 2013-09-20 22:33:41 +00:00
polish Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
ports-mgmt - Update to checkin 6a4cc74775 2013-09-22 23:21:20 +00:00
portuguese Add NO_STAGE all over the place in preparation for the staging support (cat: portuguese) 2013-09-20 22:38:31 +00:00
print Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
russian - Add p5-Text-Hyphen-RU 2013-09-22 17:59:41 +00:00
science Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
security Drop maintainership 2013-09-22 20:39:51 +00:00
shells Add NO_STAGE all over the place in preparation for the staging support (cat: shells) 2013-09-20 22:57:23 +00:00
sysutils - Update to 20130922 2013-09-22 20:01:12 +00:00
Templates - login(3), logout(3), and logwtmp(3) were removed in base r202216 2013-09-03 11:39:21 +00:00
textproc Update to version 1.8.1 2013-09-22 18:41:59 +00:00
Tools Remove Tools/scripts/convert-makefile-header.pl it is not needed anymore 2013-09-21 00:06:29 +00:00
ukrainian Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
vietnamese Add NO_STAGE all over the place in preparation for the staging support (cat: vietnamese) 2013-09-20 23:20:31 +00:00
www Add several of new ports, required for Plone 4.3.2 2013-09-22 22:21:57 +00:00
x11 Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
x11-clocks - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
x11-drivers Add NO_STAGE all over the place in preparation for the staging support (cat: x11-drivers) 2013-09-20 23:48:39 +00:00
x11-fm Add NO_STAGE all over the place in preparation for the staging support (cat: x11-fm) 2013-09-20 23:49:39 +00:00
x11-fonts - fix misplaced NO_STAGE in slaveports and ifdefs 2013-09-21 11:06:03 +00:00
x11-servers Add NO_STAGE all over the place in preparation for the staging support (cat: x11-servers) 2013-09-20 23:52:24 +00:00
x11-themes Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
x11-toolkits Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
x11-wm Fix NO_STAGE attribution 2013-09-22 18:05:04 +00:00
CHANGES Add support for staging area in the ports tree 2013-09-23 05:56:35 +00:00
COPYRIGHT
GIDs Preparing for www/radicale import 2013-09-12 13:49:24 +00:00
KNOBS Arts was removed: 2013-08-28 18:29:38 +00:00
LEGAL Remove expired ports: 2013-08-27 18:57:00 +00:00
Makefile - Remove CVS reference 2013-05-20 00:45:26 +00:00
MOVED - fix typo in portname 2013-09-22 10:42:21 +00:00
README
UIDs Preparing for www/radicale import 2013-09-12 13:49:24 +00:00
UPDATING - Rename public name of SSP support to WITH_SSP_PORTS as /usr/src 2013-09-22 00:26:05 +00:00

This is the FreeBSD Ports Collection.  For an easy to use
WEB-based interface to it, please see:

	http://www.FreeBSD.org/ports

For general information on the Ports Collection, please see the
FreeBSD Handbook ports section which is available from:

	http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/ports.html
		for the latest official version
	or:
	The ports(7) manual page (man ports).

These will explain how to use ports and packages.

If you would like to search for a port, you can do so easily by
saying (in /usr/ports):


	make search name="<name>"
	or:
	make search key="<keyword>"

which will generate a list of all ports matching <name> or <keyword>.
make search also supports wildcards, such as:

	make search name="gtk*"

For information about contributing to FreeBSD ports, please see the Porter's
Handbook, available at:

	http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/porters-handbook/

NOTE:  This tree will GROW significantly in size during normal usage!
The distribution tar files can and do accumulate in /usr/ports/distfiles,
and the individual ports will also use up lots of space in their work
subdirectories unless you remember to "make clean" after you're done
building a given port.  /usr/ports/distfiles can also be periodically
cleaned without ill-effect.