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

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/3021caa76040
branches:  trunk
changeset: 344556:3021caa76040
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Fri Nov 22 19:56:26 2019 +0000

description:
doc/pkgsrc.*: regen

diffstat:

 doc/pkgsrc.html |  44 ++++++++++++++++++++++++++++++++++----------
 doc/pkgsrc.txt  |  12 ++++++++++++
 2 files changed, 46 insertions(+), 10 deletions(-)

diffs (160 lines):

diff -r 16a2d88f82ab -r 3021caa76040 doc/pkgsrc.html
--- a/doc/pkgsrc.html   Fri Nov 22 19:48:58 2019 +0000
+++ b/doc/pkgsrc.html   Fri Nov 22 19:56:26 2019 +0000
@@ -919,6 +919,18 @@
 <p>The available help topics are listed in <a class="xref" href="#help-topics" title="Appendix D. Help topics">Appendix D, <i>Help topics</i></a>.</p>
 </li>
 <li class="listitem"><p>
+       To see the value of a single variable, run <span class="command"><strong>bmake
+       show-var VARNAME=<em class="replaceable"><code>X</code></em></strong></span>.
+</p></li>
+<li class="listitem"><p>
+       To see the values of the most common variables, run
+       <span class="command"><strong>bmake show-all</strong></span>. These variables are grouped by
+       topic. To see the variables for a single topic, run
+       <span class="command"><strong>bmake
+       show-all-<em class="replaceable"><code>topic</code></em></strong></span>, for example
+       <span class="command"><strong>bmake show-all-fetch</strong></span>.
+</p></li>
+<li class="listitem"><p>
        The pkgsrc-users mailing list, to which
        <a class="ulink" href="https://www.NetBSD.org/mailinglists/#pkgsrc-users"; target="_top">you
        can subscribe</a> and then <a class="ulink" href="mailto:pkgsrc-users%NetBSD.org@localhost"; target="_top">ask your
@@ -3041,6 +3053,18 @@
 <p>The available help topics are listed in <a class="xref" href="#help-topics" title="Appendix D. Help topics">Appendix D, <i>Help topics</i></a>.</p>
 </li>
 <li class="listitem"><p>
+       To see the value of a single variable, run <span class="command"><strong>bmake
+       show-var VARNAME=<em class="replaceable"><code>X</code></em></strong></span>.
+</p></li>
+<li class="listitem"><p>
+       To see the values of the most common variables, run
+       <span class="command"><strong>bmake show-all</strong></span>. These variables are grouped by
+       topic. To see the variables for a single topic, run
+       <span class="command"><strong>bmake
+       show-all-<em class="replaceable"><code>topic</code></em></strong></span>, for example
+       <span class="command"><strong>bmake show-all-fetch</strong></span>.
+</p></li>
+<li class="listitem"><p>
        The tech-pkg mailing list, to which
        <a class="ulink" href="https://www.NetBSD.org/mailinglists/#tech-pkg"; target="_top">you
        can subscribe</a> and then <a class="ulink" href="mailto:tech-pkg%NetBSD.org@localhost"; target="_top">ask your
@@ -9000,7 +9024,7 @@
        and if you still don't have the answer, ask on the
        <code class="literal">pkgsrc-users</code> mailing list.</p>
 <div class="qandaset">
-<a name="idm79055728"></a><dl>
+<a name="idm79147248"></a><dl>
 <dt>24.1. <a href="#devfaq.makeflags">What is the difference between
        MAKEFLAGS, .MAKEFLAGS and
        MAKE_FLAGS?</a>
@@ -9045,7 +9069,7 @@
 <tbody>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.makeflags"></a><a name="idm79055344"></a><p><b>24.1.</b></p>
+<a name="devfaq.makeflags"></a><a name="idm79146864"></a><p><b>24.1.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
@@ -9061,7 +9085,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.make"></a><a name="idm79051248"></a><p><b>24.2.</b></p>
+<a name="devfaq.make"></a><a name="idm79142768"></a><p><b>24.2.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
@@ -9079,7 +9103,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.cc"></a><a name="idm79046896"></a><p><b>24.3.</b></p>
+<a name="devfaq.cc"></a><a name="idm79138416"></a><p><b>24.3.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
@@ -9097,7 +9121,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3flags"></a><a name="idm79042672"></a><p><b>24.4.</b></p>
+<a name="devfaq.bl3flags"></a><a name="idm79134192"></a><p><b>24.4.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
        <code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -9110,7 +9134,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3prefix"></a><a name="idm79040496"></a><p><b>24.5.</b></p>
+<a name="devfaq.bl3prefix"></a><a name="idm79132016"></a><p><b>24.5.</b></p>
 </td>
 <td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
        VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
@@ -9126,7 +9150,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.master_sites"></a><a name="idm79037296"></a><p><b>24.6.</b></p>
+<a name="devfaq.master_sites"></a><a name="idm79128944"></a><p><b>24.6.</b></p>
 </td>
 <td align="left" valign="top"><p>What does
        <code class="code">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -9150,7 +9174,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.mailinglists"></a><a name="idm79030512"></a><p><b>24.7.</b></p>
+<a name="devfaq.mailinglists"></a><a name="idm79122032"></a><p><b>24.7.</b></p>
 </td>
 <td align="left" valign="top"><p>Which mailing lists are there for package
        developers?</p></td>
@@ -9175,7 +9199,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.documentation"></a><a name="idm79026672"></a><p><b>24.8.</b></p>
+<a name="devfaq.documentation"></a><a name="idm79110000"></a><p><b>24.8.</b></p>
 </td>
 <td align="left" valign="top"><p>Where is the pkgsrc
        documentation?</p></td>
@@ -9223,7 +9247,7 @@
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.too-much-time"></a><a name="idm79020144"></a><p><b>24.9.</b></p>
+<a name="devfaq.too-much-time"></a><a name="idm79103472"></a><p><b>24.9.</b></p>
 </td>
 <td align="left" valign="top"><p>I have a little time to kill.  What shall I
 do?</p></td>
diff -r 16a2d88f82ab -r 3021caa76040 doc/pkgsrc.txt
--- a/doc/pkgsrc.txt    Fri Nov 22 19:48:58 2019 +0000
+++ b/doc/pkgsrc.txt    Fri Nov 22 19:56:26 2019 +0000
@@ -789,6 +789,12 @@
 
     The available help topics are listed in Appendix D, Help topics.
 
+  * To see the value of a single variable, run bmake show-var VARNAME=X.
+
+  * To see the values of the most common variables, run bmake show-all. These
+    variables are grouped by topic. To see the variables for a single topic,
+    run bmake show-all-topic, for example bmake show-all-fetch.
+
   * The pkgsrc-users mailing list, to which you can subscribe and then ask your
     questions.
 
@@ -2609,6 +2615,12 @@
 
     The available help topics are listed in Appendix D, Help topics.
 
+  * To see the value of a single variable, run bmake show-var VARNAME=X.
+
+  * To see the values of the most common variables, run bmake show-all. These
+    variables are grouped by topic. To see the variables for a single topic,
+    run bmake show-all-topic, for example bmake show-all-fetch.
+
   * The tech-pkg mailing list, to which you can subscribe and then ask your
     questions.