Index: collections/documented-examples/trunk/authen-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/authen-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/authen-e/etc/collect.cfg	(revision 19786)
@@ -203,4 +203,6 @@
 <p>
 <!-- _text1_  -->
+The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
+configuration file</a> is exactly the same as for the original demo collection apart from the authentication directives, one plugin option (and this description).
 
 <p>
@@ -213,5 +215,12 @@
 
 <p>
-<!-- _text3_ --> Ð¡Ð¿ÐµÑÐžÑÐžÐºÑ ÑÐ°ÐŒÐžÑ
+<!-- _text3_ -->Authentication is activated by the <i>authenticate</i> directive with the value
+<i>collection</i> or <i>document</i> depending on whether authentication is to
+be performed on the full collection or on a per-document basis (the default
+value is <i>collection</i>). If authentication is on a <i>document</i> basis,
+then one can <i>either</i> specify a list of private documents (in which
+case all others are public) or a list of public documents (in which case
+all others are private) using directives <i>private_documents</i> or
+<i>public_documents</i>.  Ð¡Ð¿ÐµÑÐžÑÐžÐºÑ ÑÐ°ÐŒÐžÑ
  ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ² ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÑÑ, ÐžÑÐ¿ÐŸÐ»ÑÐ·ÑÑ ÐžÐŽÐµÐœÑÐžÑÐžÐºÐ°ÑÐŸÑÑ ÐŽÐŸÐºÑÐŒÐµÐœÑÐ° Ð² Greenstone (ÑÐ°ÑÐ¿ÑÐµÐŽÐµÐ»ÐµÐœÐœÑÑ
  Ð¿ÐŸ ÐŸÐ±Ð»Ð°ÑÑÑÐŒ). Ð¡Ð°ÐŒÑÐ¹ Ð»ÐµÐ³ÐºÐžÐ¹ ÑÐ¿ÐŸÑÐŸÐ± ÐžÑ
@@ -219,5 +228,12 @@
 ÐŸÐ¶ÐŽÐµÐœÐžÐµ ÐºÐ°Ð¶ÐŽÐŸÐ³ÐŸ ÐŽÐŸÐºÑÐŒÐµÐœÑÐ° Ð² ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž Ðž ÑÐ°ÑÑÐŒÐŸÑÑÐµÑÑ ÐµÐ³ÐŸ <i>d</i>-Ð°ÑÐ³ÑÐŒÐµÐœÑ Ð² URL Greenstone.
 
-<p><!-- _text2_ -->\n
+<p><!-- _text2_ -->
+In this case, we have used the <i>-OIDtype dirname</i> option to HTMLPlugin,
+which specifies that directory names should be used as identifiers. This works 
+for collections where each document is in a separate directory. We have used 
+this option to ensure that identifiers remain the same across different 
+platforms (which may not be the case for HASH identifiers), as we need to 
+specify identifiers here for the authentication directives.\n
+
 <p>
 ÐÐžÑÐµÐºÑÐžÐ²Ð° <i>auth_groups</i> ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ Ð³ÑÑÐ¿Ð¿Ñ Greenstone, Ðº ÐºÐŸÑÐŸÑÑÐŒ ÐŽÐŸÑÑÑÐ¿ Ð±ÑÐŽÐµÑ ÑÐ°Ð·ÑÐµÑÐµÐœ, ÐµÑÐ»Ðž ÐŽÐŸÐºÑÐŒÐµÐœÑ (ÐžÐ»Ðž ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ) ÐŸÑÐœÐŸÑÐžÑÑÑ Ðº ÑÐµÐŒ, ÐŽÐ»Ñ ÐºÐŸÑÐŸÑÑÑ
Index: collections/documented-examples/trunk/bibtex-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/bibtex-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/bibtex-e/etc/collect.cfg	(revision 19786)
@@ -517,14 +517,27 @@
  Ð²ÐŒÐµÑÑÐµ Ð¿ÑÐµÐŽÐŸÑÐ²ÑÐ°ÑÐ°ÐµÑ Ð²ÐœÑÑÑÐµÐœÐœÐžÐµ ÑÐ°Ð¹Ð»ÐŸÐ²ÑÐµ ÑÑÑÑÐºÑÑÑÑ Greenstone ÐŸÑ ÑÐ²ÐµÐ»ÐžÑÐµÐœÐžÑ ÐŸÐ±ÑÑÐŒÐ° Ðž Ð·Ð°ÐœÑÑÐžÑ Ð±ÐŸÐ»ÑÑÐµÐ³ÐŸ ÐŽÐžÑÐºÐŸÐ²ÐŸÐ³ÐŸ Ð¿ÑÐŸÑÑÑÐ°ÐœÑÑÐ²Ð°, ÑÐµÐŒ ÐœÐµÐŸÐ±Ñ
 ÐŸÐŽÐžÐŒÐŸ.
-<!-- 
-<p>
-_text1_
-
-<p>
-_text5_
-
-<p>
-_text3_
--->
+
+<p>
+<!-- _text1_ -->
+Apart from the standard plugins, this collection uses <i>BibTexPlugin</i>, 
+which processes references in the BibTeX format (well known to computer 
+scientists). Two options have been set for BibTexPlugin: 
+<i>-OIDtype assigned -OIDmetadata Number</i>. This means the metadata 
+element \"Number\" will be used as the record identifier, instead of 
+Greenstone's default hash identifiers. These options are available for 
+all plugins.\n
+
+<p>
+<!-- _text5_ -->
+Fielded searching, with a form-based interface, is selected by <i>format SearchTypes \"form,plain\"
+</i> in the configuration file. In fact, a plain textual full-text search
+index is included in this collection as well (since <i>form</i> comes first, 
+it is the default interface; you reach the <i>plain</i> search through 
+the <i>Preferences</i> page).\n
+
+<p>
+<!-- _text3_-->
+The <i>buildtype</i> option shows that the default search engine <i>mgpp</i> is
+used. The <i>indexes</i> line specifies indexes for \"text\", and \"metadata\". In this case, \"text\" will be the original BibTeX record. \"metadata\" is a special keyword signifying that an index should be built for any metadata item found in the collection. 
 
 <p>
@@ -534,5 +547,10 @@
 . ÐÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ ÐœÐ° ÑÑÐŸÐ²ÐœÐµ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž <i>collectionmeta</i> ÐŒÐŸÐ³ÑÑ Ð±ÑÑÑ Ð·Ð°ÐŽÐ°ÐœÑ ÐŽÐ»Ñ Ð»ÑÐ±ÐŸÐ³ÐŸ ÐžÐœÐŽÐµÐºÑÐ°, ÑÑÐŸÐ±Ñ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÐžÑÑ, ÑÑÐŸ ÑÑÐŸ ÐŸÐ·ÐœÐ°ÑÐ°ÐµÑ Ð² ÐŒÐµÐœÑ (Ð·Ð° ÐžÑÐºÐ»ÑÑÐµÐœÐžÐµÐŒ <i>metadata</i>, ÐºÐŸÑÐŸÑÐŸÐµ ÑÐŸÐ·ÐŽÐ°ÐµÑ ÐŒÐœÐŸÐ³ÐŸ Ð¿ÑÐœÐºÑÐŸÐ² ÐŒÐµÐœÑ). Ð ÑÑÐŸÐŒ ÑÐ»ÑÑÐ°Ðµ <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>ÐºÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÑÐ¹ ÑÐ°Ð¹Ð»</a> ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ, ÑÑÐŸ ÑÐµÐºÑÑÐŸÐ²ÑÐ¹ ÐžÐœÐŽÐµÐºÑ ÐŽÐŸÐ»Ð¶ÐµÐœ Ð±ÑÑÑ ÐœÐ°Ð·Ð²Ð°Ðœ \"<i>full record</i>\", Ð¿ÐŸÑÐŸÐŒÑ ÑÑÐŸ ÐŸÐœÐ° ÑÐŸÐŽÐµÑÐ¶ÐžÑ ÐŸÑÐžÐ³ÐžÐœÐ°Ð»ÑÐœÑÑ Ð±ÐžÐ±Ð»ÐžÐŸÐ³ÑÐ°ÑÐžÑÐµÑÐºÑÑ Ð·Ð°Ð¿ÐžÑÑ.
 
