CVS commit: pkgsrc/doc/guide/files

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Fri Nov 22 19:48:58 UTC 2019

Modified Files:
        pkgsrc/doc/guide/files: help-devel.xml help-user.xml

Log Message:
doc/guide: document the show-all target in the help sections


To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 pkgsrc/doc/guide/files/help-devel.xml \
    pkgsrc/doc/guide/files/help-user.xml

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

Modified files:

Index: pkgsrc/doc/guide/files/help-devel.xml
diff -u pkgsrc/doc/guide/files/help-devel.xml:1.2 pkgsrc/doc/guide/files/help-devel.xml:1.3
--- pkgsrc/doc/guide/files/help-devel.xml:1.2   Sun Apr 28 15:22:24 2019
+++ pkgsrc/doc/guide/files/help-devel.xml       Fri Nov 22 19:48:58 2019
@@ -1,4 +1,4 @@
-<!-- $NetBSD: help-devel.xml,v 1.2 2019/04/28 15:22:24 rillig Exp $ -->
+<!-- $NetBSD: help-devel.xml,v 1.3 2019/11/22 19:48:58 rillig Exp $ -->
 
 <chapter id="help-devel">
 <title>Getting help</title>
@@ -23,6 +23,20 @@
 </listitem>
 
 <listitem><para>
+       To see the value of a single variable, run <command>bmake
+       show-var VARNAME=<replaceable>X</replaceable></command>.
+</para></listitem>
+
+<listitem><para>
+       To see the values of the most common variables, run
+       <command>bmake show-all</command>. These variables are grouped by
+       topic. To see the variables for a single topic, run
+       <command>bmake
+       show-all-<replaceable>topic</replaceable></command>, for example
+       <command>bmake show-all-fetch</command>.
+</para></listitem>
+
+<listitem><para>
        The tech-pkg mailing list, to which
        <ulink url="https://www.NetBSD.org/mailinglists/#tech-pkg";>you
        can subscribe</ulink> and then <ulink
Index: pkgsrc/doc/guide/files/help-user.xml
diff -u pkgsrc/doc/guide/files/help-user.xml:1.2 pkgsrc/doc/guide/files/help-user.xml:1.3
--- pkgsrc/doc/guide/files/help-user.xml:1.2    Sun Apr 28 15:22:24 2019
+++ pkgsrc/doc/guide/files/help-user.xml        Fri Nov 22 19:48:58 2019
@@ -1,4 +1,4 @@
-<!-- $NetBSD: help-user.xml,v 1.2 2019/04/28 15:22:24 rillig Exp $ -->
+<!-- $NetBSD: help-user.xml,v 1.3 2019/11/22 19:48:58 rillig Exp $ -->
 
 <chapter id="help-user">
 <title>Getting help</title>
@@ -24,6 +24,20 @@
 </listitem>
 
 <listitem><para>
+       To see the value of a single variable, run <command>bmake
+       show-var VARNAME=<replaceable>X</replaceable></command>.
+</para></listitem>
+
+<listitem><para>
+       To see the values of the most common variables, run
+       <command>bmake show-all</command>. These variables are grouped by
+       topic. To see the variables for a single topic, run
+       <command>bmake
+       show-all-<replaceable>topic</replaceable></command>, for example
+       <command>bmake show-all-fetch</command>.
+</para></listitem>
+
+<listitem><para>
        The pkgsrc-users mailing list, to which
        <ulink url="https://www.NetBSD.org/mailinglists/#pkgsrc-users";>you
        can subscribe</ulink> and then <ulink