[pkgsrc/trunk]: pkgsrc/doc doc/pkgsrc.*: regen

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/c77b7d5d903e
branches:  trunk
changeset: 434750:c77b7d5d903e
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Jun 21 13:01:00 2020 +0000

description:
doc/pkgsrc.*: regen

diffstat:

 doc/pkgsrc.html |  57 +++++++++++++++++++++++++++++++--------------------------
 doc/pkgsrc.txt  |  50 ++++++++++++++++++++++++++------------------------
 2 files changed, 57 insertions(+), 50 deletions(-)

diffs (157 lines):

diff -r 3f11ef689e26 -r c77b7d5d903e doc/pkgsrc.html
--- a/doc/pkgsrc.html   Sun Jun 21 10:41:36 2020 +0000
+++ b/doc/pkgsrc.html   Sun Jun 21 13:01:00 2020 +0000
@@ -4459,13 +4459,17 @@
     invoked by setting <code class="varname">HAS_CONFIGURE</code> to
     <span class="quote">&#8220;<span class="quote">yes</span>&#8221;</span>. If the configure script is a GNU autoconf
     script, you should set <code class="varname">GNU_CONFIGURE</code> to
-    <span class="quote">&#8220;<span class="quote">yes</span>&#8221;</span> instead. What happens in the
-    <span class="emphasis"><em>configure</em></span> phase is roughly:</p>
-<pre class="programlisting">
-.for d in ${CONFIGURE_DIRS}
-        cd ${WRKSRC} \
-        &amp;&amp; cd ${d} \
-        &amp;&amp; env ${CONFIGURE_ENV} ${CONFIGURE_SCRIPT} ${CONFIGURE_ARGS}
+    <span class="quote">&#8220;<span class="quote">yes</span>&#8221;</span> instead.</p>
+<p>In the <code class="literal">do-configure</code> stage, a rough
+    equivalent of the following command is run. See
+    <code class="filename">mk/configure/configure.mk</code>, target
+    <code class="literal">do-configure-script</code> for the exact
+    definition.</p>
+<pre class="programlisting">
+.for dir in ${CONFIGURE_DIRS}
+        cd ${WRKSRC} &amp;&amp; cd ${dir} \
+        &amp;&amp; env ${CONFIGURE_ENV} \
+            ${CONFIG_SHELL} ${CONFIGURE_SCRIPT} ${CONFIGURE_ARGS}
 .endfor
 </pre>
 <p><code class="varname">CONFIGURE_DIRS</code> (default:
@@ -4506,14 +4510,14 @@
 <div class="sect1">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="build.build"></a>13.12. The <span class="emphasis"><em>build</em></span> phase</h2></div></div></div>
-<p>For building a package, a rough equivalent of the
-    following code is executed.</p>
-<pre class="programlisting">
-.for d in ${BUILD_DIRS}
-        cd ${WRKSRC} \
-        &amp;&amp; cd ${d} \
+<p>For building a package, a rough equivalent of the following
+    code is executed; see <code class="filename">mk/build/build.mk</code>, target
+    <code class="literal">do-build</code> for the exact definition.</p>
+<pre class="programlisting">
+.for dir in ${BUILD_DIRS}
+        cd ${WRKSRC} &amp;&amp; cd ${dir} \
         &amp;&amp; env ${MAKE_ENV} \
-            ${MAKE_PROGRAM} ${BUILD_MAKE_FLAGS} \
+            ${MAKE_PROGRAM} ${MAKE_FLAGS} ${BUILD_MAKE_FLAGS} \
                 -f ${MAKE_FILE} \
                 ${BUILD_TARGET}
 .endfor
@@ -4549,18 +4553,19 @@
 <p>Once the build stage has completed, the final step is to
     install the software in public directories, so users can
     access the programs and files.</p>
-<p>In the <span class="emphasis"><em>install</em></span> phase, a rough
-    equivalent of the following code is executed. Additionally,
-    before and after this code, much magic is performed to do
-    consistency checks, registering the package, and so on.</p>
-<pre class="programlisting">
-.for d in ${INSTALL_DIRS}
-        cd ${WRKSRC} \
-        &amp;&amp; cd ${d} \
-        &amp;&amp; env ${MAKE_ENV} \
-            ${MAKE_PROGRAM} ${INSTALL_MAKE_FLAGS} \
-                -f ${MAKE_FILE} \
-                ${INSTALL_TARGET}
+<p>In the <span class="emphasis"><em>install</em></span> phase, a rough equivalent
+    of the following code is executed; see
+    <code class="filename">mk/install/install.mk</code>, target
+    <code class="literal">do-install</code> for the exact definition. Additionally,
+    before and after this code, several consistency checks are run
+    against the files-to-be-installed, see
+    <code class="filename">mk/check/*.mk</code> for details.</p>
+<pre class="programlisting">
+.for dir in ${INSTALL_DIRS}
+        cd ${WRKSRC} &amp;&amp; cd ${dir} \
+        &amp;&amp; env ${INSTALL_ENV} ${MAKE_ENV} \
+            ${MAKE_PROGRAM} ${MAKE_FLAGS} ${INSTALL_MAKE_FLAGS} \
+                -f ${MAKE_FILE} ${INSTALL_TARGET}
 .endfor
 </pre>
 <p>The variable's meanings are analogous to the ones in the
diff -r 3f11ef689e26 -r c77b7d5d903e doc/pkgsrc.txt
--- a/doc/pkgsrc.txt    Sun Jun 21 10:41:36 2020 +0000
+++ b/doc/pkgsrc.txt    Sun Jun 21 13:01:00 2020 +0000
@@ -3702,13 +3702,16 @@
 
 If the package contains a configure script, this can be invoked by setting
 HAS_CONFIGURE to "yes". If the configure script is a GNU autoconf script, you
-should set GNU_CONFIGURE to "yes" instead. What happens in the configure phase
-is roughly:
-
-.for d in ${CONFIGURE_DIRS}
-        cd ${WRKSRC} \
-        && cd ${d} \
-        && env ${CONFIGURE_ENV} ${CONFIGURE_SCRIPT} ${CONFIGURE_ARGS}
+should set GNU_CONFIGURE to "yes" instead.
+
+In the do-configure stage, a rough equivalent of the following command is run.
+See mk/configure/configure.mk, target do-configure-script for the exact
+definition.
+
+.for dir in ${CONFIGURE_DIRS}
+        cd ${WRKSRC} && cd ${dir} \
+        && env ${CONFIGURE_ENV} \
+            ${CONFIG_SHELL} ${CONFIGURE_SCRIPT} ${CONFIGURE_ARGS}
 .endfor
 
 CONFIGURE_DIRS (default: ".") is a list of pathnames relative to WRKSRC. In
@@ -3738,13 +3741,13 @@
 
 13.12. The build phase
 
-For building a package, a rough equivalent of the following code is executed.
-
-.for d in ${BUILD_DIRS}
-        cd ${WRKSRC} \
-        && cd ${d} \
+For building a package, a rough equivalent of the following code is executed;
+see mk/build/build.mk, target do-build for the exact definition.
+
+.for dir in ${BUILD_DIRS}
+        cd ${WRKSRC} && cd ${dir} \
         && env ${MAKE_ENV} \
-            ${MAKE_PROGRAM} ${BUILD_MAKE_FLAGS} \
+            ${MAKE_PROGRAM} ${MAKE_FLAGS} ${BUILD_MAKE_FLAGS} \
                 -f ${MAKE_FILE} \
                 ${BUILD_TARGET}
 .endfor
@@ -3769,17 +3772,16 @@
 Once the build stage has completed, the final step is to install the software
 in public directories, so users can access the programs and files.
 
-In the install phase, a rough equivalent of the following code is executed.
-Additionally, before and after this code, much magic is performed to do
-consistency checks, registering the package, and so on.
-
-.for d in ${INSTALL_DIRS}
-        cd ${WRKSRC} \
-        && cd ${d} \
-        && env ${MAKE_ENV} \
-            ${MAKE_PROGRAM} ${INSTALL_MAKE_FLAGS} \
-                -f ${MAKE_FILE} \
-                ${INSTALL_TARGET}
+In the install phase, a rough equivalent of the following code is executed; see
+mk/install/install.mk, target do-install for the exact definition.
+Additionally, before and after this code, several consistency checks are run
+against the files-to-be-installed, see mk/check/*.mk for details.
+
+.for dir in ${INSTALL_DIRS}
+        cd ${WRKSRC} && cd ${dir} \
+        && env ${INSTALL_ENV} ${MAKE_ENV} \
+            ${MAKE_PROGRAM} ${MAKE_FLAGS} ${INSTALL_MAKE_FLAGS} \
+                -f ${MAKE_FILE} ${INSTALL_TARGET}
 .endfor
 
 The variable's meanings are analogous to the ones in the build phase.