document EPOCH/REVISION

1 files changed, 38 insertions, 2 deletions

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 5680b5a24b0..560ecd88a58 100644
--- a/share/man/man5/bsd.port.mk.5
+++ b/share/man/man5/bsd.port.mk.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: bsd.port.mk.5,v 1.252 2010/07/06 16:22:25 jmc Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.253 2010/07/10 09:12:02 espie Exp $
 .\"
 .\" Copyright (c) 2000-2008 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 6 2010 $
+.Dd $Mdocdate: July 10 2010 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -473,6 +473,10 @@ the package contents only consists of files, all tagged with category
 markers such as @file.
 See
 .Xr pkg_create 1 .
+.It Ar print-plist-libs
+Generate and print the list of static and dynamic libraries present in the port.
+See
+.Xr pkg_create 1 .
 .It Ar print-plist-with-depends
 Like
 .Ar print-plist ,
@@ -1045,6 +1049,16 @@ to see
 .Ev REORDER_DEPENDENCIES
 actions.
 Silent by default.
+.It Ev EPOCH
+Epoch number of the current package.
+Defaults to empty (no need for numbering changes).
+numbering starts at 0.
+Gets automatically incorporated into
+.Ev FULLPKGNAME
+as
+.Sq v${EPOCH}
+to form a full package-name conforming to
+.Xr packages-specs 5 .
 .It Ev ERRORS
 List of errors found while parsing the port's Makefile.
 Display the errors before making any target, and if any error starts with
@@ -1177,6 +1191,10 @@ Read-only.
 .It Ev FULLPKGNAME
 Full name of the created package, taking flavors into account.
 Defaults to ${PKGNAME}${FLAVOR_EXT}.
+See also
+.It Ev EPOCH
+and
+.It Ev REVISION .
 .It Ev FULLPKGPATH
 Path to the current port's directory, relative to ${PORTSDIR},
 including flavors and subpackages.
@@ -1614,6 +1632,12 @@ This does not take flavors into account.
 See
 .Ev FULLPKGNAME
 for that.
+Specific revisions and epoch changes should be
+handled by
+.Ev REVISION
+and
+.Ev EPOCH
+instead.
 .It Ev PKGNAMES
 Read-only.
 List of all package names generated by the port, with
@@ -1727,6 +1751,16 @@ See
 .It Ev REPORT_PROBLEM_LOGFILE
 See
 .Xr ports 7 .
+.It Ev REVISION
+Revision number of the current package.
+Defaults to empty (very first package), then
+numbering starts at 0.
+Gets automatically incorporated into
+.Ev FULLPKGNAME
+as
+.Sq p${REVISION}
+to form a full package-name conforming to
+.Xr packages-specs 5 .
 .It Ev RUN_DEPENDS
 Specification of ports this port needs installed to be functional.
 Same format as BUILD_DEPENDS.
@@ -2637,6 +2671,8 @@ The following variables are subpackage dependent:
 .Ev PERMIT_PACKAGE_CDROM ,
 .Ev PKGNAME ,
 .Ev FULLPKGNAME ,
+.Ev REVISION ,
+.Ev EPOCH ,
 .Ev FULLPKGPATH ,
 .Ev RUN_DEPENDS ,
 .Ev WANTLIB ,