[svnbook] r4432 committed - * en/HACKING...

[svnbook at googlecode.com]

Revision: 4432
Author:   cmpilato at gmail.com
Date:     Wed Feb 13 09:32:46 2013
Log:      * en/HACKING
   Document another exception on the index term formatting.
http://code.google.com/p/svnbook/source/detail?r=4432

Modified:
  /trunk/en/HACKING

=======================================
--- /trunk/en/HACKING	Fri Feb  8 11:34:12 2013
+++ /trunk/en/HACKING	Wed Feb 13 09:32:46 2013
@@ -207,10 +207,10 @@
           use the <command>svn copy</command> command.  This command is
       [...]

-  One exception to this rule is when indexing items in a list.  Our
-  processors don't seem to apply a finer granularity to the anchor
-  points beyond "the list", so we clump <indexterm>s at the head of
-  the list:
+  There are some exceptions to this rule. The first is when indexing
+  items in a list.  Our processors don't seem to apply a finer
+  granularity to the anchor points beyond "the list", so we clump
+  <indexterm>s at the head of the list:

       [...]

@@ -234,6 +234,26 @@
             <listitem>This property causes Subversion to wiggle its
       [...]

+  Another exception is in the reference sections, where drop
+  <indexterm>s for the reference entry itself immediately inside the
+  <refentry> tag.
+
+     [...]
+
+       <refentry id="svn.ref.svnmucc.re">
+         <indexterm>
+           <primary>svnmucc</primary>
+         </indexterm>
+
+         <refnamediv>
+           <refname>svnmucc</refname>
+           <refpurpose>Perform one or more Subversion repository
+             URL-based ACTIONs, committing the result as a (single) new
+             revision.</refpurpose>
+         </refnamediv>
+
+     [...]
+

  ====================
  PRE-PROCESSING NEEDS