-<!-- <p>_text4_  -->
+<p>
+<!-- _text4_  -->
+An additional keyword, \"allfields\", could also be used in the <i>indexers</i> line, specifying that combined searching over all indexes should be available. 
+<p>
+The <i>levels</i> lines specifies only document level, as bibliographic records don't have internal structure.
+
 <p>
 Ð­ÑÐ° ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ ÑÐŸÐŽÐµÑÐ¶ÐžÑ Ð¿ÑÐŸÐ³ÑÐ°ÐŒÐŒÑ Ð¿ÑÐŸÑÐŒÐŸÑÑÐ° Ð¿ÐŸ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÑ</i>, <i>ÐÐ²ÑÐŸÑÑ Ðž ÐÐ°ÑÐµ</i>, Ðž ÑÐ¿ÐµÑÐžÐ°Ð»ÑÐœÑÐ¹ Ð²ÐžÐŽ ÐžÐœÐŽÐµÐºÑÐ° ÑÑÐ°Ð·Ñ, ÐœÐ°Ð·ÑÐ²Ð°ÐµÐŒÑÐ¹ \"<i>Phind</i>\". ÐÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑ <i>AZCompactList</i>, ÐžÑÐ¿ÐŸÐ»ÑÐ·ÑÐµÐŒÑÐ¹ ÐŽÐ»Ñ Ð¿ÑÐŸÑÐŒÐŸÑÑÐ° Ð¿ÐŸ <i>ÐÐ²ÑÐŸÑÑ</i>, Ð¿ÐŸÑ
Index: collections/documented-examples/trunk/bibtex-supp-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/bibtex-supp-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/bibtex-supp-e/etc/collect.cfg	(revision 19786)
@@ -426,5 +426,9 @@
 supercollection documented-examples/bibtex-supp-e documented-examples/bibtex-e
 </pre>
+
 <!-- _text1_ -->
+The \"documented-examples/\" parts of the collection names are necessary 
+because these collections reside in the \"documented-examples\" collection 
+group subfolder in the collect directory.\n
 <p>
 
Index: collections/documented-examples/trunk/dls-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/dls-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/dls-e/etc/collect.cfg	(revision 19786)
@@ -540,4 +540,5 @@
 
 <!-- _text1_ -->
+The DLS collection is fairly complex.
 ÐµÑÐ»Ðž ÐÑ ÑÐ²Ð»ÑÐµÑÐµÑÑ ÑÐŸÐ»ÑÐºÐŸ ÐœÐ°ÑÐžÐœÐ°ÑÑÐžÐŒ Ð¿ÐŸÐ»ÑÐ·ÐŸÐ²Ð°ÑÐµÐ»ÐµÐŒ, ÑÐŸ Ð»ÑÑÑÐµ Ð²ÐœÐ°ÑÐ°Ð»Ðµ ÐŸÐ·ÐœÐ°ÐºÐŸÐŒÐžÑÑÑÑ Ñ ÐœÐµÐºÐŸÑÐŸÑÑÐŒÐž ÐŽÑÑÐ³ÐžÐŒÐž ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑÐŒÐž (ÐœÐ°Ð¿ÑÐžÐŒÐµÑ, Ñ <a href=\"_gwcgi_?l=_cgiargl_&c=documented-examples/wrdpdf-e&a=p&p=about\">msword Ðž pdf ÐŽÐµÐŒÐŸÐœÑÑÑÐ°ÑÐžÑÐŒÐž</a> ÐžÐ»Ðž Ð¶Ðµ Ñ Ð°ÑÑ
 ÐžÐ²Ð°ÐŒÐž ÐžÐ»Ðž Ñ Ð¿ÑÐŸÑÑÐŸÐ¹ Ð³ÑÐ°ÑÐžÑÐµÑÐºÐŸÐ¹ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐµÐ¹).
@@ -545,5 +546,5 @@
 
 <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>ÐÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÑÐ¹ ÑÐ°Ð¹Ð»</a> ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž, Ð¿ÐŸÐŽÐŸÐ±ÐœÐŸ Ð²ÑÐµÐŒ ÐºÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÑÐŒ ÑÐ°Ð¹Ð»Ð°ÐŒ ÐŽÑÑÐ³ÐžÑ
- ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐ¹, ÐœÐ°ÑÐžÐœÐ°ÐµÑÑÑ ÑÐŸ ÑÑÑÐŸÐºÐž Â«Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»ÑÂ» (\"Ð¡reator\"), ÐºÐŸÑÐŸÑÐ°Ñ ÑÐŸÐŸÐ±ÑÐ°ÐµÑ Ð°ÐŽÑÐµÑ ÑÐ»ÐµÐºÑÑÐŸÐœÐœÐŸÐ¹ Ð¿ÐŸÑÑÑ Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»Ñ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž, Ðž ÐŽÑÑÐ³ÐŸÐ¹ -- Â«ÐÑÐ±Ð»ÐžÐºÐ°Â» (\"Public\"), ÐºÐŸÑÐŸÑÐ°Ñ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ, Ð¿ÐŸÑÐ²ÐžÑÑÑ Ð»Ðž ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ ÐœÐ° ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ ÑÑÑÐ°ÐœÐŸÐ²ÐºÐž Greenstone. <!-- _text3_ -->
+ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐ¹, ÐœÐ°ÑÐžÐœÐ°ÐµÑÑÑ ÑÐŸ ÑÑÑÐŸÐºÐž Â«Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»ÑÂ» (\"Ð¡reator\"), ÐºÐŸÑÐŸÑÐ°Ñ ÑÐŸÐŸÐ±ÑÐ°ÐµÑ Ð°ÐŽÑÐµÑ ÑÐ»ÐµÐºÑÑÐŸÐœÐœÐŸÐ¹ Ð¿ÐŸÑÑÑ Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»Ñ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž, Ðž ÐŽÑÑÐ³ÐŸÐ¹ -- Â«ÐÑÐ±Ð»ÐžÐºÐ°Â» (\"Public\"), ÐºÐŸÑÐŸÑÐ°Ñ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ, Ð¿ÐŸÑÐ²ÐžÑÑÑ Ð»Ðž ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ ÐœÐ° ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ ÑÑÑÐ°ÐœÐŸÐ²ÐºÐž Greenstone. <!-- _text3_ -->Note that setting \"public\" to \"false\" only removes it from the home page; it will still be accessible in the library to anyone that knows the URL (a=p&p=about&c=coll-shortname).
 
 <p>
@@ -584,11 +585,11 @@
 
 <!-- _text6_ -->
+The second classifier provides access by title. It is also a <i>Hierarchy</i> classifier, this time based on
+<i>dls.AZList</i> metadata, whose hierarchy is defined in <a href=\"_httpcollection_/etc/dls.Title.txt\" target=text>dls.AZList.txt</a>. This file is discussed below.
 
 Ð¢ÑÐµÑÐžÐ¹ ÐŽÐ°ÐµÑ ÐŽÐŸÑÑÑÐ¿ Ð¿ÐŸ ÐŸÑÐ³Ð°ÐœÐžÐ·Ð°ÑÐžÑÐŒ: ÑÑÐŸ ÐºÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑ <i>Ð¡Ð¿ÐžÑÐŸÐº</i> ÐŸÑÐœÐŸÐ²Ð°ÐœÐœÑÐ¹ ÐœÐ° ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
- <i>dls.Organization</i>. <!-- _text8_ -->
-
-<!-- _text9_ -->
-
-
+ <i>dls.Organization</i>. <!-- _text8_ -->The <i>-bookshelf_type always</i> option creates a new bookshelf for each organization, even if only one document belongs to that category.
+
+<!-- _text9_ -->The fourth provides access by \"Howto\" text: it is a <i>List</i> classifier based on <i>dls.Keyword</i> metadata. The <i>-bookshelf_type never</i> option prevents bookshelves being created even if two documents share the same keywords.
 
 <p>
@@ -596,7 +597,14 @@
 
 <p>
-<b>ÐÐ¿ÐµÑÐ°ÑÐŸÑÑ ÑÐŸÑÐŒÐ°ÑÐ°</b>. <!-- _text10_ -->
-<!-- <p>
-_text11_ -->
+<b>ÐÐ¿ÐµÑÐ°ÑÐŸÑÑ ÑÐŸÑÐŒÐ°ÑÐ°</b>. 
+<!-- _text10_ -->
+The lines beginning with <i>format</i>, called \"format statements\", govern how various parts of the collection should be displayed. The <i>VList</i> format statement applies to lists of items displayed vertically, such as the lists of titles, subjects and organisations, and the table of contents for the target documents. It is overridden for the search results list by the <i>SearchVList</i> format statement, and also for the <i>Howto</i> classifier by the <i>CL4VList</i> statement (CL4 specifies the fourth classifier). 
+<p>
+<!--_text11_ -->
+The <i>DocumentText</i> statement governs how the document text is formatted,
+with <i>Title</i> metadata ([<i>Title</i>]) in HTML &lt;<i>h3</i>&gt; format
+followed by the text of the document [<i>Text</i>]. Setting the <i>DocumentImages</i> format statement to <i>true</i> ensures that cover images are shown with each document. The <i>DocumentButtons</i> statement calls for the <i>Expand
+Text, Expand Contents, Detach</i> and <i>Highlight</i> buttons to be shown with each document.
+
 <p>
 
@@ -615,5 +623,5 @@
 <b>ÐÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ ÑÑÐŸÐ²ÐœÑ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž</b>. Ð¡ÑÑÐŸÐºÐž <i>collectionmeta</i> Ð² ÐºÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÐŸÐŒ ÑÐ°Ð¹Ð»Ðµ ÑÐ°ÐºÐ¶Ðµ ÑÑÐ°ÐœÐŽÐ°ÑÑÐœÑ Ð²ÐŸ Ð²ÑÐµÑ
  ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑÑ
- Greenstone. ÐÐœÐž ÐŽÐ°ÑÑ ÐŸÐ±ÑÑÑ ÐžÐœÑÐŸÑÐŒÐ°ÑÐžÑ ÐŸ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž, ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÑ ÐµÐµ ÐœÐ°Ð·Ð²Ð°ÐœÐžÐµ (ÐžÐŒÑ), Ð¿ÑÐµÐŽÑÑÐ°Ð²Ð»ÑÑÑ ÐºÑÐ°ÑÐºÐŸÐµ ÐŸÐ¿ÐžÑÐ°ÐœÐžÐµ, ÐºÐŸÑÐŸÑÐŸÐµ Ð¿ÐŸÑÐ²Ð»ÑÐµÑÑÑ ÐœÐ° ÐµÐµ ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ. ÐÑÐ°ÑÐºÐŸÐµ ÐŸÐ¿ÐžÑÐ°ÐœÐžÐµ (Ð² <i>collectionextra</i>) ÐŒÐŸÐ¶ÐœÐŸ Ð²ÐžÐŽÐµÑÑ ÐœÐ° ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž <!-- (_text2_) -->
+ Greenstone. ÐÐœÐž ÐŽÐ°ÑÑ ÐŸÐ±ÑÑÑ ÐžÐœÑÐŸÑÐŒÐ°ÑÐžÑ ÐŸ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž, ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÑ ÐµÐµ ÐœÐ°Ð·Ð²Ð°ÐœÐžÐµ (ÐžÐŒÑ), Ð¿ÑÐµÐŽÑÑÐ°Ð²Ð»ÑÑÑ ÐºÑÐ°ÑÐºÐŸÐµ ÐŸÐ¿ÐžÑÐ°ÐœÐžÐµ, ÐºÐŸÑÐŸÑÐŸÐµ Ð¿ÐŸÑÐ²Ð»ÑÐµÑÑÑ ÐœÐ° ÐµÐµ ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ. ÐÑÐ°ÑÐºÐŸÐµ ÐŸÐ¿ÐžÑÐ°ÐœÐžÐµ (Ð² <i>collectionextra</i>) ÐŒÐŸÐ¶ÐœÐŸ Ð²ÐžÐŽÐµÑÑ ÐœÐ° ÐŽÐŸÐŒÐ°ÑÐœÐµÐ¹ ÑÑÑÐ°ÐœÐžÑÐµ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž <!-- (_text2_) -->(this text is part of it)
 <p>
 
@@ -660,5 +668,5 @@
  &lt;<i>FileSet</i>&gt; ... &lt;<i>FileSet</i>&gt;. ÐÐœÐž ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÑÑ <i>dls.Title, dls.Language, dls.Subject</i> Ðž ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ <i>dls.AZList</i>. ÐÐŸÐ»ÑÑÐµ ÑÐµÐŒ ÐŸÐŽÐœÐŸ Ð·ÐœÐ°ÑÐµÐœÐžÐµ ÐŒÐŸÐ¶ÐµÑ Ð±ÑÑÑ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÐµÐœÐŸ ÐŽÐ»Ñ Ð»ÑÐ±ÑÑ
  Ð¿ÑÐœÐºÑÐŸÐ² ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
-. <!-- _text5_ --> ÐÐ±Ð° ÑÐŸÑ
+. <!-- _text5_ -->For example, this book has two dls.Subject classifications. ÐÐ±Ð° ÑÐŸÑ
 ÑÐ°ÐœÐµÐœÑ Ð² ÐºÐ°ÑÐµÑÑÐ²Ðµ ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
  ÐŽÐ»Ñ ÑÑÐŸÐ³ÐŸ ÑÐ¿ÐµÑÐžÑÐžÑÐµÑÐºÐŸÐ³ÐŸ ÐŽÐŸÐºÑÐŒÐµÐœÑÐ°, Ð¿ÐŸÑÐŸÐŒÑ ÑÑÐŸ ÑÐŸÑÑÐŸÑÐœÐžÐµ=ÐœÐ°ÐºÐ°Ð¿Ð»ÐžÐ²Ð°ÑÑ (<i>mode=accumulate</i>) ÐŸÐ¿ÑÐµÐŽÐµÐ»ÐµÐœÐŸ, Ð° Ð² ÐºÐ°ÑÐµÑÑÐ²Ðµ Ð°Ð»ÑÑÐµÑÐœÐ°ÑÐžÐ²Ñ - Ð·ÐœÐ°ÑÐµÐœÐžÐµ Ð¿ÐŸ ÑÐŒÐŸÐ»ÑÐ°ÐœÐžÑ, ÐºÐŸÑÐŸÑÑÐŒ ÑÐ²Ð»ÑÐµÑÑÑ <i>mode=override</i>.
@@ -666,8 +674,12 @@
 
 <b>ÐÐµÑÐ°ÑÑ
-ÐžÑÐµÑÐºÐžÐµ ÑÐ°Ð¹Ð»Ñ</b>. <!-- _text12_ 
-
-<p>
-_text13_ -->
+ÐžÑÐµÑÐºÐžÐµ ÑÐ°Ð¹Ð»Ñ</b>. 
+<!-- _text12_ -->
+Hierarchy files contain a
+succession of lines each of which has three items. The first item is a text string which is matched against the metadata that occurs in the <i>metadata.xml</i> file described above. The second item is a number that defines the position in the hierarchy. The third item is a text string that describes the node of the hierarchy on the web pages that Greenstone generates.
+
+<p>
+<!-- _text13_ -->
+For example, the following shows three lines from the subject hierarchy file <a href=\"_httpcollection_/etc/dls.Subject.txt\" target=text>dls.Subject.txt</a>.
 
 <pre>
@@ -677,14 +689,15 @@
 </pre>
 
-<!--
-<p>
-_text14_
-
-<p>
-_text15_
-
-<p>
-_text16_
--->
+<p>
+<!--_text14_ -->
+These three lines define one top level bookshelf (at position 7), titled \"Animal Husbandry and Animal Product Processing\", with two bookshelves underneath it, titled \"Cattle\" and \"Other animals (micro-livestock, little known animals, silkworms, reptiles, frogs, snails, game, etc.)\" respectively.
+
+<p>
+<!--_text15_-->
+In this case, the first strings (and therefore the entries in metadata.xml files) contain the entire hierarchy values. Levels in the hierarchy are separated by \"|\". They could be used directly by a <i>Hierarchy</i> classifier without the use of the hierarchy file. However, then the entries would be ordered alphabetically, not in the special order defined by the file.
+
+<p>
+<!--_text16_ -->
+The <a href=\"_httpcollection_/etc/dls.AZList.txt\" target=text>dls.AZList.txt</a> hierarchy file used by the titles classifier contains a similar structure. Ordinarily, a titles browser would use a <i>List</i> (or <i>AZList</i>) classifier. In this case, we want to predefine the A-Z groupings, and include a separate entry for periodicals, as can be seen <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL2.7\">here</a>.
 "
 
Index: collections/documented-examples/trunk/gsarch-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/gsarch-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/gsarch-e/etc/collect.cfg	(revision 19786)
@@ -308,5 +308,6 @@
 collectionmeta	collectionextra [l=ru] "
 <!-- _text1_ -->
-
+This is a collection of email messages 
+from the Greenstone mailing list archives, from November/December, 2008.
 
 <h3>ÐÐ°Ðº ÑÐ°Ð±ÐŸÑÐ°ÐµÑ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ</h3>
@@ -314,5 +315,5 @@
 ÐÐŸÐ»Ð»ÐµÐºÑÐžÑ Ð°ÑÑ
 ÐžÐ²ÐŸÐ² Greenstone ÐžÑÐ¿ÐŸÐ»ÑÐ·ÑÐµÑ Ð¿Ð»Ð°Ð³ÐžÐœ Ðmail, ÐºÐŸÑÐŸÑÑÐ¹ Ð°ÐœÐ°Ð»ÐžÐ·ÐžÑÑÐµÑ ÑÐ°Ð¹Ð»Ñ Ð² ÑÐŸÑÐŒÐ°ÑÐ°Ñ
- ÑÐ»ÐµÐºÑÑÐŸÐœÐœÐŸÐ¹ Ð¿ÐŸÑÑÑ. <!-- _text2_ --> ÐÐ»Ð°Ð³ÐžÐœ Ðmail ÑÐ°Ð·Ð±ÐžÐ²Ð°ÐµÑ ÐžÑ
+ ÑÐ»ÐµÐºÑÑÐŸÐœÐœÐŸÐ¹ Ð¿ÐŸÑÑÑ. <!-- _text2_ -->In this case, there is a file per month per mailing list, and each file contains many email messages.  ÐÐ»Ð°Ð³ÐžÐœ Ðmail ÑÐ°Ð·Ð±ÐžÐ²Ð°ÐµÑ ÐžÑ
  ÐœÐ° ÐžÐœÐŽÐžÐ²ÐžÐŽÑÐ°Ð»ÑÐœÑÐµ ÐŽÐŸÐºÑÐŒÐµÐœÑÑ Ðž ÑÐŸÐ·ÐŽÐ°ÐµÑ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÐµ</i>, <i>ÐÑÐµÐŽÐŒÐµÑ</i>, <i>ÐÑ</i>, <i>ÐÐŒÑ ÐŸÑÐ¿ÑÐ°Ð²ÐžÑÐµÐ»Ñ</i>, <i>ÐÐŽÑÐµÑ ÐŸÑÐ¿ÑÐ°Ð²ÐžÑÐµÐ»Ñ</i>, <i>ÐÐ°ÑÐ°</i>, <i>ÐÐ°ÑÐ° ÑÐµÐºÑÑÐŸÐŒ</i>, <i>ÐÐŸÐŒÑ ÐÑÐ²ÐµÑ</i> Ðž Ð²ÑÐ±ÐŸÑÐŸÑÐœÐŸ <i>ÐÐ°Ð³ÐŸÐ»ÐŸÐ²ÐºÐž</i>. 
 <p>
@@ -336,5 +337,6 @@
 , Ð¿ÐŸÑ
 ÐŸÐ¶ ÐœÐ° <i>AZLIST</i>, ÐœÐŸ ÐŸÐœ ÑÐŸÑÐŒÐžÑÑÐµÑ ÐºÐœÐžÐ¶ÐœÑÑ Ð¿ÐŸÐ»ÐºÑ ÐŽÐ»Ñ ÐŽÑÐ±Ð»ÐžÐºÐ°ÑÐŸÐ² ÑÐ»ÐµÐŒÐµÐœÑÐŸÐ², ÐºÐ°Ðº Ð¿ÐŸÐºÐ°Ð·Ð°ÐœÐŸ <a href=\"_gwcgi_?l=_cgiargl_&c=_cgiargc_&a=d&cl=CL1\">Ð·ÐŽÐµÑÑ</a>. ÐÐœÐ° Ð¿ÑÐµÐŽÑÑÐ°Ð²Ð»ÐµÐœÐ° ÑÑÑÑÐºÑÑÑÐŸÐ¹ ÐŽÐµÑÐµÐ²Ð°, ÑÐ·Ð»Ñ ÐºÐŸÑÐŸÑÐŸÐ¹ ÑÐ²Ð»ÑÑÑÑÑ ÐžÐ»Ðž ÑÐ·Ð»Ð°ÐŒÐž Ð»ÐžÑÑÐ°, Ð¿ÑÐµÐŽÑÑÐ°Ð²Ð»ÑÑ ÐŽÐŸÐºÑÐŒÐµÐœÑÑ, ÐžÐ»Ðž Ð²ÐœÑÑÑÐµÐœÐœÐžÐŒÐž ÑÐ·Ð»Ð°ÐŒÐž. ÐÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ ÑÐ»ÐµÐŒÐµÐœÑÐŸÐ², ÐœÐ°Ð·ÑÐ²Ð°ÐµÐŒÑÐµ numleafdocs, ÐŽÐ°ÑÑ ÐŸÐ±ÑÐµÐµ ÐºÐŸÐ»ÐžÑÐµÑÑÐ²ÐŸ ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ², ÑÐ°ÑÐ¿ÐŸÐ»ÐŸÐ¶ÐµÐœÐœÑÑ
- ÐœÐžÐ¶Ðµ Ð²ÐœÑÑÑÐµÐœÐœÐµÐ³ÐŸ ÑÐ·Ð»Ð°. ÐÐ¿ÐµÑÐ°ÑÐŸÑÑ ÑÐŸÑÐŒÐ°ÑÐ° ÐŽÐ»Ñ Ð¿ÐµÑÐ²ÐŸÐ³ÐŸ ÐºÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑÐ°, ÐœÐ°Ð·ÑÐ²Ð°ÐµÐŒÑÐµ <i>CL1Vlist</i>, Ð¿ÑÐŸÐ²ÐµÑÑÑÑ, ÑÑÑÐµÑÑÐ²ÑÐµÑ Ð»Ðž ÑÑÐŸÑ ÑÐ»ÐµÐŒÐµÐœÑ. ÐÑÐ»Ðž ÑÑÐŸ ÑÐ°Ðº, ÑÐŸ ÑÐ·ÐµÐ» ÐŽÐŸÐ»Ð¶ÐµÐœ Ð±ÑÑÑ Ð²ÐœÑÑÑÐµÐœÐœÐžÐŒ, Ð² ÑÐ»ÑÑÐ°Ðµ ÑÐµÐ³ÐŸ ÐŸÐœ Ð¿ÐŸÐŒÐµÑÐ°ÐµÑÑÑ ÐµÐ³ÐŸ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÐµÐŒ (Title)</i>. <!-- _text4_ -->
+ ÐœÐžÐ¶Ðµ Ð²ÐœÑÑÑÐµÐœÐœÐµÐ³ÐŸ ÑÐ·Ð»Ð°. ÐÐ¿ÐµÑÐ°ÑÐŸÑÑ ÑÐŸÑÐŒÐ°ÑÐ° ÐŽÐ»Ñ Ð¿ÐµÑÐ²ÐŸÐ³ÐŸ ÐºÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑÐ°, ÐœÐ°Ð·ÑÐ²Ð°ÐµÐŒÑÐµ <i>CL1Vlist</i>, Ð¿ÑÐŸÐ²ÐµÑÑÑÑ, ÑÑÑÐµÑÑÐ²ÑÐµÑ Ð»Ðž ÑÑÐŸÑ ÑÐ»ÐµÐŒÐµÐœÑ. ÐÑÐ»Ðž ÑÑÐŸ ÑÐ°Ðº, ÑÐŸ ÑÐ·ÐµÐ» ÐŽÐŸÐ»Ð¶ÐµÐœ Ð±ÑÑÑ Ð²ÐœÑÑÑÐµÐœÐœÐžÐŒ, Ð² ÑÐ»ÑÑÐ°Ðµ ÑÐµÐ³ÐŸ ÐŸÐœ Ð¿ÐŸÐŒÐµÑÐ°ÐµÑÑÑ ÐµÐ³ÐŸ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÐµÐŒ (Title)</i>. <!-- _text4_ -->Otherwise the node\'s label starts with the
+<i>Subject</i> which links to the document, then gives <i>FromName</i> metadata, with a link to \"Search by Sender\", followed by the <i>DateText</i>.
 <p>
 
@@ -342,5 +344,7 @@
  ÑÐ·Ð»ÐŸÐ² ÑÐ°ÐºÑÐžÑÐµÑÐºÐŸÐµ ÑÐžÑÐ»ÐŸ ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ² Ð² ÑÐ¿ÐžÑÐºÐµ (<i>numleafdocs</i>) ÐŽÐ°ÐµÑÑÑ Ð² ÐºÑÑÐ³Ð»ÑÑ
  ÑÐºÐŸÐ±ÐºÐ°Ñ
- Ð¿ÐŸÑÐ»Ðµ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÑ</i>. <!-- _text5_ -->
+ Ð¿ÐŸÑÐ»Ðµ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÑ</i>. <!-- _text5_ -->For
+document nodes the <i>FromName</i>, with a link to \"Search By Sender\", <i>Subject</i> (linked to the document), and <i>DateText</i> metadata is
+shown.
 <p>
 
@@ -348,5 +352,6 @@
 <p>
 
-<!-- _text6_ -->
+<!-- _text6_ -->Finally, the document text is formatted to show the header fields (<i>FromName</i>, <i>DateText</i>, <i>Subject</i>, <i>InReplyTo</i>), followed by
+the message text (written as <i>[Text]</i> in the format statement). FromName is linked to a search on that name, while InReplyTo links to the email message that it refers to. 
 "
 
Index: collections/documented-examples/trunk/image-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/image-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/image-e/etc/collect.cfg	(revision 19786)
@@ -299,5 +299,6 @@
 <p>
 <!-- _text1_ -->
-
+The images in this collection have been produced by members of the Department of Computer Science, University of Waikato.
+The University of Waikato holds copyright. They may be distributed freely, without any restrictions.
 
 <h3>ÐÐ°Ðº ÑÐ°Ð±ÐŸÑÐ°ÐµÑ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ</h3>
Index: collections/documented-examples/trunk/isis-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/isis-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/isis-e/etc/collect.cfg	(revision 19786)
@@ -393,4 +393,6 @@
  CDS/ISIS. 
 <!-- _text1_ -->
+These databases have several files, but ISISPlugin uses just three: CDS.fdt (where CDS is the name of the database), containing the field names used in the database, CDF.xrf (a cross-reference file), and CDS.mst, containing the actual records. Whenever ISISPlugin encounters an \".mst\" file, it looks for the corresponding \".fdt\" and \".xrf\" files.
+
 Ð ÑÑÐŸÐŒ ÑÐ»ÑÑÐ°Ðµ Ð¿Ð»Ð°Ð³ÐžÐœ Ð±ÑÐ» ÐŽÐ°Ðœ Ð¿Ð°ÑÐ°ÐŒÐµÑÑ <i>input_encoding</i>, Ð¿ÐŸÑÐºÐŸÐ»ÑÐºÑ ÐœÐµÐºÐŸÑÐŸÑÑÐµ Ð·Ð°Ð¿ÐžÑÐž Ð² Ð±Ð°Ð·Ðµ ÐŽÐ°ÐœÐœÑÑ
  ÑÐŸÐŽÐµÑÐ¶Ð°Ñ Ð·ÐœÐ°ÐºÐž ÑÐ°ÑÑÐžÑÐµÐœÐžÑ ( Ð² ÑÐŸÑÐŒÐµ, ÐºÐŸÑÐŸÑÐ°Ñ ÐžÑÐ¿ÐŸÐ»ÑÐ·ÐŸÐ²Ð°Ð»Ð°ÑÑ Ð² ÑÐ°ÐœÐœÐžÑ
@@ -398,4 +400,7 @@
  ÐŸÐ¿ÐµÑÐ°ÑÐžÐŸÐœÐœÐŸÐ¹ ÑÐžÑÑÐµÐŒÑ DOS). ÐÐŒÑ ÑÐ°ÐºÐ¶Ðµ Ð±ÑÐ» ÐŽÐ°Ðœ Ð¿Ð°ÑÐ°ÐŒÐµÑÑ ÑÐ°Ð·ÐŽÐµÐ»ÐµÐœÐžÑ, ÑÐµÐ»Ñ ÐºÐŸÑÐŸÑÐŸÐ³ÐŸ ÐŸÐ±ÑÑÑÐœÑÐµÑÑÑ ÐœÐžÐ¶Ðµ.
 <!-- _text2_ -->
+The <i>-OIDtype incremental</i> plugin option was used to give identifiers
+that are consistent across different operating systems (which may not happen with HASH identifiers), so that we can link to a document in
+this description.
 <p>
 ÐÐŸÐŽÐŸÐ±ÐœÐŸ <a href=\"_gwcgi_?l=_cgiargl_&a=p&p=about&c=documented-examples/bibtex-e\">Ð±ÐžÐ±Ð»ÐžÐŸÐ³ÑÐ°ÑÐžÑÐµÑÐºÐŸÐ¹ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž</a>, ÑÑÐ° ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ Ð²ÐºÐ»ÑÑÐ°ÐµÑ Ð±Ð»Ð°ÐœÐŸÑÐœÑÐ¹ <a href=\"_gwcgi_?l=_cgiargl_&a=q&c=_cgiargc_&ct=1&qto=3&qt=1\">ÐžÐœÑÐµÑÑÐµÐ¹Ñ Ð¿ÐŸÐžÑÐºÐ°</a>, ÐºÐŸÑÐŸÑÑÐ¹ Ð¿ÐŸÐ·Ð²ÐŸÐ»ÑÐµÑ Ð¿ÑÐŸÐžÐ·Ð²ÐŸÐŽÐžÑÑ Ð¿ÐŸÐžÑÐº Ð¿ÐŸ Ð¿ÐŸÐ»ÑÐŒ. Ð­ÑÐŸ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÐµÐœÐŸ ÑÑÑÐŸÐºÐŸÐ¹ <i>format SearchTypes \"form,plain\"</i> Ð² ÐºÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÐŸÐŒ ÑÐ°Ð¹Ð»Ðµ; Ð¿Ð°ÑÐ°ÐŒÐµÑÑ <i>plain</i> Ð³Ð°ÑÐ°ÐœÑÐžÑÑÐµÑ, ÑÑÐŸ Ð·ÐŽÐµÑÑ ÐžÐŒÐµÐµÑÑÑ ÑÐ°ÐºÐ¶Ðµ Ð¿ÑÐŸÑÑÐŸÐµ ÑÑÐµÐŽÑÑÐ²ÐŸ Ð¿ÐŸÐ»ÐœÐŸÐ³ÐŸ ÑÐµÐºÑÑÐŸÐ²ÐŸÐ³ÐŸ Ð¿ÐŸÐžÑÐºÐ° (ÐºÐŸÑÐŸÑÐŸÐµ ÐŒÐŸÐ¶ÐµÑ Ð±ÑÑÑ Ð²Ð·ÑÑÐŸ ÐžÐ· ÑÑÑÐ°ÐœÐžÑÑ <a href=\"_gwcgi_?l=_cgiargl_&a=p&c=_cgiargc_&p=preferences\">ÐÑÐµÐŽÐ¿ÐŸÑÑÐµÐœÐžÐ¹</a>). Ð¡ÑÑÐŸÐºÐ° <i>groupsize 100</i> ÐŸÐ±ÑÐµÐŽÐžÐœÑÐµÑ ÐŽÐŸÐºÑÐŒÐµÐœÑÑ Ð² Ð³ÑÑÐ¿Ð¿Ñ Ð¿ÐŸ 100 (ÐºÐ°Ðº ÐŸÐ±ÑÑÑÐœÐµÐœÐŸ Ð² <a href=\"_gwcgi_?l=_cgiargl_&a=p&p=about&c=documented-examples/bibtex-e\">Ð±ÐžÐ±Ð»ÐžÐŸÐ³ÑÐ°ÑÐžÑÐµÑÐºÐŸÐ¹ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž</a>).
Index: collections/documented-examples/trunk/marc-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/marc-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/marc-e/etc/collect.cfg	(revision 19786)
@@ -188,8 +188,11 @@
 
 <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>ÐÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÑÐ¹ ÑÐ°Ð¹Ð»</a> ÐžÑÐ¿ÐŸÐ»ÑÐ·ÑÐµÑ Ð¿Ð»Ð°Ð³ÐžÐœÑ <i>ZIPPlug</i> Ðž <i>MARCPlug</i>, Ð¿ÐŸÐŒÐžÐŒÐŸ ÑÑÐµÑÑÐµÐ³ÐŸ ÑÑÐ°ÐœÐŽÐ°ÑÑÐ°. ÐÐŒÐµÑÑÑÑ ÑÑÐž ÐºÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑÐ°, ÐŸÑÐœÐŸÐ²Ð°ÐœÐœÑÐµ ÐœÐ° ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
- <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÑ (dc.Title)</i>, <i>Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»Ñ (dc.Creator)</i> Ðž <i>ÐÑÐµÐŽÐŒÐµÑÐ° (dc.Subject)</i>. <!-- _text1_ --> Ð­ÑÐŸ ÑÑÐµÐ±ÑÐµÑ ÑÑÑÐ°ÐœÐŸÐ²ÐºÐž PERL ÐŽÐ»Ñ Ð¿ÑÐ°Ð²ÐžÐ»ÑÐœÐŸÐ³ÐŸ Ð²ÑÑÐ°Ð¶ÐµÐœÐžÑ, Ðž ÑÑÐµÐ·Ð°ÐµÑ Ð·ÐœÐ°ÐºÐž (ÑÐžÐ¿Ð° ÐºÐŸÐœÐµÑÐœÑÑ
+ <i>ÐÐ°Ð·Ð²Ð°ÐœÐžÑ (dc.Title)</i>, <i>Ð¡ÐŸÐ·ÐŽÐ°ÑÐµÐ»Ñ (dc.Creator)</i> Ðž <i>ÐÑÐµÐŽÐŒÐµÑÐ° (dc.Subject)</i>. <!-- _text1_ -->The <i>dc.Title</i> classifier is an AZList, while the other two are AZCompactList, which groups items with the same metadata into a bookshelf. The <i>-removesuffix</i> argument for the <i>Title</i> and <i>Creator</i>
+classifiers removes suffixes from the metadata string (<i>dc.Title</i> and
+<i>dc.Creator</i> respectively). Ð­ÑÐŸ ÑÑÐµÐ±ÑÐµÑ ÑÑÑÐ°ÐœÐŸÐ²ÐºÐž PERL ÐŽÐ»Ñ Ð¿ÑÐ°Ð²ÐžÐ»ÑÐœÐŸÐ³ÐŸ Ð²ÑÑÐ°Ð¶ÐµÐœÐžÑ, Ðž ÑÑÐµÐ·Ð°ÐµÑ Ð·ÐœÐ°ÐºÐž (ÑÐžÐ¿Ð° ÐºÐŸÐœÐµÑÐœÑÑ
  Ð·ÐœÐ°ÐºÐŸÐ² Ð¿ÑÐµÐ¿ÐžÐœÐ°ÐœÐžÑ) ÐžÐ· ÑÑÑÐŸÐºÐž ÐŽÐ»Ñ ÐŸÑÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÑ.
 <p>
 <!-- _text2_ -->
+The <i>VList</i> format statement controls the display of search results and all classifiers. For bookshelves, the number of leaf documents is displayed on the right-hand side. For documents, <i>dc.Title</i> is displayed, along with <i>dc.Creator</i> and <i>dc.Publisher</i>. <i>[sibling:dc.Creator]</i> is used as dc.Creator has multiple values, and specifies that all values be output, not just the first one.
 <p>
 
@@ -208,4 +211,18 @@
 
 <!-- _text3_ -->
+Multiple MARC fields may map to a single Dublin Core field. 
+For example, fields 720 (\"Uncontrolled name\"), 100 (\"Personal name\"), 
+110 (\"Corporate name\") and  111 (\"Meeting name\") all map to 
+<i>dc.Creator</i>. Actual MARC records normally
+define only one of these fields, and anyway Greenstone allows
+multi-valued metadata.\n
+<p>
+Some mappings are dependent on subfields. For example, MARC field 260 contains
+information about publication and distribution. Subfields \"c\" (Date of Publication) and \"g\" (Date of manufacture) are mapped to <i>dc.Date</i>, using the following mapping line:
+<blockquote>
+260$c$g     -&gt; dc.Date
+</blockquote>
+
+Greenstone also provides a file for mapping MARC to <b>qualified</b> dublin core: <a href=\"_httpprefix_/etc/marc2qdc.txt\" target=marc2qdc>greenstone/etc/marc2qdc.txt</a>. This can be used by the MARC plugin by setting the <i>-metadata_mapping_file</i> option to \"marc2qdc.txt\".
 "
 
Index: collections/documented-examples/trunk/oai-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/oai-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/oai-e/etc/collect.cfg	(revision 19786)
@@ -395,19 +395,39 @@
 
 ÐÐ°Ðº ÑÐŸÐ»ÑÐºÐŸ ÐžÐœÑÐŸÑÐŒÐ°ÑÐžÑ ÐžÐ· ÐAI ÐžÐŒÐ¿ÐŸÑÑÐžÑÐŸÐ²Ð°ÐœÐ°, ÐºÐŸÐ»Ð»ÐµÐºÑÐžÑ ÐŸÐ±ÑÐ°Ð±Ð°ÑÑÐ²Ð°ÐµÑÑÑ ÐŸÐ±ÑÑÐœÑÐŒ ÑÐ¿ÐŸÑÐŸÐ±ÐŸÐŒ. ÐÐŸÐœÑÐžÐ³ÑÑÐ°ÑÐžÐŸÐœÐœÑÐ¹ ÑÐ°Ð¹Ð» ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ Ð¿Ð»Ð°Ð³ÐžÐœ OAI, ÐºÐŸÑÐŸÑÑÐ¹ ÐŸÐ±ÑÐ°Ð±Ð°ÑÑÐ²Ð°ÐµÑ ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ OAI, Ðž Ð¿Ð»Ð°Ð³ÐžÐœ ÐžÐ·ÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÐ¹, Ð¿ÐŸÑÐºÐŸÐ»ÑÐºÑ Ð² ÑÑÐŸÐŒ ÑÐ»ÑÑÐ°Ðµ ÐŽÐŸÐºÑÐŒÐµÐœÑÑ ÐžÑÑ
-ÐŸÐŽÐœÐŸÐ¹ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž  - ÑÑÐŸ ÑÐ°Ð¹Ð»Ñ ÐžÐ·ÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÐ¹. <!-- _text1_ -->Greenstone ÐŸÐ±ÑÑÐœÐŸ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ ÑÐ·ÑÐº ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ² Ð°Ð²ÑÐŸÐŒÐ°ÑÐžÑÐµÑÐºÐž, ÐœÐŸ ÑÑÐž Ð·Ð°Ð¿ÐžÑÐž ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
+ÐŸÐŽÐœÐŸÐ¹ ÐºÐŸÐ»Ð»ÐµÐºÑÐžÐž  - ÑÑÐŸ ÑÐ°Ð¹Ð»Ñ ÐžÐ·ÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÐ¹. 
+<!-- _text1_ -->
+Besides the four standard plugins (GreenstoneXMLPlugin, MetadataXMLPlugin, ArchivesInfPlugin and DirectoryPlugin), 
+the configuration file specifies the OAI plugin, which processes OAI
+metadata, and the image plugin, because in this case the collection\'s source
+documents are image files.  
+Greenstone ÐŸÐ±ÑÑÐœÐŸ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ ÑÐ·ÑÐº ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ² Ð°Ð²ÑÐŸÐŒÐ°ÑÐžÑÐµÑÐºÐž, ÐœÐŸ ÑÑÐž Ð·Ð°Ð¿ÐžÑÐž ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
  ÑÐ²Ð»ÑÑÑÑÑ ÑÐ»ÐžÑÐºÐŸÐŒ ÐœÐµÐ±ÐŸÐ»ÑÑÐžÐŒÐž ÐŽÐ»Ñ ÑÐŸÐ³ÐŸ, ÑÑÐŸÐ±Ñ ÑÑÐŸ ÑÐŽÐµÐ»Ð°ÑÑ ÐœÐ°ÐŽÐµÐ¶ÐœÐŸ: Ð¿ÐŸÑÑÐŸÐŒÑ Ð°ÐœÐ³Ð»ÐžÐ¹ÑÐºÐžÐ¹ ÑÐ·ÑÐº ÐŸÐ¿ÑÐµÐŽÐµÐ»ÐµÐœ ÑÐ²ÐœÐŸ Ð² Ð¿Ð°ÑÐ°ÐŒÐµÑÑÐµ <i>ÑÐ·ÑÐºÐ°</i> (<i>language</i>). ÐÐ»Ð°Ð³ÐžÐœÑ ÐAI Ð°ÐœÐ°Ð»ÐžÐ·ÐžÑÑÑÑ  ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÐµ Ðž Ð¿ÐµÑÐµÑÑÐ»Ð°ÑÑ ÐžÑ
  Ðº ÑÐŸÐŸÑÐ²ÐµÑÑÑÐ²ÑÑÑÐµÐŒÑ ÑÐ°Ð¹Ð»Ñ ÐžÑÑ
 ÐŸÐŽÐœÐŸÐ³ÐŸ ÐŽÐŸÐºÑÐŒÐµÐœÑÐ°, ÐºÐŸÑÐŸÑÑÐ¹ Ð·Ð°ÑÐµÐŒ ÐŸÐ±ÑÐ°Ð±Ð°ÑÑÐ²Ð°ÐµÑÑÑ ÑÐŸÐŸÑÐ²ÐµÑÑÑÐ²ÑÑÑÐžÐŒ Ð¿Ð»Ð°Ð³ÐžÐœÐŸÐŒ -- Ð² ÐŽÐ°ÐœÐœÐŸÐŒ ÑÐ»ÑÑÐ°Ðµ <i>ImagePlugin</i>. Ð­ÑÐŸÑ Ð¿Ð»Ð°Ð³ÐžÐœ ÐŸÐ¿ÑÐµÐŽÐµÐ»ÑÐµÑ ÑÐ°Ð·Ð»ÐžÑÐœÑÐµ Ð²ÐµÑÑÐžÐž ÑÐ°Ð·ÑÐµÑÐµÐœÐžÑ ÐžÐ·ÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÑ ÐœÐ° ÑÐºÑÐ°ÐœÐµ.
 
-<!--
-<p>
-_text2_
-
-<p>
-_text3_
--->
-
-<p>
-
+<p>
+<!--_text2_-->
+Extracted metadata from OAI records are mapped to Dublin Core Metadata Set by default.
+As a result, classifiers and indexes in this collection are built with Dublin meatadata elements.
+
+<p>
+<!-- _text4_ -->
+The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
+configuration file</a> has a single full-text index containing
+<i>dc.Description</i> metadata. When a document is displayed, the
+<i>DocumentHeading</i> format statement puts out its <i>dc.Subject</i>. Then the
+<i>DocumentText</i> statement follows this with <i>screenicon</i>, which is
+produced by <i>ImagePlugin</i> and gives a screen-resolution version of the
+image; it is hyperlinked to the <i>dc.OrigURL</i> metadata -- that is, the original
+version of the image on the remote OAI site. This is followed by the image\'s
+<i>dc.Description</i>, also with a hyperlink; the image\'s size and type, again
+generated as metadata by <i>ImagePlugin</i>; and then <i>dc.Subject</i>,
+<i>dc.Publisher</i>,
+and <i>dc.Rights</i> metadata.
+<a href=_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=search&d=_sampleoid_>This</a>
+is the result.\n
+
+
+<p>
 ÐÐŒÐµÐµÑÑÑ ÐŽÐ²Ð° ÐºÐ»Ð°ÑÑÐžÑÐžÐºÐ°ÑÐŸÑÐ° Ð¿ÑÐŸÑÐŒÐŸÑÑÐ°, ÐŸÐŽÐžÐœ ÐžÐ· ÐºÐŸÑÐŸÑÑÑ
  ÐŸÑÐœÐŸÐ²Ð°Ðœ ÐœÐ° ÐŒÐµÑÐ°ÐŽÐ°ÐœÐœÑÑ
@@ -441,4 +461,8 @@
 <p>
 <!-- _text3_ -->
+<p>
+Greenstone's OAI server currently supports Dublin Core, qualified Dublin Core and rfc1807 metadata sets. The <i>oaimetadata</i> line specifies which sets should be used. For collections that use other metadata sets, 
+metadata mapping rules should be provided to map the existing metadata 
+to the sets in use. See the <i>oai.cfg</i> file for details.\n
 "
 
Index: collections/documented-examples/trunk/text-for-translation.txt
===================================================================
--- collections/documented-examples/trunk/text-for-translation.txt	(revision 19719)
+++ collections/documented-examples/trunk/text-for-translation.txt	(revision 19786)
@@ -211,2 +211,17 @@
 metadata mapping rules should be provided to map the existing metadata 
 to the sets in use. See the <i>oai.cfg</i> file for details.\n
+
+oai._text4_:The <a href=\"_httpcollection_/etc/collect.cfg\" target=collect.cfg>collection
+configuration file</a> has a single full-text index containing
+<i>dc.Description</i> metadata. When a document is displayed, the
+<i>DocumentHeading</i> format statement puts out its <i>dc.Subject</i>. Then the
+<i>DocumentText</i> statement follows this with <i>screenicon</i>, which is
+produced by <i>ImagePlugin</i> and gives a screen-resolution version of the
+image; it is hyperlinked to the <i>dc.OrigURL</i> metadata -- that is, the original
+version of the image on the remote OAI site. This is followed by the image\'s
+<i>dc.Description</i>, also with a hyperlink; the image\'s size and type, again
+generated as metadata by <i>ImagePlugin</i>; and then <i>dc.Subject</i>,
+<i>dc.Publisher</i>,
+and <i>dc.Rights</i> metadata.
+<a href=_gwcgi_?l=_cgiargl_&a=d&c=_cgiargc_&cl=search&d=_sampleoid_>This</a>
+is the result.\n
Index: collections/documented-examples/trunk/wrdpdf-e/etc/collect.cfg
===================================================================
--- collections/documented-examples/trunk/wrdpdf-e/etc/collect.cfg	(revision 19719)
+++ collections/documented-examples/trunk/wrdpdf-e/etc/collect.cfg	(revision 19786)
@@ -235,5 +235,11 @@
  ÐŽÐŸÐºÑÐŒÐµÐœÑÐŸÐ² Word (ÐœÐ°Ð¿ÑÐžÐŒÐµÑ, ÐŸÑ ÑÑÐ°ÑÑÑ
  ÑÐžÑÑÐµÐŒ ÐÐ°ÐºÐžÐœÑÐŸÑÐ°), Ðž ÐžÐœÐŸÐ³ÐŽÐ° ÑÐµÐºÑÑ ÑÐ¶Ð°ÑÐœÐŸ ÐžÐ·Ð²Ð»ÐµÐºÐ°ÐµÑÑÑ. ÐÐµÐºÐŸÑÐŸÑÑÐµ PDF ÑÐ°Ð¹Ð»Ñ ÐœÐµ ÑÐŸÐ·ÐŽÐ°ÑÑ ÐœÐžÐºÐ°ÐºÐŸÐ³ÐŸ ÐŒÐ°ÑÐžÐœÐœÐŸÑÐžÑÐ°ÐµÐŒÐŸÐ³ÐŸ ÑÐµÐºÑÑÐ° Ð²ÐŸÐŸÐ±ÑÐµ, Ð° Ð²ÐŒÐµÑÑÐŸ ÑÑÐŸÐ³ÐŸ Ð²ÐºÐ»ÑÑÐ°ÑÑ Ð¿ÐŸÑÐ»ÐµÐŽÐŸÐ²Ð°ÑÐµÐ»ÑÐœÐŸÑÑÑ <i>ÐžÐ·ÐŸÐ±ÑÐ°Ð¶ÐµÐœÐžÐ¹</i> ÑÑÑÐ°ÐœÐžÑÑ, ÐžÐ· ÐºÐŸÑÐŸÑÑÑ
- ÑÐµÐºÑÑ ÐŒÐŸÐ¶ÐµÑ Ð±ÑÑÑ ÐžÐ·Ð²Ð»ÐµÑÐµÐœ ÑÐŸÐ»ÑÐºÐŸ Ð¿ÑÑÐµÐŒ ÐŸÐ¿ÑÐžÑÐµÑÐºÐŸÐ³ÐŸ ÑÐ°ÑÐ¿ÐŸÐ·ÐœÐ°Ð²Ð°ÐœÐžÑ (OCR), ÑÑÐŸ Ð² Greenstone ÐœÐµ Ð¿ÑÐµÐŽÑÑÐŒÐŸÑÑÐµÐœÐŸ. <!-- _text1_ -->
+ ÑÐµÐºÑÑ ÐŒÐŸÐ¶ÐµÑ Ð±ÑÑÑ ÐžÐ·Ð²Ð»ÐµÑÐµÐœ ÑÐŸÐ»ÑÐºÐŸ Ð¿ÑÑÐµÐŒ ÐŸÐ¿ÑÐžÑÐµÑÐºÐŸÐ³ÐŸ ÑÐ°ÑÐ¿ÐŸÐ·ÐœÐ°Ð²Ð°ÐœÐžÑ (OCR), ÑÑÐŸ Ð² Greenstone ÐœÐµ Ð¿ÑÐµÐŽÑÑÐŒÐŸÑÑÐµÐœÐŸ. 
+<!-- _text1_ -->
+If you encounter these problems, you
+can either remove the offending documents from your collection, or try using
+some of the advanced plugin options to process the documents in different ways.
+For more information, see the Enhanced PDf and Word tutorials on the  
+<a href=\'http://wiki.greenstone.org/wiki/index.php/Tutorial_exercises\'>Greenstone wiki</a>.
 <p>
 
