Master Project

The MASTER Document Type Definition: reference manual

2.8 Additional information


Up: 2 The Manuscript Description Element Previous: 2.7 History Next: 2.9 Manuscript Parts

Contents

Four categories of additional information are provided for by the scheme described here, grouped together within the <additional> element described in this section.

<additional> groups additional information relating to the modern bibliography for a manuscript, its current curatorial status, and and other associated materials.
<adminInfo> contains information about the present custody and availability of the manuscript, and also about the record description itself. 2.8.1 Administrative Information
<surrogates> contains information about any digital or photographic representations of the manuscript being described which may exist in the holding institution or elsewhere. 2.8.2 Surrogates
<accMat> contains details of any significant additional material which may be closely associated with the manuscript being described, such as non-contemporaneous documents or fragments bound in with the manuscript at some earlier historical period.2.8.2 Surrogates
<listBibl> lists bibliographic descriptions of publications relating to the manuscript (standard TEI element)

None of the constituent elements of <additional> is required. If any is supplied, it may appear once only; furthermore, the order in which elements are supplied should be as specified above.

The <additional> element is formally defined as follows:

2.8.1 Administrative Information

A variety of information relating to the curation and management of a manuscript may be recorded as simple prose narrative tagged using the standard <p> element. Alternatively, different aspects of this information may be presented grouped within one or more of the following specialized elements:

<recordHist> provides information about the source and revision status of the parent manuscript description itself.
<custodialHist> contains a description of a manuscript's custodial history, either as running prose or as a series of dated custodial events.
<availability> supplies information about the availability of a manuscript, for example any restrictions on its use or access, its copyright status, etc. (standard TEI element)
<remarks> contains any comments or remarks not forming part of the description proper, for use by the cataloguer.

<!-- to be supplied-->

2.8.1.1 Record History

The <recordHist> element, if supplied, must contain a <source> element, followed by an optional series of <change> elements.

<source> describes the original source for the information contained with a manuscript description.
<change> summarizes any change in the record history, specifying a date, a responsibility statement, and a description of the change (standard TEI element)

The <source> element is used to document the primary source of information for the catalogue record containing it, in a similar way to the standard TEI <sourceDesc> element within a TEI Header. If the record is a new one, catalogued without reference to anything other than the manuscript itself, then it may simply contain a <p> element as in the following example:

<source><p>Directly catalogued from the original manuscript</p></source>

More usually however the record will be derived from some previously existing catalogue, which may be specified using the standard TEI <bibl> element, as in the following example:

<source><p>Information transcribed from 
<bibl><title>IMEV</title><biblScope>1234</biblScope></bibl>
</p></source>

If, as is likely, a full bibliographic description of the source from which cataloguing information was taken is included within the <listBibl> element contained by the current <additional> element, or elsewhere in the current document, then it need not be repeated here. Instead, it should be referenced using the standard TEI <ref> element, as in the following example:

<additional>
<recordHist>
<source><p>Information transcribed from 
<ref target="IMEV123">IMEV 123</ref>
</p></source>
</recordHist>
<!-- ... -->
<listBibl>
<bibl id="IMEV123">
<title>Index of Medieval Verse</title>
<!-- other bibliographic details for IMEV here -->
<biblScope>123</biblScope>
</bibl>
<!-- other bibliographic records relating to this manuscript here -->
</listBibl>
</additional>

The <change> element is a standard TEI element, which may also appear within the <revisionDesc> element of the standard TEI Header; its use here is intended to signal the similarity of function between the two container elements. Where the TEI Header should be used to document the revision history of the whole electronic file to which it is prefixed, the <recordHist> element may be used to document changes at a lower level, relating to the individual description, as in the following example:

<!-- to be supplied -->

2.8.1.2 Availability and custodial history

The <availability> element is a standard TEI element, which should be used here to supply any information concerning access to the current manuscript, such as its physical location where this is not implicit in its identifier, any restrictions on access, information about copyright, etc.


<availability><p>The manuscript is in poor condition, due to many of
the leaves being brittle and fragile and the poor quality of a number
of earlier repairs; it should therefore not be used or lent out until
it has been conserved.</p></availability>

The <custodialHist> record is used to describe the custodial history of a manuscript, recording any significant events noted during the period that it has been located within the cataloguing institution. It may contain either a series of paragraphs tagged with the standard TEI <p> element, or a series of <custEvent> elements, each describing a distinct incident or event, further specified by a type attribute, and carrying dating information by virtue of its membership in the datable class, as noted above.

<custEvent> describes a single event during the custodial history of a manuscript or manuscript.
Attributes include any convenient typology may be used
type specifies the type of event, for example conservation, photography, exhibition, etc.
Datatype: CDATA
Default: #IMPLIED

Here is an example of the use of this element:

