move <listitem/> in <varlistentry/> for validation

It is not valid to have <indexterm/> elements directly as a child of a
<varlistentry/>, so I have moved them inside the <listitem/>.  I tried putting
them inbetween <varlistentry/> elements (no good).
This commit is contained in:
Martin A. Brown 2016-03-03 13:53:35 -08:00
parent eb674426c9
commit 99f8daf840
1 changed files with 34 additions and 34 deletions

View File

@ -24095,6 +24095,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="lsusbref"/><command>lsusb</command></term>
<term><command>usbmodules</command></term>
<listitem>
<indexterm>
<primary>lsusb</primary>
</indexterm>
@ -24109,7 +24110,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<primary>command</primary>
<secondary>usb</secondary>
</indexterm>
<listitem>
<para>The <command>lsusb</command> command lists all USB
(Universal Serial Bus) buses and the devices hooked up to
@ -24142,6 +24142,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="lspciref"/><command>lspci</command></term>
<listitem>
<indexterm>
<primary>lspci</primary>
</indexterm>
@ -24149,7 +24150,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<primary>command</primary>
<secondary>pci</secondary>
</indexterm>
<listitem>
<para>Lists <firstterm>pci</firstterm> busses present.</para>
<para>
@ -24174,6 +24174,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="mkbootdiskref"/><command>mkbootdisk</command></term>
<listitem>
<indexterm>
<primary>mkbootdisk</primary>
</indexterm>
@ -24181,7 +24182,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<primary>command</primary>
<secondary>bootdisk</secondary>
</indexterm>
<listitem>
<para>Creates a boot floppy which can be used to bring up the
system if, for example, the MBR (master boot record) becomes
corrupted. Of special interest is the <option>--iso</option>
@ -24197,6 +24197,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="mkisofsref"/><command>mkisofs</command></term>
<listitem>
<indexterm>
<primary>mkisofs</primary>
</indexterm>
@ -24204,7 +24205,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<primary>command</primary>
<secondary>ISO9660</secondary>
</indexterm>
<listitem>
<para>Creates an <firstterm>ISO9660</firstterm> filesystem
suitable for a CDR image.</para>
</listitem>
@ -24212,6 +24212,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="chrootref"/><command>chroot</command></term>
<listitem>
<indexterm>
<primary>chroot</primary>
</indexterm>
@ -24224,7 +24225,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<secondary>root</secondary>
<tertiary>change</tertiary>
</indexterm>
<listitem>
<para>CHange ROOT directory. Normally commands are fetched
from <link linkend="pathref">$PATH</link>, relative to
<filename class="directory">/</filename>, the default
@ -24277,6 +24277,7 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<varlistentry>
<term><anchor id="lockfileref"/><command>lockfile</command></term>
<listitem>
<indexterm>
<primary>lockfile</primary>
</indexterm>
@ -24284,7 +24285,6 @@ mount -o loop /dev/loop0 /mnt # Mount it.
<primary>command</primary>
<secondary>lockfile</secondary>
</indexterm>
<listitem>
<para>This utility is part of the <command>procmail</command>
package (<ulink url="http://www.procmail.org">www.procmail.org</ulink>).
It creates a <firstterm>lock file</firstterm>, a
@ -24346,6 +24346,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="flockref"/><command>flock</command></term>
<listitem>
<indexterm>
<primary>flock</primary>
</indexterm>
@ -24353,7 +24354,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>lock file</secondary>
</indexterm>
<listitem>
<para>Much less useful than the <command>lockfile</command>
command is <command>flock</command>. It sets an
@ -24375,6 +24375,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="mknodref"/><command>mknod</command></term>
<listitem>
<indexterm>
<primary>mknod</primary>
</indexterm>
@ -24382,7 +24383,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>mknod</secondary>
</indexterm>
<listitem>
<para>Creates block or character <link
linkend="devfileref">device files</link> (may be
necessary when installing new hardware on the system). The
@ -24394,6 +24394,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="MAKEDEVref"/><command>MAKEDEV</command></term>
<listitem>
<indexterm>
<primary>MAKEDEV</primary>
</indexterm>
@ -24401,7 +24402,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>make device file</secondary>
</indexterm>
<listitem>
<para>Utility for creating device files. It must be run as
<firstterm>root</firstterm>, and in the <filename
@ -24413,6 +24413,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="tmpwatchref"/><command>tmpwatch</command></term>
<listitem>
<indexterm>
<primary>tmpwatch</primary>
</indexterm>
@ -24420,7 +24421,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>tmpwatch</secondary>
</indexterm>
<listitem>
<para>Automatically deletes files which have not been accessed
within a specified period of time. Usually invoked by
<link linkend="cronref">cron</link> to remove stale log
@ -24437,6 +24437,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="dumpref"/><command>dump</command></term>
<term><anchor id="restoreref"/><command>restore</command></term>
<listitem>
<indexterm>
<primary>dump</primary>
</indexterm>
@ -24451,7 +24452,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>restore</secondary>
</indexterm>
<listitem>
<para>The <command>dump</command> command is an elaborate
filesystem backup utility, generally used on larger
installations and networks.
@ -24469,6 +24469,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="fdformatref"/><command>fdformat</command></term>
<listitem>
<indexterm>
<primary>fdformat</primary>
</indexterm>
@ -24476,7 +24477,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>floppy</secondary>
</indexterm>
<listitem>
<para>Perform a low-level format on a floppy disk
(<filename>/dev/fd0*</filename>).</para>
</listitem>
@ -24490,6 +24490,7 @@ then #+ Prevent other programs &amp; scripts
<varlistentry>
<term><anchor id="ulimitref"/><command>ulimit</command></term>
<listitem>
<indexterm>
<primary>ulimit</primary>
</indexterm>
@ -24497,7 +24498,6 @@ then #+ Prevent other programs &amp; scripts
<primary>command</primary>
<secondary>ulimit</secondary>
</indexterm>
<listitem>
<para>Sets an <firstterm>upper limit</firstterm> on use
of system resources. Usually invoked with the
@ -24554,6 +24554,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="quotaref"/><command>quota</command></term>
<listitem>
<indexterm>
<primary>quota</primary>
</indexterm>
@ -24561,13 +24562,13 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>quota</secondary>
</indexterm>
<listitem>
<para>Display user or group disk quotas.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="setquotaref"/><command>setquota</command></term>
<listitem>
<indexterm>
<primary>setquota</primary>
</indexterm>
@ -24575,12 +24576,13 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>quota</secondary>
</indexterm>
<listitem>
<para>Set user or group disk quotas from the command-line.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="umaskref"/><command>umask</command></term>
<listitem>
<indexterm>
<primary>umask</primary>
</indexterm>
@ -24588,8 +24590,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>umask</secondary>
</indexterm>
<term><anchor id="umaskref"/><command>umask</command></term>
<listitem>
<para>User file creation permissions
<firstterm>mask</firstterm>. Limit the default file
attributes for a particular user. All files created
@ -24623,6 +24623,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="rdevref"/><command>rdev</command></term>
<listitem>
<indexterm>
<primary>rdev</primary>
</indexterm>
@ -24630,7 +24631,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>rdev</secondary>
</indexterm>
<listitem>
<para>Get info about or make changes to root device, swap space, or video
mode. The functionality of <command>rdev</command> has generally been taken over by
<command>lilo</command>, but <command>rdev</command> remains
@ -24647,6 +24647,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="lsmodref"/><command>lsmod</command></term>
<listitem>
<indexterm>
<primary>lsmod</primary>
</indexterm>
@ -24654,7 +24655,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>List installed kernel modules.</para>
<para>
<screen><prompt>bash$ </prompt><userinput>lsmod</userinput>
@ -24679,6 +24679,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="insmodref"/><command>insmod</command></term>
<listitem>
<indexterm>
<primary>insmod</primary>
</indexterm>
@ -24686,7 +24687,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>Force installation of a kernel module (use
<command>modprobe</command> instead, when possible). Must
be invoked as <firstterm>root</firstterm>.</para>
@ -24695,6 +24695,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="rmmodref"/><command>rmmod</command></term>
<listitem>
<indexterm>
<primary>rmmod</primary>
</indexterm>
@ -24702,7 +24703,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>Force unloading of a kernel module. Must be invoked
as <firstterm>root</firstterm>.</para>
</listitem>
@ -24710,6 +24710,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="modproberef"/><command>modprobe</command></term>
<listitem>
<indexterm>
<primary>modprobe</primary>
</indexterm>
@ -24717,7 +24718,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>Module loader that is normally invoked automatically
in a startup script. Must be invoked as
<firstterm>root</firstterm>.</para>
@ -24726,6 +24726,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="depmodref"/><command>depmod</command></term>
<listitem>
<indexterm>
<primary>depmod</primary>
</indexterm>
@ -24733,7 +24734,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>Creates module dependency file. Usually invoked from a
startup script.</para>
</listitem>
@ -24741,6 +24741,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="modinforef"/><command>modinfo</command></term>
<listitem>
<indexterm>
<primary>modinfo</primary>
</indexterm>
@ -24748,7 +24749,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>loadable modules</secondary>
</indexterm>
<listitem>
<para>Output information about a loadable module.</para>
@ -24769,6 +24769,7 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<varlistentry>
<term><anchor id="envvref"/><command>env</command></term>
<listitem>
<indexterm>
<primary>env</primary>
</indexterm>
@ -24776,7 +24777,6 @@ exit 0 # Will not exit here, because this script will never terminate.</pr
<primary>command</primary>
<secondary>env</secondary>
</indexterm>
<listitem>
<para>
Runs a program or script with certain <link
linkend="envref">environmental variables</link>
@ -24822,6 +24822,7 @@ print "even when I don't know where to find Perl.\n";
<varlistentry>
<term><anchor id="lddref"/><command>ldd</command></term>
<listitem>
<indexterm>
<primary>ldd</primary>
</indexterm>
@ -24829,7 +24830,6 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>ldd</secondary>
</indexterm>
<listitem>
<para>Show shared lib dependencies for an executable file.</para>
<screen><prompt>bash$ </prompt><userinput>ldd /bin/ls</userinput>
<computeroutput>libc.so.6 => /lib/libc.so.6 (0x4000c000)
@ -24839,6 +24839,7 @@ print "even when I don't know where to find Perl.\n";
<varlistentry>
<term><anchor id="watchref"/><command>watch</command></term>
<listitem>
<indexterm>
<primary>watch</primary>
</indexterm>
@ -24846,7 +24847,6 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>periodic</secondary>
</indexterm>
<listitem>
<para>Run a command repeatedly, at specified time intervals.</para>
<para>The default is two-second intervals, but this may be changed
with the <option>-n</option> option.</para>
@ -24861,6 +24861,7 @@ print "even when I don't know where to find Perl.\n";
<varlistentry>
<term><anchor id="stripref"/><command>strip</command></term>
<listitem>
<indexterm>
<primary>strip</primary>
</indexterm>
@ -24868,7 +24869,6 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>symbol</secondary>
</indexterm>
<listitem>
<para>Remove the debugging symbolic references from an executable
binary. This decreases its size, but makes debugging it
impossible.</para>
@ -24880,6 +24880,7 @@ print "even when I don't know where to find Perl.\n";
<varlistentry>
<term><anchor id="nmref"/><command>nm</command></term>
<listitem>
<indexterm>
<primary>nm</primary>
</indexterm>
@ -24887,13 +24888,13 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>symbol</secondary>
</indexterm>
<listitem>
<para>List symbols in an unstripped compiled binary.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="xrandrref"/><command>xrandr</command></term>
<listitem>
<indexterm>
<primary>xrandr</primary>
</indexterm>
@ -24901,7 +24902,6 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>xrandr</secondary>
</indexterm>
<listitem>
<para>Command-line tool for manipulating the root window
of the screen.</para>
@ -24916,6 +24916,7 @@ print "even when I don't know where to find Perl.\n";
<varlistentry>
<term><anchor id="rdistref"/><command>rdist</command></term>
<listitem>
<indexterm>
<primary>rdist</primary>
</indexterm>
@ -24923,7 +24924,6 @@ print "even when I don't know where to find Perl.\n";
<primary>command</primary>
<secondary>rdist</secondary>
</indexterm>
<listitem>
<para>Remote distribution client: synchronizes, clones,
or backs up a file system on a remote server.</para>
</listitem>
@ -27725,6 +27725,7 @@ exit $?
<varlistentry>
<term><command>return</command></term>
<listitem>
<indexterm>
<primary>return</primary>
</indexterm>
@ -27732,7 +27733,6 @@ exit $?
<primary>command</primary>
<secondary>return</secondary>
</indexterm>
<listitem>
<para><anchor id="returnref"/></para>
<para>Terminates a function. A <command>return</command> command
<footnote><para>The <command>return</command> command is a
@ -27893,11 +27893,11 @@ echo $days_in # 30
<varlistentry>
<term><replaceable>Redirecting the stdin
of a function</replaceable></term>
<listitem>
<indexterm>
<primary>redirection</primary>
<secondary>stdin</secondary>
</indexterm>
<listitem>
<para>A function is essentially a <link
linkend="codeblockref">code block</link>, which means its
@ -27970,11 +27970,11 @@ Function () # This doesn't work.
<varlistentry>
<term>local variables</term>
<listitem>
<indexterm>
<primary>variable</primary>
<secondary>local</secondary>
</indexterm>
<listitem>
<para>A variable declared as <firstterm>local</firstterm>
is one that is visible only within the <link
linkend="codeblockref">block of code</link> in which it