--- storage/meta/meta-format.tex	2010/08/27 15:30:21	1.23
+++ storage/meta/meta-format.tex	2011/08/01 09:12:47	1.29
@@ -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.7 of 27.8.2010}
+\date{V1.3.9 of 20.12.2010}
 
 \begin{document}
 
@@ -172,6 +172,21 @@ The outer container element is \texttt{r
   of this resource to the linked resource -- optional.
   \end{description}
   
+\item[is-part-of] Container for the description of another resource if this 
+  resource is a part of the other resource.  -- optional. It can have a 
+  \texttt{type} attribute describing the type of relation .e.g. ``manuscript-codex''.
+
+  \begin{description}
+  \item[archive-id] The ID of the original resource
+    -- required (or archive-path).
+
+  \item[archive-path] The full path to the original resource
+    -- required (or archive-id).
+
+  \item[description] An informal textual description of the relation
+  of this resource to the original resource -- optional.
+  \end{description}
+  
 \item[media-type] \label{tag-media-type} The main media type of this
   resource -- required.\\ The main media type can be overridden by
   \texttt{media-type}s in subdirectories. Possible types are
@@ -298,8 +313,8 @@ Metadata elements can appear multiple ti
   The content type enables the choice of tools to manipulate and
   display the resource. There should be a common list of content
   types. For digital documents (books, manuscripts) this would be
-  "scanned document", for other image data "scanned
-  images".\footnote{The criterion for documents is a ordered
+  ``scanned document'', for other image data ``scanned
+  images''.\footnote{The criterion for documents is a ordered
     succession of image files (pages) and equal image size and
     resolution throughout the images of a resource.}
 \end{description}  
@@ -652,68 +667,67 @@ with detailed information about the manu
   \begin{description}
   \item [title] Title of the manuscript.
   \item [author] The author of the text.
-   \item[holding-library] Holding library
-   \item[call-number] Call number/Shelf mark in holding library
+   \item[holding-library] Holding library.
+   \item[call-number] Call number/Shelf mark in holding library.
   \item[location] Place/City/Country where the manuscript is
     currently located.
   \item[date calendar="type"] The date of publication with attribute which
   calendar used. If no attribute used, CE is the default. Can also be
   descriptive.
-  \item[year calendar="type"] approximate year or century 
+  \item[year calendar="type"] Approximate year or century .
   \item[number-of-folios] Number of folios/pages of the manuscript.
   \item[signature] Signature(s) of the manuscript, under which a manuscript is
   known.
-  \item[abstract] Interpretative abstract of the text's content
-  \item[incipit] Incipit
-  \item[explicit] Explicit
+  \item[abstract] Interpretative abstract of the text's content.
+  \item[incipit] Incipit (beginning of text).
+  \item[explicit] Explicit (end of text).
   \item[contents] Formal description of the text structure (e.g. table of
-  contents)
-  \item[writing-surface] material of the writing surface (e.g. non-european
-  paper, palm leaf,\ldots)
-  \item[foliation] Text giving list or range of folios 
-  \item[page-dimensions] height and width in cm
-  \item[written-area-dimensions] height and width in cm
-  \item[lines-per-page] number of lines and columns
-  \item[catchwords] Quire signatures and catchwords
-  \item[scripts] Description of the script
-  \item[copyist] Copyist
-  \item[collation-corrections] Notes on collation and corrections
-  \item[binding] Binding
-  \item[notes] Additional notes
+  contents).
+  \item[writing-surface] material of the writing surface (e.g. ``non-european
+  paper'', ``palm leaf'',\ldots)
+  \item[foliation] Text giving list or range of folios. 
+  \item[page-dimensions] height and width in cm.
+  \item[written-area-dimensions] height and width in cm.
+  \item[lines-per-page] number of lines and columns.
+  \item[catchwords] Quire signatures and catchwords.
+  \item[scripts] Description of the script and the ink used.
+  \item[copyist] Copyist.
+  \item[collation-corrections] Notes on collation and corrections.
+  \item[binding] Description of binding.
+  \item[notes-on-ownership] Notes on ownership.
+  \item[notes] Additional notes.
   \item[secondary-literature] Notes on secondary literature related to the
