--- storage/meta/meta-format.tex	2010/12/20 15:49:05	1.28
+++ storage/meta/meta-format.tex	2011/08/01 10:36:19	1.30
@@ -3,10 +3,10 @@
 \usepackage[latin1]{inputenc}
 \usepackage[T1]{fontenc}
 \usepackage{ae}
-%\usepackage{times}
-%\usepackage{courier}
+\usepackage{times}
+\usepackage{courier}
 
-% create in-text links black (with PDF)
+% create in-text links in black (with PDF)
 \usepackage[colorlinks=true,linkcolor=black]{hyperref}
 % Format URLs nicely (without PDF)
 %\usepackage{url}
@@ -16,7 +16,7 @@
 
 \author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess}
 
-\date{V1.3.9 of 20.12.2010}
+\date{V1.4.0 of 1.8.2011}
 
 \begin{document}
 
@@ -710,6 +710,7 @@ with detailed information about the manu
 \item [bib type="codex"] Codex i.e. bound collection of one or more manuscripts.
 
   \begin{description}
+%TODO: do we need collection information?
   \item[holding-library] Holding library.
   \item[call-number] Call number/Shelf mark in holding library.
   \item[location] Place/City/Country where the codex is
@@ -745,7 +746,7 @@ with detailed information about the manu
   \item [place] place where the letter was written/sent.
   \item [title] Title of the letter -- optional.
   \item[incipit] The opening phrase of the letter -- optional.
-  \item[excipit] The closing phrase of the letter -- optional.
+  \item[explicit] The closing phrase of the letter -- optional.
   \item [pages] Number of pages of the manuscript.
   \item [signature] Canonical signature/call number of the manuscript.
   \item [description] This can be any kind of description.
@@ -791,32 +792,6 @@ with detailed information about the manu
 \end{description}
 
 
-\subsection{Architectural drawings}
-\label{sec:doc}
-
-Specific information for architectural drawings is presented in a
-\texttt{doc} container with an additional \texttt{type} attribute
-giving the type of drawing. All elements inside the container can
-appear multiple times.
-
-\begin{description}
-
-\item[doc type="Architectural Drawing"] architectural drawing.
-
-  \begin{description}
-  \item [person] last name and first name of a person, separated by a
-    comma. A further common name for the person can be put infront,
-    separated by a semicolon.
-  \item [location] Name of a place in its common notation. This can be
-    a city or a institution.
-  \item [date] This can be a year (or several years, separated by
-    commas) or a period (1706-1714). Years are noted with four digits.
-  \item [object] Short description of an object or signatures.
-  \item [keywords] Keywords related to the object.
-\end{description}
-\end{description}
-
-
 \subsection{Document structure (table of contents)}
 \label{sec:toc}
 
@@ -824,7 +799,7 @@ Information on the structure of a docume
 parts and chapters in the way of a table of contents is presented in a
 \texttt{toc} container. 
 
-The scheme allows multiple logical pages on a single page image
+This scheme allows multiple logical pages on a single page image
 as it is often the case with scanned books or manuscripts. The scheme
 also allows for ``loose'' numbering schemes with roman, arabic or
 other page numbers consecutively or mixed and changes in the numbering
@@ -851,11 +826,14 @@ tags.
       like ``Table 5''.
       
     \item[index] the \texttt{digilib} index number\footnote{The index
-        number for digilib is the index in the alphabetical order of the
+        number for digilib is the index in the alphabetical ordering of the
         scan file names.} of the scan image of the page.
+
+    \item[file] alternatively the file name (preferrably without extension) of the
+      scan image of the page.
       
-    \item[url] alternatively to the \texttt{digilib} index number the
-      full URL of the scan image of the page can be used.
+    \item[url] alternatively the full URL of the scan image of the
+      page can be used.
     \end{description}
     
   \item[chapter] describes a section or chapter of the text.
@@ -875,6 +853,8 @@ tags.
       \item[name] the ``name'' of the first page (see \texttt{page}).
         
       \item[index] the index of the first page (see \texttt{page}).
+
+      \item[file] the file name of the first page (see \texttt{page}).
         
       \item[url] the URL of the first page (see \texttt{page}).
       \end{description}
@@ -886,6 +866,8 @@ tags.
       \item[name] the ``name'' of the last page (see \texttt{page}).
         
       \item[index] the index of the last page (see \texttt{page}).
+
+      \item[file] the file name of the first page (see \texttt{page}).
         
       \item[url] the URL of the last page (see \texttt{page}).
       \end{description}
@@ -987,13 +969,14 @@ digital image.
 \subsection{Full text with images}
 \label{sec:full-text-with}
 
+The relation between a full text and optional images of
+whole pages or parts of pages must be specified in a
+\texttt{texttool} container.
+
 Full text in a XML format should be specified with a
 \texttt{content-type}\footnote{see section~\ref{tag-content-type}
 on page\pageref{tag-content-type}} ``fulltext''.
 
-The relation between the full text and optional images of
-whole pages or parts of pages must be specified in a
-\texttt{texttool} container.
 
 \begin{description}
 \item[texttool] representation of full text with images
@@ -1012,6 +995,19 @@ whole pages or parts of pages must be sp
   \item[figure] the directory name of the directory containig the
     in-page figure image files (path inside document directory)
 
+  \item[page-flow] the reading direction of pages in this document:
+    either ``ltr'' (left-to-right, standard western page flow) or
+    ``rtl'' (right-to-left, still assuming increasing page numbers)
+
+ \item[odd-scan-orientation] the orientation of all odd-numbered scan
+    pages regardless of \texttt{page-flow}: either ``left'' (all
+    odd-numbered scans are left hand sides) or ``right'' (all
+    odd-numbered scans are right hand sides, i.e. the first left hand
+    side is scan number 2).
+
+  \item[title-scan-no] the index number of the scan of the title page or the
+    first text page
+
   \item[xslt] the file name of an additional XSL transformation
     file