Document @ (asperand) for bugs ticket 17144.

While here also add missing period at end of sentence and describe
dot to fix problem as noted by SUN Guonian off-list (because Chinese
end of sentence dot is different than dot).

diff --git a/CHANGES b/CHANGES
index b7481a466ad639cc43919e2192029b1b4d1c1242..69760e02384b766b160c0704c5764cd249d6e18a 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,5 @@
+2533.  [doc]           ARM: document @ (at-sign). [RT #17144]
+
 2532.  [bug]           dig: check the question section of the response to
                        see if it matches the asked question. [RT #18495]
 

diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index cd1db7ac8207a005b14377358560005f032f2963..b79d759c4e6cdaf0149909ec503a29c7538ad2c9 100644 (file)
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -18,7 +18,7 @@
  - PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- File: $Id: Bv9ARM-book.xml,v 1.386 2009/01/09 22:24:36 jinmei Exp $ -->
+<!-- File: $Id: Bv9ARM-book.xml,v 1.387 2009/01/20 19:59:25 jreed Exp $ -->
 <book xmlns:xi="http://www.w3.org/2001/XInclude">
   <title>BIND 9 Administrator Reference Manual</title>
 
@@ -11269,6 +11269,16 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
             Master File Directives include <command>$ORIGIN</command>, <command>$INCLUDE</command>,
             and <command>$TTL.</command>
           </para>
+          <sect3>
+            <title>The <command>@</command> (at-sign)</title>
+            <para>
+              When used in the label (or name) field, the asperand or
+              at-sign (@) symbol represents the current origin.
+              At the start of the zone file, it is the 
+              &lt;<varname>zone_name</varname>&gt; (followed by
+              trailing dot).
+            </para>
+          </sect3>
           <sect3>
             <title>The <command>$ORIGIN</command> Directive</title>
             <para>
@@ -11280,7 +11290,8 @@ zone <replaceable>zone_name</replaceable> <optional><replaceable>class</replacea
              sets the domain name that will be appended to any
               unqualified records. When a zone is first read in there
               is an implicit <command>$ORIGIN</command>
-              &lt;<varname>zone-name</varname>&gt;<command>.</command>
+              &lt;<varname>zone_name</varname>&gt;<command>.</command>
+              (followed by trailing dot).
               The current <command>$ORIGIN</command> is appended to
               the domain specified in the <command>$ORIGIN</command>
               argument if it is not absolute.