-  manuscript
+    manuscript
   \item [editorial-remarks] Remarks related to the online
     publication of the manuscript.
-
   \item [keywords] Keywords related to the manuscript.
- 
- 
   \end{description}
 \end{description}
 
 \subsubsection{Codex}
 
 \begin{description}
-\item [bib type="codex"] Codex
+\item [bib type="codex"] Codex i.e. bound collection of one or more manuscripts.
 
   \begin{description}
-  
-   \item[holding-library] Holding library
-   \item[call-number] Call number/Shelf mark in holding library
+%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
     currently located.
   \item[date calendar="type"] Date of the collation of the codex.
-  \item[year calendar="type"] approximate year or century 
+  \item[year calendar="type"] Approximate year or century .
   \item[number-of-folios] Number of folios/pages of the manuscript.
+  \item[foliation] Text giving list or range of folios.
   \item[signature] Signature(s) of the manuscript, under which a manuscript is
   known.
   \item[contents] Formal description of the text structure (e.g. table of
-  contents)
-  \item[dimensions] height + width in cm
-   \item[binding] Binding
-  \item[notes] Additional notes
-  \item[notes-on-ownership] Notes on ownership
-  \end{description}
+  contents).
+  \item[dimensions] height + width in cm.
+  \item[binding] Description of binding.
+  \item[notes] Additional notes.
+  \item[notes-on-ownership] Notes on ownership.
+ \end{description}
 \end{description}
 
 
@@ -732,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.
@@ -778,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}
 
@@ -1019,11 +1007,19 @@ documented in this container.
 
 \begin{description}
 \item[access-conditions] legal and technical conditions for access to
-  this resource
+  this resource. \\
+  The \texttt{attribution}, \texttt{copyright}, and \texttt{access}
+  tags can be repeated with different \texttt{resource} attributes if
+  different conditions apply to different parts of the whole resource.
 
   \begin{description}
   \item[attribution] The name or institution this resource should be
-    attributed to when it's publicly presented
+    attributed to when it's publicly presented. \\
+    The kind of resource this condition applies to can be specified with a
+    \texttt{resource} attribute with the values ``original'' (the
+    physical object that was scanned), ``digital-image'' (the scanned
+    images), ``text'' (the textual transcript). \\
+    All tags inside can be repeated.
 
     \begin{description}
     \item[name] a name (free text)
@@ -1035,14 +1031,19 @@ documented in this container.
       library call number)
     \end{description}
 
-  \item[copyright] the copyright holder and it's conditions
+  \item[copyright] the copyright holder and the copyright conditions. \\
+    The kind of resource this condition applies to can be specified with a
+    \texttt{resource} attribute with the values ``original'' (the physical object 
+    that was scanned), ``digital-image'' (the scanned images), ``text'' 
+    (the textual transcript).
+
     \begin{description}
     \item[owner] the name of the copyright holder
       \begin{description}
       \item[name] a name (free text)
 
       \item[url] a URL (with an optional \texttt{label} attribute to show
-        as text)
+        as text) identifying the copyright holder
       \end{description}
 
     \item[date] the date when the copyright was issued
@@ -1051,17 +1052,20 @@ documented in this container.
 
     \item[description] free-text field for special or additional
       conditions
+    \item[license] the type of license if its a standardised license e.g. Creative Commons
+      \begin{description}
+      \item[url] a URL representing the license e.g. \url{http://creativecommons.org/licenses/by/3.0/}
+      \end{description}
+
     \end{description}
 
 
-  \item[publish-metadata] metadata about this resource can be made
-    freely available when this tag is present (otherwise metadata has
-    the same access conditions as the rest of the resource). Access to
-    the resource itself is regulated separately by the \texttt{access}
-    element.
+ \item[access] conditions of access to this resource. Different
+    access types are specified by a \texttt{type} attribute.
+    The kind of resource this condition applies to can be specified with a
+    \texttt{resource} attribute with the values ``digital-image'' (the
+    scanned images), or ``text'' (the textual transcript).
 
-  \item[access] conditions of access to this resource. Different
-    access types are specified by a \texttt{type} attribute:
     \begin{description}
     \item[type=group] access restricted to the members of this named
       group. The method to identify a user belonging to a named group