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

1 files changed, 29 insertions, 0 deletions

diff --git a/CHANGES b/CHANGES
index e634fd1c59a4..a67657b97e68 100644
--- a/CHANGES
+++ b/CHANGES
@@ -10,6 +10,35 @@ in the release notes and/or placed into UPDATING.
 
 All ports committers are allowed to commit to this file.
 
+20130923:
+AUTHOT: bapt@FreeBSD.org
+
+  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.
+
 20130920:
 AUTHOR: bdrewery@FreeBSD.org