<custodialHist>
<custEvent type="conservation" notBefore="1961-03" notAfter="1963-02">
<p>Conserved between March 1961 and February 1963 at Birgitte Dalls 
Konserveringsv&aelig;rksted.</p></custEvent>
<custEvent type="photography" notBefore="1988-05-01" notAfter="1988-05-30">
<p>Photographed in May 1988 by AMI/FA.</p></custEvent>
<custEvent type="transfer/dispatch" notBefore="1989-11-13" notAfter="1989-11-13" >
<p>Dispatched to Iceland 13 November 1989.</p></custEvent>
</custodialHist>

2.8.1.3 Cataloguer's notes

It may occasionally be convenient to include detailed comments or notes which are not properly part of the manuscript description. The <remarks> element is provided for this purpose.

<remarks> contains any comments or remarks not forming part of the description proper, for use by the cataloguer.
<remarks>
<p>Re ff. 33-36v:  According to Leroquais, the feast of Corpus
Christi with its octave was instituted for Franciscans in 1319; 
the hymn here is the standard Tantum ergo.</p>

<p> Re a photo:  Yes, do one, since the manuscript is signed and dated! 
How about f. 7v (nice cadelled initials, and f. 18 with Clare 
has already been reproduced elsewhere).</p>
</remarks>

2.8.1.4 Formal definitions

The <adminInfo> element and its immediate component elements are formally defined as follows:

2.8.2 Surrogates

The <surrogates> element is used to provide information about any digital or photographic representations of the manuscript which may exist within the holding institution or elsewhere.

<surrogates> contains information about any digital or photographic representations of the manuscript being described which may exist in the holding institution or elsewhere.

The <surrogates> element should not be used to repeat information about representations of the manuscript available within published works; this should normally be documented within the <listBibl> element within the <additional> element. However, it is often also convenient to record information such as negative numbers, digital identifiers etc. for unpublished collections of manuscript images maintained within the holding institution, as well as to provide more detailed descriptive information about the surrogate itself. Such information may be provided as prose paragraphs, within which identifying information about particular surrogates may be presented using the standard TEI <bibl> element, as in the following example:

<surrogates><p>
<bibl>
  <title type="gmd">diapositive</title>
  <idno>AM 74 a, fol.</idno>
   <date>May 1984</date>
</bibl>
<bibl>
  <title type="gmd">b/w prints</title>
  <idno>AM 75 a, fol.</idno>
   <date>1972</date>
</bibl>
</p></surrogates>
Note the use of the specialised form of GMD (general material designation) title to specify the kind of surrogate being documented.

At a later revision, the content of the <surrogates> element is likely to be expanded to include elements more specifically intended to provide detailed information such as technical details of the process by which a digital or photographic image was made.

If the whole of a manuscript is being digitized, it should be contained in a separate document which lists all the images using <div> etc. to structure them. In such a case, the <msDescription> placed within the teiHeader.

The <surrogates> element is formally defined as follows:

2.8.3 Accompanying material

The circumstance commonly arises where a manuscript has additional material, not originally part of the manuscript, which is bound with it or otherwise accompanying the manuscript. In cases where this is clearly a distinct manuscript, the whole manuscript should be treated as a composite manuscript and the additional matter described in a separate <msPart> (see 2.9 Manuscript Parts below). However, there are cases where the additional matter is not self-evidently a distinct manuscript: it might be an important set of notes by a later scholar or owner, or it might be a file of correspondence relating to the manuscript. The <accMat> element is provided as a holder for this kind of information:

<accMat> contains details of any significant additional material which may be closely associated with the manuscript being described, such as non-contemporaneous documents or fragments bound in with the manuscript at some earlier historical period.
Attributes include any convenient typology may be used
type further characterizes the accompanying material, for example as letter, note, paste-in, etc.
Datatype: CDATA
Default: #IMPLIED

Here is an example of the use of this element, describing a note by the Icelandic manuscript collector &Aacute;rni Magn&uacute;sson which has been bound with the manuscript:

<accMat>
<p>A slip in &amp;Aacute;rni Magn&amp;uacute;sson's hand has been stuck to the
pastedown on the inside front cover; the text reads:
<q lang="IS">&amp;THORN;idreks S&amp;oslash;gu &amp;thorn;essa hefi eg 
feiged af Sekreterer Wielandt Anno 1715 
i Kaupmanna h&amp;oslash;fn.  Hun er, sem eg sie, Copia af Austfirda
b&amp;oacute;kinni (Eidag&amp;aacute;s) en<expan>n</expan> ecki progenies
Br&amp;aelig;dratungu bokarinnar. Og er &amp;thorn;ar fyrer eigi i
allan<expan>n</expan> m&amp;aacute;ta samhlioda
&amp;thorn;<expan>eir</expan>re er Sr Jon Erlendz son hefer ritad fyrer
Mag. Bryniolf. &amp;THORN;esse &amp;THORN;idreks Saga mun vera komin fra Sr
Vigfuse &amp;aacute; Helgafelle.</q></p>
</accMat>

The formal definition for the <accMat> element is as follows:

Up: 2 The Manuscript Description Element Previous: 2.7 History Next: 2.9 Manuscript Parts



(revised 21 Jun 01)   Edited by Lou Burnard for the MASTER Work Group.
Copyright TEI Consortium 2001