Received: by mail.netbsd.org (Postfix, from userid 605)
	id E7B8F84ED8; Mon, 25 Jul 2022 05:42:23 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by mail.netbsd.org (Postfix) with ESMTP id 2CD5E84EB6
	for <pkgsrc-changes@NetBSD.org>; Mon, 25 Jul 2022 05:42:23 +0000 (UTC)
X-Virus-Scanned: amavisd-new at netbsd.org
Received: from mail.netbsd.org ([127.0.0.1])
	by localhost (mail.netbsd.org [127.0.0.1]) (amavisd-new, port 10025)
	with ESMTP id 0S81IADJaMYO for <pkgsrc-changes@netbsd.org>;
	Mon, 25 Jul 2022 05:42:22 +0000 (UTC)
Received: from cvs.NetBSD.org (ivanova.NetBSD.org [IPv6:2001:470:a085:999:28c:faff:fe03:5984])
	by mail.netbsd.org (Postfix) with ESMTP id 974FC84CEC
	for <pkgsrc-changes@NetBSD.org>; Mon, 25 Jul 2022 05:42:22 +0000 (UTC)
Received: by cvs.NetBSD.org (Postfix, from userid 500)
	id 8B354FB1A; Mon, 25 Jul 2022 05:42:22 +0000 (UTC)
Content-Transfer-Encoding: 7bit
Content-Type: multipart/mixed; boundary="_----------=_1658727742190440"
MIME-Version: 1.0
Date: Mon, 25 Jul 2022 05:42:22 +0000
From: "Roland Illig" <rillig@netbsd.org>
Subject: CVS commit: pkgsrc/doc/guide/files
To: pkgsrc-changes@NetBSD.org
Reply-To: rillig@netbsd.org
X-Mailer: log_accum
Message-Id: <20220725054222.8B354FB1A@cvs.NetBSD.org>
Sender: pkgsrc-changes-owner@NetBSD.org
List-Id: <pkgsrc-changes.NetBSD.org>
Precedence: bulk
List-Unsubscribe: <mailto:majordomo@NetBSD.org?subject=Unsubscribe%20pkgsrc-changes&body=unsubscribe%20pkgsrc-changes>

This is a multi-part message in MIME format.

--_----------=_1658727742190440
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="US-ASCII"

Module Name:	pkgsrc
Committed By:	rillig
Date:		Mon Jul 25 05:42:22 UTC 2022

Modified Files:
	pkgsrc/doc/guide/files: build.xml

Log Message:
doc/guide: document how PKGPATH is typically used


To generate a diff of this commit:
cvs rdiff -u -r1.87 -r1.88 pkgsrc/doc/guide/files/build.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.


--_----------=_1658727742190440
Content-Disposition: inline
Content-Length: 2447
Content-Transfer-Encoding: binary
Content-Type: text/x-diff; charset=us-ascii

Modified files:

Index: pkgsrc/doc/guide/files/build.xml
diff -u pkgsrc/doc/guide/files/build.xml:1.87 pkgsrc/doc/guide/files/build.xml:1.88
--- pkgsrc/doc/guide/files/build.xml:1.87	Sat May 21 11:42:29 2022
+++ pkgsrc/doc/guide/files/build.xml	Mon Jul 25 05:42:22 2022
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.87 2022/05/21 11:42:29 nia Exp $ -->
+<!-- $NetBSD: build.xml,v 1.88 2022/07/25 05:42:22 rillig Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -122,8 +122,19 @@
 
       <varlistentry><term><varname>PKGPATH</varname></term>
       <listitem><para>This is a pathname relative to
-      <varname>PKGSRCDIR</varname> that points to the current
-      package.</para></listitem></varlistentry>
+      <varname>PKGSRCDIR</varname> that points to the current package.
+      It is defined after including <filename>bsd.prefs.mk</filename>
+      and can be used in makefile fragments that are used by several
+      packages to distinguish between these packages. Other variables
+      that would serve the same purpose are <varname>PKGBASE</varname>
+      and <varname>PKGNAME</varname>, but these are only defined after
+      including <filename>bsd.pkg.mk</filename>, which is too
+      late.</para>
+
+      <para>In &mk.conf;, the pkgsrc user can use
+      <varname>PKGPATH</varname> to tweak variables like
+      <varname>MAKE_JOBS</varname> and
+      <varname>CFLAGS</varname>.</para></listitem></varlistentry>
 
       <varlistentry><term><varname>WRKDIR</varname></term>
       <listitem><para>This is an absolute pathname pointing to the directory
@@ -155,10 +166,11 @@
     <title>Running a phase</title>
 
     <para>You can run a particular phase by typing <command>make
-    phase</command>, where <emphasis>phase</emphasis> is the name of the
-    phase. This will automatically run all phases that are required for this
-    phase. The default phase is <varname>build</varname>, that is, when you
-    run <command>make</command> without parameters in a package directory,
+    <replaceable>phase</replaceable></command>, where
+    <replaceable>phase</replaceable> is the name of the phase. This will
+    automatically run all phases that are required for this phase. The
+    default phase is <varname>build</varname>, that is, when you run
+    <command>make</command> without parameters in a package directory,
     the package will be built, but not installed.</para>
 
   </sect1>


--_----------=_1658727742190440--