From d1833aa5fe9ca83e0bf4cf179797c9969df2b232 Mon Sep 17 00:00:00 2001
From: espie <espie@openbsd.org>
Date: Wed, 18 May 2022 10:04:47 +0000
Subject: [PATCH] document what PLIST_REPOSITORY does a bit better

---
 share/man/man5/bsd.port.mk.5 | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5
index 07787f80732..a5066f71286 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.562 2022/05/17 15:18:43 espie Exp $
+.\" $OpenBSD: bsd.port.mk.5,v 1.563 2022/05/18 10:04:47 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: May 17 2022 $
+.Dd $Mdocdate: May 18 2022 $
 .Dt BSD.PORT.MK 5
 .Os
 .Sh NAME
@@ -492,6 +492,14 @@ If the repository already contains up-to-date packages, they are not rebuilt.
 If PLIST_REPOSITORY is set, the resulting packaging information is compared
 with existing stuff, and saved if new, with loud complaints if it changed
 without a REVISION bump.
+.Pp
+Also note that
+.Pa ${PLIST_REPOSITORY}/${MACHINE_ARCH}/history
+contains LRU caches for all files
+.Po
+see
+.Xr package 5
+.Pc .
 Arch-independent packages are created in ${PACKAGE_REPOSITORY}/no-arch,
 and copied into ${PACKAGE_REPOSITORY}/${MACHINE_ARCH}/all as needed.
 If ${PERMIT_PACKAGE} is set to
@@ -3700,7 +3708,9 @@ at the end of
 Variables from
 .Ev SUBST_VARS
 will be expanded.
-.It Pa ${PORTSDIR}/packages/${MACHINE_ARCH}
+.It Pa ${PORTSDIR}/plist
+Default setup of ${PLIST_REPOSITORY}.
+.It Pa ${PORTSDIR}/packages
 Default setup of ${PACKAGE_REPOSITORY}.
 .It Pa ${PACKAGE_REPOSITORY}/no-arch
 Location of arch-independent packages.
-- 
2.20.1