From: espie <espie@openbsd.org>
Date: Tue, 4 Sep 2018 13:57:46 +0000 (+0000)
Subject: document PKGSTEM changes
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=c432c96feaefbb4666aafde2aba05962ea795194;p=openbsd

document PKGSTEM changes
---

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 901775bc59e..977b65b7156 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.494 2018/08/04 09:01:56 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.495 2018/09/04 13:57:46 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: August 4 2018 $
+.Dd $Mdocdate: September 4 2018 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -2482,6 +2482,13 @@ derived from the
 Do not override without very good reasons,
 namely software that coexist as different incompatible versions with the
 same stem, e.g., already a mess.
+.It Ev PKGSTEM
+Base for the package name without any version number.
+Used in
+.Pa READMEs
+file names and actual contents, can be overridden for ports
+with branches, like php, e.g.,
+.Li PKGSTEM-main = php-5.6
 .It Ev PLIST_DB
 Deprecated, see
 .Ev PLIST_REPOSITORY .
@@ -2829,6 +2836,7 @@ Always holds
 .Ev MACHINE_ARCH ,
 .Ev MAINTAINER ,
 .Ev PREFIX ,
+.Ev PKGSTEM ,
 .Ev RCDIR ,
 .Ev SYSCONFDIR ,
 .Ev TRUEPREFIX ,
@@ -3386,7 +3394,7 @@ Multi-package ports will use DESCR${SUBPACKAGE}.
 .It Pa ${PKGDIR}/README
 .Ox
 specific documentation for a port, that will be installed as
-.Pa ${LOCALBASE}/share/doc/pkg-readmes/${FULLPKGNAME}
+.Pa ${LOCALBASE}/share/doc/pkg-readmes/${PKGSTEM}
 at the end of
 .Cm fake .
 Variables from
@@ -3614,6 +3622,7 @@ The following variables are subpackage dependent:
 .Ev PERMIT_PACKAGE_CDROM ,
 .Ev PKGFILE ,
 .Ev PKGNAME ,
+.Ev PKGSTEM ,
 .Ev FULLPKGNAME ,
 .Ev REVISION ,
 .Ev EPOCH ,