X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fpazpar2_conf.xml;h=dcc1fdf5ea897e1fa8200be7a172634f4dad77ed;hb=31babd0a7a0d4ee7091cfb740205ab6fe1c89ae5;hp=6b36345f311741b3e46dbf550ef72bfb9b28bfb8;hpb=3438d21c3c7142e236af05139f799a71440eeee3;p=pazpar2-moved-to-github.git

diff --git a/doc/pazpar2_conf.xml b/doc/pazpar2_conf.xml
index 6b36345..dcc1fdf 100644
--- a/doc/pazpar2_conf.xml
+++ b/doc/pazpar2_conf.xml
@@ -133,7 +133,7 @@
        mergekey and facets - for the server. These definitions serves as
        default for services that don't have these given. For the meaning
        of these settings refer to the
-       <xref linkend="icu_chain">"icu_chain"</xref> element inside service.
+       <xref linkend="icuchain"/> element inside service.
       </para>
      </listitem>
     </varlistentry>
@@ -326,6 +326,17 @@
 	    </para>
 	   </listitem>
 	  </varlistentry>
+
+	  <varlistentry>
+	   <term id="facetrule">facetrule</term>
+	   <listitem>
+	    <para>
+	     Specifies the ICU rule set to be used for normalizing
+	     facets. If facetrule is omitted from metadata, the
+	     rule set 'facet' is used.
+	    </para>
+	   </listitem>
+	  </varlistentry>
 	  
 	  <varlistentry>
 	   <term>setting</term>
@@ -358,7 +369,21 @@
        </varlistentry>
 
        <varlistentry>
-	<term id="icu_chain">icu_chain</term>
+	<term id="servicexslt" xreflabel="xslt">xslt</term>
+	<listitem>
+	 <para>
+	  Defines a XSLT stylesheet. The <literal>xslt</literal>
+	  element takes exactly one attribute <literal>id</literal>
+	  which names the stylesheet. This can be referred to in target
+	  settings <xref linkend="pzxslt"/>.
+	 </para>
+	 <para>
+	  The content of the xslt element is the embedded stylesheet XML
+	 </para>
+	</listitem>
+       </varlistentry>
+       <varlistentry>
+	<term id="icuchain" xreflabel="icu_chain">icu_chain</term>
 	<listitem>
 	 <para>
 	  Specifies a named ICU rule set. The icu_chain element must include
@@ -368,8 +393,10 @@
 	  Rule set 'relevance' is used to normalize
 	  terms for relevance ranking. Rule set 'sort' is used to 
 	  normalize terms for sorting. Rule set 'mergekey' is used to
-	  normalize terms for making a mergekey and, finally, 'facet'
-	  is used to normalize facet terms (AKA termlists).
+	  normalize terms for making a mergekey and, finally. Rule set 'facet'
+	  is normally used to normalize facet terms, unless
+	  <xref linkend="facetrule">facetrule</xref> is given for a
+	  metadata field.
 	 </para>
 	 <para>
 	  The icu_chain element must also include a 'locale'
@@ -737,6 +764,11 @@
        multiple overlapping settings with the same name and target
        value, the 'precedence' attribute determines what happens.
       </para>
+      <para>
+       For Pazpar2 1.6.4 or later, the target ID may be user-defined, in
+       which case, the actual host, port, etc is given by setting
+       <xref linkend="pzurl"/>.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -973,13 +1005,21 @@
     </varlistentry>
 
     <varlistentry>
-     <term>pz:xslt</term>
+     <term id="pzxslt" xreflabel="pz:xslt">pz:xslt</term>
      <listitem>
       <para>
-       Is a comma separated list of of files that specifies
+       Is a comma separated list of of stylesheet names that specifies
        how to convert incoming records to the internal representation.
       </para>
       <para>
+       For each name, the embedded stylesheets (XSL) that comes with the
+       service definition are consulted first and takes precedence over
+       external files; see <xref linkend="servicexslt"/>
+       of service definition).
+       If the name does not match an embedded stylesheet it is
+       considered a filename.
+      </para>
+      <para>
        The suffix of each file specifies the kind of tranformation.
        Suffix "<literal>.xsl</literal>" makes an XSL transform. Suffix
        "<literal>.mmap</literal>" will use the MMAP transform (described below).
@@ -1197,7 +1237,7 @@
      </listitem>
     </varlistentry>
 
-    <varlistentry>
+    <varlistentry id="limitmap">
      <term>pz:limitmap:<replaceable>name</replaceable></term>
      <listitem>
       <para>
@@ -1220,9 +1260,45 @@
       </note>
      </listitem>
     </varlistentry>
+
+    <varlistentry id="pzurl">
+     <term>pz:url</term>
+     <listitem>
+      <para>
+       Specifies URL for the target and overrides the target ID.
+      </para>
+      <note>
+       <para>
+	<literal>pz:url</literal> is only recognized for
+	Pazpar2 1.6.4 and later.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry id="pzsortmap">
+     <term>pz:sortmap:<replaceable>field</replaceable></term>
+     <listitem>
+      <para>
+       Specifies native sorting for a target where
+       <replaceable>field</replaceable> is a sort criteria (see command
+       show). The value has to components separated by colon: strategy and
+       native-field. Strategy is one of <literal>z3950</literal>,
+       <literal>type7</literal>, <literal>cql</literal>,
+       <literal>sru11</literal>, or <literal>embed</literal>.
+       The second component, native-field, is the field that is recognized
+       by the target.
+      </para>
+      <note>
+       <para>
+ 	Only supported for Pazpar2 1.6.4 and later.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
     
    </variablelist>
-
+   
   </refsect2>
 
  </refsect1>