os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Use lower case indexterms, and correct an egregious entry :

Browse source 
-    <indexterm><primary>Configuring the <command>cron</command> utility</primary></indexterm>
+    <indexterm><primary>cron</primary>
+      <secondary>configuration</secondary></indexterm>

This is wrong for many many reasons :

* The indexterm is way too long and is a direct copy of the title
  of the section it resides in.  The index is not a table of contents.
* Two columns of index terms should fit at the back of the printed
  book, so four words is almos always out of the question.
* indexterms relating to cron should appear near (as a subterm of) the
  'cron' entry, not as a new 'Configuration blah' entry.
This commit is contained in:
Murray Stokely 2003-06-15 10:12:00 +00:00
parent b2408c9597
commit 2aa7428929
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=17322
1 changed files with 11 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
en_US.ISO8859-1/books/handbook/config/chapter.sgml
View file

@ -97,7 +97,7 @@
<sect2>
<title>Partition Layout</title>
<indexterm><primary>Partition layout</primary></indexterm>
<indexterm><primary>partition layout</primary></indexterm>
<indexterm>
<primary><filename>/etc</filename></primary>
</indexterm>
@ -430,7 +430,8 @@ exit 0
</sect1info>
<title>Configuring the <command>cron</command> utility</title>
<indexterm><primary>Configuring the <command>cron</command> utility</primary></indexterm>
<indexterm><primary>cron</primary>
<secondary>configuration</secondary></indexterm>
<para>One of the most useful utilities in FreeBSD is &man.cron.8;. The
<command>cron</command> utility runs in the background and constantly
@ -706,7 +707,7 @@ sshd is running as pid 433.</screen>
<title>Setting Up Network Interface Cards</title>
<indexterm><primary>Network card configuration</primary></indexterm>
<indexterm><primary>network card configuration</primary></indexterm>
<para>Nowadays we can not think about a computer without thinking
about a network connection. Adding and configuring a network
@ -716,8 +717,8 @@ sshd is running as pid 433.</screen>
<title>Locating the Correct Driver</title>
<indexterm>
<primary>Network card configuration</primary>
<secondary>Locating the driver</secondary>
<primary>network card configuration</primary>
<secondary>locating the driver</secondary>
</indexterm>
<para>Before you begin, you should know the model of the card
@ -957,8 +958,8 @@ ifconfig_dc1="inet 10.0.0.1 netmask 255.255.255.0 media 10baseT/UTP"</programlis
<title>Testing the Ethernet Card</title>
<indexterm>
<primary>Network card configuration</primary>
<secondary>Testing the card</secondary>
<primary>network card configuration</primary>
<secondary>testing the card</secondary>
</indexterm>
<para>To verify that an Ethernet card is configured correctly,
@ -1002,8 +1003,8 @@ round-trip min/avg/max/stddev = 0.700/0.729/0.766/0.025 ms</screen>
<title>Troubleshooting</title>
<indexterm>
<primary>Network card configuration</primary>
<secondary>Troubleshooting</secondary>
<primary>network card configuration</primary>
<secondary>troubleshooting</secondary>
</indexterm>
<para>Troubleshooting hardware and software configurations is always
@ -1672,7 +1673,7 @@ kern.maxfiles: 2088 -> 5000</screen>
<indexterm>
<primary>Soft Updates</primary>
<secondary>Details</secondary>
<secondary>details</secondary>
</indexterm>
<para>There are two traditional approaches to writing a file systems meta-data