X-Git-Url: http://git.indexdata.com/?p=idzebra-moved-to-github.git;a=blobdiff_plain;f=doc%2Ffield-structure.xml;h=98c41835e889d773699f52b2a491c2a986ec2455;hp=bf02d35575d887a3ddfb80cc67215d76eab7657d;hb=99842ec71f065fd6886daa355923b01d9ce71d26;hpb=bd964f3a7291ef3171b917348142472384b636cf

diff --git a/doc/field-structure.xml b/doc/field-structure.xml
index bf02d35..98c4183 100644
--- a/doc/field-structure.xml
+++ b/doc/field-structure.xml
@@ -1,5 +1,4 @@
  <chapter id="fields-and-charsets">
-  <!-- $Id: field-structure.xml,v 1.13 2007-12-19 09:30:29 adam Exp $ -->
   <title>Field Structure and Character Sets
   </title>
   
@@ -22,10 +21,10 @@
   </para>
 
   <para>
-   Zebra 1.3 and Zebra 2.0 series require that the field type is
-   a single character, e.g. <literal>w</literal> (for word), and
-   <literal>p</literal> for phrase. Zebra 2.1 allows field types to
-   be any string. This allows for greater flexibility - in particular
+   Zebra 1.3 and Zebra versions 2.0.18 and earlier required that the field
+   type is a single character, e.g. <literal>w</literal> (for word), and
+   <literal>p</literal> for phrase. Zebra 2.0.20 and later allow field types 
+   to be any string. This allows for greater flexibility - in particular
    per-locale (language) fields can be defined.
   </para>
 
@@ -85,9 +84,9 @@
 	(non-space characters) separated by single space characters
 	(normalized to " " on display). When completeness is
 	disabled, each word is indexed as a separate entry. Complete subfield
-	indexing is most useful for fields which are typically browsed (eg.
+	indexing is most useful for fields which are typically browsed (e.g.,
 	titles, authors, or subjects), or instances where a match on a
-	complete subfield is essential (eg. exact title searching). For fields
+	complete subfield is essential (e.g., exact title searching). For fields
 	where completeness is disabled, the search engine will interpret a
 	search containing space characters as a word proximity search.
        </para>
@@ -137,7 +136,7 @@
       </listitem></varlistentry>
     </variablelist>
    </para>
-   <example>
+   <example id="field-types">
     <title>Field types</title>
     <para>
      Following are three excerpts of the standard
@@ -147,7 +146,7 @@
      to them:
      <screen>
      # Traditional word index
-     # Used if completenss is 'incomplete field' (@attr 6=1) and
+     # Used if completeness is 'incomplete field' (@attr 6=1) and
      # structure is word/phrase/word-list/free-form-text/document-text
      index w
      completeness 0
@@ -296,7 +295,7 @@
 	  <para>
 	   Curly braces {} may be used to enclose ranges of single
 	   characters (possibly using the escape convention described in the
-	   preceding point), eg. {a-z} to introduce the
+	   preceding point), e.g., {a-z} to introduce the
 	   standard range of ASCII characters.
 	   Note that the interpretation of such a range depends on
 	   the concrete representation in your local, physical character set.
@@ -305,8 +304,8 @@
 
 	 <listitem>
 	  <para>
-	   paranthesises () may be used to enclose multi-byte characters -
-	   eg. diacritics or special national combinations (eg. Spanish
+	   parentheses () may be used to enclose multi-byte characters -
+	   e.g., diacritics or special national combinations (e.g., Spanish
 	   "ll"). When found in the input stream (or a search term),
 	   these characters are viewed and sorted as a single character, with a
 	   sorting value depending on the position of the group in the value
@@ -480,7 +479,7 @@
      Use the yaz-icu program to test your icuchain rules.
     </para>
    </tip>
-   <example><title>Indexing Greek text</title>
+   <example id="indexing-greek-example"><title>Indexing Greek text</title>
     <para>
      Consider a system where all "regular" text is to be indexed
      using as Greek (locale: EL).
@@ -513,10 +512,10 @@
     which is an ICU chain version of <filename>default.idx</filename>.
    </para>
 
-   <example><title>MARCXML indexing using ICU</title>
+   <example id="indexing-marcxml-example"><title>MARCXML indexing using ICU</title>
     <para>
      The directory <filename>examples/marcxml</filename> includes
-     a complete sample with MARCXML recordst that are DOM XML indexed 
+     a complete sample with MARCXML records that are DOM XML indexed 
      using ICU chain rules. Study the
      <filename>README</filename> in the <filename>marcxml</filename>
      directory for details.