Le son & accord des cloches pendans en ung mesme axe, est faict en contraires parties.

LEs cloches ont quasi figures de rondes pyramides imperfaictes & irregulieres: & leur accord se fait par reigle geometrique. Comme si les deux cloches C & D sont pendans à ung mesme axe ou essieu A B: je dis que leur accord se fera en contraires parties comme voyez icy figuré. Car quand lune sera en hault, laultre declinera embas. Aultrement si elles declinent toutes deux ensembles en une mesme partie, elles seront discord, & sera leur sonnerie mal plaisante à oyr.

De Geometrie 49

Advanced Uses of surface and zone

As a child of sourceDoc, the surface element both identifies a specific area containing writing and provides a two dimensional set of coordinates which can be used to position and define dimensions for sub-parts of it. In the context of three-dimensional objects, the surface element also provides a three-dimensional set of points which can be used to define the dimensions of the object. Furthermore, surfaces may nest within other surfaces, as in the case of patches or other written materials attached to the main writing surface. In the general case, the position and dimensions of such nested surfaces will be defined using the same coordinate system as that supplied by the parent surface element. It is also possible, however, that a different coordinate system is required for such a nested surface, perhaps because it requires a more complex granularity. We consider both possibilities.

In the earlier examples showing nested examples we did not provide any coordinate information, for simplicity of presentation. Suppose however, that we wish to indicate the position and sizes of the newspaper scraps in above, relative to the whole page. As previously noted, the four attributes ulx, uly, lrx and lry when given on the surface element define the coordinate scheme, rather than specifying the location of that surface. We must therefore introduce an additional zone element, as in the following revised encoding for this example Poem As in Visions of — at night — All sorts of fancies running through the head Spring has just set in here, and the weather[...] a steamer 2 In this version of the encoding, the inner surface, corresponding with the first piece of newsprint, inherits locational information from the zone element that contains it. This zone, and the preceding one, which contains a sequence of line elements, are both positioned in terms of the coordinates specified on the outermost surface element, which defines a scale running from 0 to 50 in either direction. On that scale, the line elements occupy a rectangle with coordinates (1,1,10,10), while the nested surface occupies a rectangle with coordinates (4,4,20,20).

Now suppose that we wish to define a finer scale grid for the newspaper patch, perhaps because we wish to localize zones within it with greater accuracy. To do this we will need to specify the position of the nested surface as in the previous example, but also to define the new coordinate system. We accomplish this as follows: Poem the head Spring has just set in here, and the weather [...] a steamer As before, the second zone defines the position and size of the newspaper patch itself in terms of a coordinate system running from 0 to 50 on both X and Y axes. The nested surface element however defines a new scale for all of its components, running from 0 to 100 on both X and Y axes. The position of the nested zone containing the text Spring ... steamer is now given in terms of this scale.

All of the examples so far given have involved rectangular zones, for clarity of exposition. As noted above, the points attribute may be used to define non-rectangular zones as a series of points. For example, in the last of the Whitman examples discussed in section above, we might wish to record the exact shape of the zone containing the metamark Entered. Since this is not a rectangular zone, we use the points attribute to indicate the points defining a polygon which contains it. The values used are expressed in terms of a coordinate space running from 0 to 229 in the X dimension, and 0 to 160 in the Y dimension.

In exactly the same way, we may wish to identify the curved zone in the following image containing the word Northamptonshire:

Gravestone of Private Moulds

This curved zone might be encoded in the following way:

It should be noted that a zone does not need to be entirely contained within the two-dimensional space defined by its parent surface. For example, we might wish to encode the example in above not as a surface representing the whole of the two page spread, but as a surface representing only the written part of this opening. The written part appears 50 units from the left of the image and 20 units from the top, while the bottom right corner of the written part appears 400 units from the left of the image, and 280 units from the top. We therefore define the written surface within this image as follows: To describe the whole image, we will now need to define a zone of interest which represents an area larger than this surface. Using the same coordinate system as that defined for the surface, its coordinates are 0,0,500,321. This zone of interest can be defined by a zone element, within which we can place the uncropped graphic:

Finally, if you are using the surface and zone elements to encode a three-dimensional object, it is essential to include the Z-axis as well as the X- and Y- axes. You can represent the spatial information of a three-dimensional object using the points attribute to construct a polygonal shape. When you are using the surface and zone elements in a three-dimensional context, the surface element represents the surface of the entire three-dimensional object. The graphic element can then be used to reference an image or three-dimensional model of the object. All the zones of interest on the object can be defined using the zone element. For example, if a monument features both a relief and an inscription, the zone element can be used to delineate each feature respectively. You can use the points attribute on a zone element to represent the three-dimensional spatial information for these zones of interest.

Dis Manibus MI R XXXXVII stipendiorum XXVIII Iulius Martialis duplicarius alae Britannicae heres Ermius libertus eius

Core Elements for Transcriptional Work

In transcribing individual sources of any type, encoders may record corrections, normalizations, additions, and omissions using the elements described in section . Representation of abbreviations and their expansions may also involve use of elements described in section . Elements particularly relevant to this chapter include:

All of these elements bear additional attributes for specifying who is responsible for the interpretation represented by the markup, and the associated certainty. In addition, some of them bear an attribute allowing the markup to be categorized by type and source. The specific aspect of the markup described by these attributes differs on different elements; for further discussion, see the relevant sections below, especially section .

The following sections describe how the core elements just named may be used in the transcription of primary source materials.

Abbreviation and Expansion

The writing of manuscripts by hand lends itself to the use of abbreviation to shorten scribal labour. Commonly occurring letters, groups of letters, words, or even whole phrases, may be represented by significant marks. This phenomenon of manuscript abbreviation is so widespread and so various that no taxonomy of it is here attempted. Instead, methods are shown which allow abbreviations to be encoded using the core elements mentioned above.

A manuscript abbreviation may be viewed in two ways. One may transcribe it as a particular sequence of letters or marks upon the page: thus, a p with a bar through the descender, a superscript hook, a macron. One may also interpret the abbreviation in terms of the letter or letters it is seen as standing for: thus, per, re, n. Both of these views are supported by these Guidelines.

In many cases the glyph found in the manuscript source also exists in the Unicode character set: for example the common Latin brevigraph ⁊, standing for et and often known as the Tironian et can be directly represented in any XML document as the Unicode character with code point U+204A (see further and ). In cases where it does not, these Guidelines recommend use of the g element provided by the gaiji module described in chapter . This module allows the encoder great flexibility both in processing and in documenting non-standard characters or glyphs, including the ability to provide detailed documentation and images for them.

These two methods of coding abbreviation may also be combined. An encoder may record, for any abbreviation, both the sequence of letters or marks which constitutes it, and its sense, that is, the letter or letters for which it is believed to stand. For example, in the following fragment the phrase euery persone is represented by a sequence of abbreviated characters:

Detail from fol. 126v of Bodleian MS Laud Misc 517

These lines may be transcribed directly, using the g element to indicate the two brevigraphs as follows: euery persone that loketh after heuen hath a place in this ladder Note that in each case the g element may contain a suggested replacement for the referenced brevigraph; this is purely advisory however, and may not be appropriate in all cases. The referenced character definitions may be located elsewhere in this or some other document, typically forming part of a charDecl element, as described in .

The transcriber may also wish to indicate that, because of the presence of these particular characters, the two words are actually abbreviations, by using the abbr element: euery persone ... Alternatively, the transcriber may choose silently to expand these abbreviations, using the expan element: euery persone ... And, of course, the choice element can be used to show that one encoding is an alternative for the other: eueryeuery

When abbreviated forms such as these are expanded, two processes are carried out: some characters not present in the abbreviation are added (always), and some characters or glyphs present in the abbreviation are omitted or replaced (often). For example, when the abbreviation Dr. is expanded to Doctor, the dot in the abbreviation is removed, and the letters octo are added. Where detailed markup of abbreviated words is required, these two aspects may be marked up explicitly, using the following elements: Using these elements, a transcriber may indicate the status of the individual letters or signs within both the abbreviation and the expansion. The am element surrounds characters or signs such as tittles or tildes, used to indicate the presence of an abbreviation, which are typically removed or replaced by other characters in the expanded form of the abbreviation: euy sone ... while the ex element may be used to indicate those characters within the expansion which are not present in the abbreviated form. euery persone ... The content of the abbr element should usually include the whole of the abbreviated word, while the expan element should include the whole of its expansion. If this is not considered necessary, the am and ex elements may be used within a choice element, as in this example: euery persone ...

As implied in the preceding discussion, making decisions about which of these various methods of representing abbreviation to use will form an important part of an encoder's practice. As a rule, the abbr and am elements should be preferred where it is wished to signify that the content of the element is an abbreviation, without necessarily indicating what the abbreviation may stand for. The ex and expan elements should be used where it is wished to signify that the content of the element is not present in the source but has been supplied by the transcriber, without necessarily indicating the abbreviation used in the original. The decision as to which course of action is appropriate may vary from abbreviation to abbreviation; there is no requirement that the same system be used throughout a transcription, although doing so will generally simplify processing. The choice is likely to be a matter of editorial policy. If the highest priority is to transcribe the text literatim (letter by letter), while indicating the presence of abbreviations, the choice will be to use abbr or am throughout. If the highest priority is to present a reading transcription, while indicating that some letters or words are not actually present in the original, the choice will be to use ex or expan throughout.

Further information may be attached to instances of these elements by the note element, on which see section , and by use of the resp and cert attributes. In this instance from the English , a note is attached to an editorial expansion of the tail on the final d of good to goode: For alle the while that I had goode I was welbeloued Then the note: The stroke added to the final d could signify the plural ending (-es, -is, -ys>) but the singular goode was used with the meaning property, wealth, at this time (v. examples quoted in OED, sb. Good, C. 7, b, c, d and 8 spec.) The editor might declare a degree of certainty for this expansion, based on the OED examples, and state the responsibility for the expansion: For alle the while that I had goode I was welbeloued The value supplied for the resp attribute should point to the name of the editor responsible for this and possibly other interventions; an appropriate element therefore might be a respStmt element in the header like the following: Editorial emendations Malcom Parkes Observe that the cert and resp attributes are used with the ex element only to indicate confidence in the content of the element (i.e. the expansion), and responsibility for suggesting this expansion respectively.

The choice element may be used to indicate that the proposed expansion is one way of encoding what might equally well be represented as an abbreviation, represented by the hooked D, as follows: For alle the while that I had gooɗ goode I was welbeloued If it is desired to express aspects of certainty and responsibility for some other aspect of the use of these elements, then the mechanisms discussed in chapter should be used. See also for discussion of the issues of certainty and responsibility in the context of transcription.

If more than one expansion for the same abbreviation is to be recorded, multiple notes may be supplied. It may also be appropriate to use the markup for critical apparatus; an example is given in section .

Correction and Conjecture

The sic, corr, and choice elements, defined in the core module should be used to indicate passages deemed in need of correction, or actually corrected, during the transcription of a source. For example, in the manuscript of William James's as edited by Fredson Bowers (Cambridge: Harvard University Press, 1977), a sentence first written One must have lived longer with this system, to appreciate its advantages. has been modified by James to begin But One must ..., without the initial capital O having been reduced to lowercase. This non-standard orthography could be recorded thus: But One must have lived ... or corrected: But one must have lived ... or the two possibilities might be represented as a choice: But Oneone must have lived ...

Similarly, in this example from Albertus Magnus, both a manuscript error angues and its correction augens are registered within a choice element: Nos autem iam ostendimus quod nutrimentum et anguesaugens.

Note that the corr element is used to provide a corrected form which is not present in the source; in the case of a correction made in the source itself, whether scribal, authorial, or by some other hand, the add, del, and subst elements described in should be used.

The sic element is used to mark passages considered by the transcriber to be erroneous; in such cases, the corr element indicates the transcriber's correction of them. Where the transcriber considers that one or more words have been erroneously omitted in the original source and corrects this omission, the supplied element discussed in should be used in preference to corr. Thus, in the following example, from George Moore's draft of additional materials for , the transcriber supplies the word we omitted by the author: You see that I avoid the word create for we create nothing we develope.

As with expan and abbr, the choice as to whether to record simply that there is an apparent error, or simply that a correction has been applied, or to record both possible readings within a choice element is left to the encoder. The decision is likely to be a matter of editorial policy, which might be applied consistently throughout or decided case by case. If the highest priority is to present an uncorrected transcription while noting perceived errors in the original, the choice will typically be to use only sic throughout. If the highest priority is to present a reading transcription, while indicating that perceived errors in the original have been corrected, the choice will be to use only corr throughout.

Further information may be attached to instances of these elements by the note element and resp and cert attributes. Instances of these elements may also be classified according to any convenient typology using the type attribute.

For example, consider the following encoding of an emendation in the Hengwrt manuscript proposed by E. Talbot Donaldson: Telle me also, to what conclusioun Were membres maad, of generacioun And of so parfit wis a wightwright ywroght? This emendation of the Hengwrt copy text, based on a Latin source and on the reading of three late and usually unauthoritative manuscripts, was proposed by E. Talbot Donaldson in 40 (1965) 626–33. The note element discussed in may be used to give a more detailed discussion of the motivation for or scope of a correction. If linked by means of a pointer (as in this example) it may be located anywhere convenient within the transcription; typically all detailed notes will be collected together in a separate div element in the back. Alternatively, the pointer may be omitted, and the note placed immediately adjacent to the element being annotated. The advantage of the former solution is that it permits the same annotation to refer to several corrections, by supplying more than one pointer in the target attribute of the note, as shown in the example below.

The attribute cert may be used to indicate the degree of confidence ascribed by the encoder to the proposed emendation on a broad scale: high, medium, or low. The attribute resp is used to indicate who is responsible for the proposed emendation. Its value is a pointer, which will typically indicate a respStmt or name element in the header of the transcribed document, but can point anywhere, for example to some online authority file. Using these two attributes, the corr element presented above might usefully be enhanced as follows: E Talbot Donaldson And of so parfit wis a wightwright ywroght?

As remarked above, where the same annotation applies to several corrections, this may be represented by supplying multiple pointers on the note. Consider for example such corrections as the following, in Dudo of S. Quentin. Parkes cites two cases in this manuscript of the same phenomenon: quamuis mensiners que nutu dei gesta sunt ... unde esset uiriliter uegetatanegata which may be described as follows: Substitution of a more familiar word which resembles graphically what the scribe should be copying but which does not make sense in the context.

The target attribute on the note element indicates the choice elements which exemplify this kind of scribal error. This necessitates the addition of an identifier to each choice element. However, if the number of corrections is large and the number of notes is small, it may well be both more practical and more appropriate to regard the collection of annotations as constituting a typology and then use the type attribute. Suppose that the note given above is one of half a dozen possible kinds of corrected phenomena identified in a given text; others might include, say, repetition of a word from the preceding line, etc. The type attribute on the corr element can be used to specify an arbitrary code for the particular kind of correction (or other editorial intervention) identified within it. This code can be chosen freely and is not treated as a pointer. quamuis mensiners que nutu dei gesta sunt ... unde esset uiriliter uegetatanegata Note that this encoding might be extended to include a range of possible corrections: quamuis mensinersinres que nutu dei gesta sunt ... In addition, the conscientious encoder will provide documentation explaining the circumstances in which particular codes are judged appropriate. A suitable location for this might be within the correction element of the encodingDesc of the header, which might include a list such as the following:

The following codes are used to categorize corrections identified in this transcription: graphSubs Substitution of a more familiar word which resembles graphically what the scribe should be copying but which does not make sense in the context.

A subtype attribute may be used in conjunction with the type for subclassification purposes: the above examples might thus be represented as choice type="substitution" subtype="graphicResemblance" for example.

For a given project, it may well be desirable to limit the possible values for the type or subtype attributes automatically. This is easily done but requires customization of the TEI system using techniques described in , in particular , which should be consulted for further information on this topic.

When making a correction in a source which forms part of a textual tradition attested by many witnesses, a textual editor will sometimes use a reading from one witness to correct the reading of the source text. In the general case, such encoding is best achieved with the mechanisms provided by the module for textual criticism described in chapter . However, for simple cases, the source attribute of the corr element may suffice. In the passage from Chaucer's mentioned above, Parkes proposes to emend the problematic word wight to wyf which is the reading found in the Cambridge manuscript Gg.1. 27. This may be simply represented as follows: And of so parfit wis a wightwyf ywroght? The value of the source attribute here is, like the value of the resp attribute, a pointer, in this case indicating the manuscript used as a witness. Elsewhere in the transcribed text, a list of witnesses used in this text will be given, one of which has an identifier Gg. Each witness will be represented either by a witness element (see ) or more fully by an msDesc element (see ): Cambridge University Library Gg.1. 27

The app element described in chapter provides a more powerful way of representing all three possible readings in parallel: And of so parfit wis a wight wright wyf

This encoding simply records the three readings found in the various traditions, and gives (by means of the wit attribute) an indication of the witnesses supporting each. If the resp attribute were supplied on the rdg element, it would indicate the person responsible for asserting that the manuscript indicated has this reading, who is not necessarily the same as the person responsible for asserting that this reading should be used to correct the others. Editorial intervention elements such as corr can however be nested within a rdg to provide this additional information: And of so parfit wis a wight wright wyf This encoding asserts that the reading wyf found in Gg is regarded as a correction by Parkes.

Like the resp attribute, the cert attribute may be used with both corr and rdg elements. When used on the rdg element, these attributes indicate confidence in and responsibility for identifying the reading within the sources specified; when used on the corr element they indicate confidence in and responsibility for the use of the reading to correct the base text. If no other source is indicated (either by the source attribute, or by the wit attribute of a parent rdg), the reading supplied within a corr has been provided by the person indicated by the resp attribute.

If it is desired to express certainty of or responsibility for some other aspect of the use of these elements, then the mechanisms discussed in chapter may be found useful. See also for further discussion of the issues of certainty and responsibility in the context of transcription.

Additions and Deletions

Additions and deletions observed in a source text may be described using the following elements: Of these, add and del are included in the core module, while addSpan and delSpan are available only when using the module defined in this chapter. These particular elements are members of the att.spanning class, from which they inherit the following attribute:

Further characteristics of each addition and deletion, such as the hand used, its effect (complete or incomplete, for example), or its position in a sequence of such operations may conveniently be recorded as attributes of these elements, all of which are members of the att.transcriptional class:

As described in section , the add element is used to record any manuscript addition observed in the text, whether it is considered to be authorial or scribal. In the autograph manuscript of Max Beerbohm's , the author's addition of do ever may be recorded as follows, with the hand attribute indicating that the addition was Beerbohm's by referencing a handNote element defined elsewhere in the document (see further ): Some things are best at first sight. Others — and here is one of them — do ever improve by recognition [...] Max Beerbohm holograph

The del element is used to record manuscript deletions in a similar way. In the autograph manuscript of D. H. Lawrence's the author's deletion of my may be recorded as follows. In this case, the hand attribute indicating that the deletion was Lawrence's is complemented by a rend attribute indicating that the deletion was by strike-through: For I hate this my body, which is so dear to me ... D H Lawrence holograph

If deletions are classified systematically, the type attribute may be useful to indicate the classification; when they are classified by the manner in which they were effected, or by their appearance, however, this will lead to a certain arbitrariness in deciding whether to use the type or the rend attribute to hold the information. In general, it is recommended that the rend attribute be used for description of the appearance or method of deletion, and that the type attribute be reserved for higher level or more abstract classifications.

The place attribute is also available to indicate the location of an addition. For example, consider the following passage from a draft letter by Robert Graves:

Draft letter from Robert Graves to Desmond Flower, 17 Dec 1938 (detail).

At the end of this extract, the writer inserts the word cant, above the line, with a stroke to indicate insertion. Assuming that we have previously defined the identifier RG somewhere: , this extract might now be encoded as follows: The O.E.D. is not a dictionary so much as a corpus of precedents in the: current, obsolete, cant, cataphretic and nonce-words are all included. A little earlier in the same extract, Graves writes for an abridgement above the line, and then deletes it. This may be encoded similarly: As for 'significant artist.' You quote the O.E.D for an abridgement in explanation... Similarly, in the margin, the word Norton has been added and then deleted: You quote the Norton O.E.D... The word O.E.D. in this first sentence has also clearly been the result of some redrafting: it may be that Graves started to write Oxford, and then changed it; it may be that he inserted other punctuation marks between the letters before replacing them with the centre dots used elsewhere to represent this acronym. We do not deal with these possibilities here, and mention them only to indicate that any encoding of manuscript material of this complexity will need to make decisions about what is and is not worth mentioning.

An encoder may also wish to indicate that an addition replaces a specific deletion, that is to encode a substitution as a single intervention in the text. This may be achieved by grouping the addition and deletion together within a subst element. At the end of the passage illustrated above, Graves first writes It is the expressed..., then deletes It is, and substitutes an uppercase T at the start of the. ... are all included. It is Tthe expressed The use of this element and of the seq attribute to indicate the order in which interventions such as deletions are believed to have occurred are further discussed in section below.

The add and del elements defined in the core module suffice only for the description of additions and deletions which fit within the structure of the text being transcribed, that is, which each deletion or addition is completely contained by the structural element (paragraph, line, division) within which it occurs. Where this is not the case, for example because an individual addition or deletion involves several distinct structural subdivisions, such as poems or prose items, or otherwise crosses a structural boundary in the text being encoded, special treatment is needed. The addSpan and delSpan elements are provided by this module for that purpose. (For a general discussion of the issue see further ).

In this example of the use of addSpan, the insertion by Helgi Ólafsson of a gathering containing four neo-Eddic poems into is recorded as follows. A handNote element is first declared, within the header of the document, to associate the identifier heol with Helgi. Each of the added poems is encoded as a distinct div element. In the body of the text, an addSpan element is placed to mark the beginning of the span of added text, and an anchor is used to mark its end. The hand attribute on the addSpan element ascribes responsibility for the addition to the manuscript to Helgi, and the spanTo attribute points to the end of the added text:

The delSpan element is used in the same way. An authorial manuscript will often contain several occasions where sequences of whole lines are marked for deletion, either by boxes or by being struck out. If the encoder is marking up individual verse lines with the l element, such deletions are problematic: deletion of two consecutive lines should be regarded as a single deletion, but the del element must be properly nested within a single l element. The delSpan element solves this problem: Flowed up the hill and down King William Street, To where Saint Mary Woolnoth kept the time, With a dead sound on the final stroke of nine. There I saw one I knew, and stopped him, crying "Stetson!...

It is also often the case that deletions and additions may themselves contain other deletions and additions. For example, in Thomas Moore's autograph of the second version of two lines are marked for omission by vertical strike-through. Within the first of the two lines, the word upon has also been struck out, and the word over has been added: Tis moonlight upon over Oman's sky Her isles of pearl look lovelily In this case the anchor and delSpan have been placed within the structural elements (the ls) rather than between, as in the previous example. This is to indicate that placement of these empty elements is arbitrary.

The text deleted must be at least partially legible, in order for the encoder to be able to transcribe it. If all of part of it is not legible, the gap element should be used to indicate where text has not been transcribed, because it could not be. The unclear element described in section may be used to indicate areas of text which cannot be read with confidence. See further section and section .

Substitutions

Substitution of one word or phrase for another is perhaps the most common of all phenomena requiring special treatment in transcription of primary textual sources. It may be simply one word written over the top of another, or deletion of one word and its replacement by another written above it by the same hand on the same occasion; the deletion and replacement may be done by different hands at different times; there may be a long chain of substitutions on the same stretch of text, with uncertainty as to the order of substitution and as to which of many possible readings should be preferred.

As we have shown, the simplest method of recording a substitution is simply to record both the addition and the deletion. However, when the module defined by this chapter is in use, additional elements are available to indicate that the encoder believes the addition and the deletion to be part of the same intervention: a substitution. Using the subst element, the example at the end of the last section might be encoded as follows: Tis moonlight uponover Oman's sky Her isles of pearl look lovelily Since the purpose of this element is solely to group its child elements together, the order in which they are presented is not significant. When both deletion and addition are present, it may not always be clear which occurs first: using the seq attribute is a simple way of resolving any such ambiguities.

For example, returning to the example from William James, in a passage first written out by James as One must have lived longer with this system, to appreciate its advantages, the word this is first replaced by such a and this is then replaced by a.The manuscript contains several other substitutions, ignored here for the sake of clarity. This may be encoded as follows, representing the two changes as a sequence of additions and deletions: One must have lived longer with this such a a system, to appreciate its advantages. Note the nesting of an add element within a del to record text first added, then deleted in the source. The numbers assigned by the seq attribute may be used to identify the order in which the various additions and deletions are believed by the encoder to have been carried out, and thus provide a simple method of supporting the kind of genetic textual criticism typified by (for example) Hans Walter Gabler's work on the reconstruction of the overlay levels implicit in the manuscripts of James Joyce's . A fuller and more complex way of supporting such an approach is discussed in .

A special case of a substitution may consist of a superfluous word or phrase that is silently replaced by some addition. E.g. a scribe abandons a word (without indicating it should be deleted), and then writes a replacement word immediately after. Here the encoder may interpret this as an unmarked deletion which can then be combined with a corresponding addition to a substitution.

The case of a single substitution or scribal correction that involves non-contiguous addition and deletion can be handled by using the substJoin element to make an explicit connection between one or more add and del elements. In the following example from Thomas Moore's Lalla Rookh, the deletion and addition are not contiguous: they are separated by the word thus, which is not part of the scribal intervention being marked. Because of this intervening text, it would be inappropriate to use subst to group this add and del. substJoin allows the encoder to indicate that additions and deletions separated in this way are part of a single scribal intervention: While pondering thus she mus'd, her pinions fann'd Note that, unlike subst, the placement of the substJoin is arbitrary. It may occur before or after the relevant add and del elements.

As a more complex example, consider the following passage:

Detail from autograph manuscript in the English Faculty Library, Oxford University.

This passage might be encoded as follows: And towards our distant rest began to trudge, Helping the worst amongst usDragging the worst amongt us, who'd no boots But limped on, blood-shod. All went lame; half-all blind; Drunk with fatigue ; deaf even to the hoots Of tired, outstripped fif five-nines that dropped behind. In this representation, the authorial slip (amongt for amongst) is retained without comment. the other two authorial corrections are marked as substitutions, each combining a deletion and an addition. the false start fif in the last line is simply marked as a deletion;

The app element presented in chapter provides similar facilities, by treating each state of the text as a distinct reading. The rdg element has a varSeq attribute which may be used in the same way as the seq attribute to indicate the preferred sequence. The James example above might thus be represented as follows: One must have lived longer with this such a a system, to appreciate its advantages.

Cancellation of Deletions and Other Markings

An author or scribe may mark a word or phrase in some way, and then on reflection decide to cancel the marking. For example, text may be marked for deletion and the deletion then cancelled, thus restoring the deleted text. Such cancellation may be indicated by the restore element:

This element bears the same attributes as the other transcriptional elements. These may be used to supply further information such as the hand in which the restoration is carried out, the type of restoration, and the person responsible for identifying the restoration as such, in the same way as elsewhere.

Presume that Lawrence decided to restore my to the phrase of first written For I hate this my body, with the my first deleted then restored by writing stet in the margin. This may be encoded: For I hate this my body

Another feature commonly encountered in manuscripts is the use of circles, lines, or arrows to indicate transposition of material from one point in the text to another. No specific markup for this phenomenon is proposed at this time. Such cases are most simply encoded as additions at the point of insertion and deletions at the point of encirclement or other marking.

Text Omitted from or Supplied in the Transcription

Where text is not transcribed, whether because of damage to the original, or because it is illegible, or for some other reason such as editorial policy, the gap core element may be used to register the omission; where such text is transcribed, but the editor wishes to indicate that they consider it to be superfluous, for example because it is an inadvertent scribal repetition or an interpolation from another source, the surplus element may be used in preference. Where the editor believes text to be interpolated but genuine, the secl element may be used instead. Where text not present in the source is supplied (whether conjecturally or from other witnesses) to fill an apparent gap in the text, the supplied element may be used.

By its nature, the gap element has no content. It marks a point in the text where nothing at all can be read, whether because of authorial or scribal erasure, physical damage, or any other form of illegibility. Its attributes allow the encoder to specify the amount of text which is illegible in this way at this point, using any convenient units, where this can be determined. For example, in the Beerbohm manuscript of cited above, the author has erased a passage amounting about 10 cm in length by inking over it completely: Others —and here is one of them...

In an autograph letter of Sydney Smith now in the Pierpont Morgan library three words in the signature are quite illegible: I am dr Sr yr Sydney Smith The degree of precision attempted when measuring the size of a gap will vary with the purpose of the encoding and the nature of the material: no particular recommendation is made here.

As noted above, the gap element should only be used where text has not been transcribed. If partially legible text has been transcribed, one of the elements damage and unclear should be used instead (these elements are described in section ); if the text is legible and has been transcribed, but the editor wishes to indicate that they regard it is superfluous or redundant, then the element surplus may be used in preference to the core element sic used to indicate text regarded as erroneous.

Amongst the many examples cited in Hans Krummrey & Silvio Panciera's classic text on the editing of epigraphic inscriptions is the following. In a late classical inscription, the form dedikararunt is encountered. The editor may choose any of the following three possibilities:

mark this as an erroneous form dedikararunt additionally supply a corrected form dedikararunt dedikarunt indicate that the erroneous form contains surplus characters which the editor wishes to suppress dedikararunt

The surplus element may also be used to mark up interpolations, as in the following example taken from a 13th century Italian source: a darmi morte, poi m'avete preso a tradimento sì com' l'uccellator prende l'uccello e lettere dintorno che diriano in questa guisa Più v'amo, dëa, che non faccio Deo The words marked as surplus here are metrically inconsistent with the rest and have been marked by the editor as such.

In the case of an interpolation which the editor regards as genuine (i.e. written by the author in question), but out of its original place, the secl element should be used instead of surplus. For example: Great praise and thanks be to Perfidy as she deserves, since by our swindles, tricks, and clever moves, relying on the daring of our shoulder blades and the excellence of our forearms who went against cattle-prods, hot iron-blades, crosses and shackles, neck-irons, chains, prisons, collars, fetters, and yokes, the fiercest painters fully acquainted with our backs who have often before put scars on our shoulder blades ... The final line is bracketed in the Loeb edition, with a note: versum secl. Bothe, meaning Bothe regarded this line as Plautine, but probably interpolated. It is easy to see how the line might have crept in as a gloss on the metaphor in the previous line.

If some part of the source text is completely illegible or missing, an encoder may sometimes wish to supply new (conjectural) material to replace it. This conjectural reading is analogous to a correction in that it contains text provided by the encoder and not attested in the source. This is not however a correction, since no error is necessarily present in the original; for that reason a different element supplied should be used. If another (imaginary) copy of the letter above preserved the signature as reading I am dear Sir your very humble Servt Sydney Smith, the text illegible in the autograph might be supplied in the transcription: I am dr Sr yr very humble Servt Sydney Smith Here the source and resp attributes are used, as elsewhere, to indicate respectively the sigil of a manuscript from which the supplied reading has been taken, and the identifier of the person responsible for deciding to supply the text. If the source attribute is not supplied, the implication is that the encoder (or whoever is indicated by the value of the resp attribute) has supplied the missing reading. Both gap and supplied may be used in combination with unclear, damage, and other elements; for discussion, see section .

Document Hands

For many text-critical purposes it is important to signal the person responsible (the hand) for the writing of a whole document, a stretch of text within a document, or a particular feature within the document. A hand, as the name suggests, need not necessarily be identified with a particular known (or unknown) scribe or author; it may simply indicate a particular combination of writing features recognized within one or more documents. The examples given above of the use of the hand attribute with coding of additions and deletions illustrate this.

The handNote element is used to provide information about each hand distinguished within the encoded document.

A handNote element, with an identifier given by its xml:id attribute, may appear in either of two places in the TEI header, depending on which modules are included in a schema. When the transcr module defined by the present chapter is used, the element handNotes is available, within the profileDesc element of the TEI header, to hold one or more handNote elements. When the msdescription module defined in chapter is included, the handDesc element described in also becomes available as part of a structured manuscript description. The encoder may choose to place handNote elements identifying individual hands in either location without affecting their accessibility since the element is always addressed by means of its xml:id attribute. The handDesc element may be more appropriate when a full cataloguing of each manuscript is required; the handNotes element if only a brief characterization of each hand is needed. It is also possible to use the two elements together if, for example, the handDesc element contains a single summary describing all the hands discursively, while the handNotes element gives specific details of each. The choice will depend on individual encoders' priorities.

As shown above, the hand attribute is available on several elements to indicate the hand in which the content of the element (usually a deletion or addition) is carried out. The handShift element may also be used within the body of a transcription to indicate where a change of hand is detected for whatever reason.

A handShift element can be used to indicate a change of hand even within an element with a hand attribute. The text following the handShift must be considered to be in the new hand.

Both handShift and handNote are members of the att.handFeatures class, and thus share the following attributes:

A single hand may employ different writing styles and inks within a document, or may change character. For example, the writing style might shift from anglicana to secretary, or the ink from blue to brown, or the character of the hand may change. Simple changes of this kind may be indicated by assigning a new value to the appropriate attribute within the handShift element. It is for the encoder to decide whether a change in these properties of the writing style is so marked as to require treatment as a distinct hand.

Where such a change is to be identified, the new attribute indicates the hand applicable to the material following the handShift. The sequence of such handShift elements will often, but not necessarily, correspond with the order in which the material was originally written. Where this is not the case, the facilities described in section may be found helpful.

As might be expected, a single hand may also vary renditions within the same writing style, for example medieval scribes often indicate a structural division by emboldening all the words within a line. Such changes should be indicated by use of the rend attribute, in the same manner as underlining, emboldening, font shifts, etc. are represented in transcription of a printed text, rather than by introducing a new handShift element.

In the following example there is a change of ink within a single hand. This is simply indicated by a new value for the medium attribute on the handShift element: When wolde the cat dwelle in his ynne And if the cattes skynne be slyk and gaye

In the following example, the encoder has identified two distinct hands within the document and given them identifiers h1 and h2, by means of the following declarations included in the document's TEI header: Carefully written with regular descenders Unschooled scrawl

Then the change of hand is indicated in the text: ... and that good Order Decency and regular worship may be once more introduced and Established in this Parish according to the Rules and Ceremonies of the Church of England and as under a good Consciencious and sober Curate there would and ought to be and for that purpose the parishioners pray

When a more precise or nuanced discussion of the writing in a manuscript is required, the handNote and scriptNote elements discussed in should be used. Either element may serve as the target for a handShift.

Hand, Responsibility, and Certainty Attributes

The hand and resp attributes have similar, but not identical, meanings. Observe their distinctive uses in the following encoding of the William James passage mentioned above in section . In this example, the But inserted by James is tagged as an add, and the consequent editorial correction of One to one treated separately: But Oneone must have lived ... editorial changes Fredson Bowers authorial changes William James As in this example, hand should be reserved for indicating the hand of any form of marking—here, addition but also deletion, correction, annotation, underlining, etc.—within the primary text being transcribed. The scribal or authorial responsibility for this marking may be inferred from the value of the hand attribute. The value of the hand attribute should be a pointer to a hand identifiers typically declared in the document header but potentially in another document or repository (see section ).

The resp attribute, by contrast, indicates the person responsible for deciding to mark up this part of the text with this particular element. In the case of the add element, for example, the resp attribute will indicate the responsibility for identifying that the addition is indeed an addition, and also (if the hand attribute is supplied) to which hand it should be attributed. In this case, Bowers is credited with identifying the hand as that of William James. In the case of the corr element, the resp attribute indicates who is responsible for supplying the intellectual content of the correction reported in the transcription: here, Bowers' correction of One to one. In the case of a deletion, the resp attribute will similarly indicate who bears responsibility for identifying or categorizing the deletion itself, while other attributes (hand most obviously) attribute responsibility for the deletion itself. It should be noted that the source attribute may be used in a simiilar fashion to indicate, for example, when an encoding decision is based on the work of a previous editor or on an article. In that case, the source would point to a bibl in the bibliography.

In cases where both the resp and cert attributes are defined for a particular element, the two attributes refer to the same aspect of the markup. The one indicates who is intellectually responsible for some item of information, the other indicates the degree of confidence in the information. Thus, for a correction, the resp attribute signifies the person responsible for supplying the correction, while the cert attribute signifies the degree of editorial confidence felt in that correction. For the expansion of an abbreviation, the resp attribute signifies the person responsible for supplying the expansion and the cert attribute signifies the degree of editorial confidence felt in the expansion.

This close definition of the use of the resp and cert attributes with each element is intended to provide for the most frequent circumstances in which encoders might wish to make unambiguous statements regarding the responsibility for and certainty of aspects of their encoding. The resp and cert attributes, as so defined, give a convenient mechanism for this. However, there will be cases where it is desirable to state responsibility for and certainty concerning other aspects of the encoding. For example, one may wish in the case of an apparent addition to state the responsibility for the use of the add element, rather than the responsibility for identifying the hand of the addition. It may also be that one editor may make an electronic transcription of another editor's printed transcription of a manuscript text—here, one will wish to assign layers of responsibility, so as to allow the reader to determine exactly what in the final transcription was the responsibility of each editor. In these complex cases of divided editorial responsibility for and certainty concerning the content, attributes, and application of a particular element, the more general mechanisms for representing certainty and responsibility described in chapter should be used.

It should be noted that the certainty and responsibility mechanisms described in chapter replicate all the functions of the resp and cert attributes on particular elements. For example, the encoding of Donaldson's conjectured emendation of wight to wright in line 117 of Chaucer's (see ) may be encoded as follows using the resp and cert attributes on the corr element: wightwright Exactly the same information could be conveyed using the certainty and responsibility mechanisms, as follows: wrightwight The choice of which mechanism to use is left to the encoder. In transcriptions where only such statements of responsibility and certainty are made as can be accommodated within the resp and cert attributes of particular elements, it will be economical to use the resp and cert attributes of those elements. Where many statements of responsibility and certainty are made which cannot be so accommodated, it may be economical to use the respons and certainty elements throughout.

The above discussion supposes that in each case an encoder is able to specify exactly what it is that one wishes to state responsibility for and certainty about. Situations may arise when an encoder wishes to make a statement concerning certainty or responsibility but is unable or unwilling to specify so precisely the domain of the certainty or responsibility. In these cases, the note element may be used with the type attribute set to cert or resp and the content of the note giving a prose description of the state of affairs.

Damage, Illegibility, and Supplied Text

The gap and supplied elements described above (section ) should be used with appropriate attributes where the degree of damage or illegibility in a text is such that nothing can be read and the text must be either omitted or supplied conjecturally or from one or more other sources. In many cases, however, despite damage or illegibility, the text may yet be read with reasonable confidence. In these cases, the following elements should be used: As members of the class att.damaged, these elements bear the following attributes: The class att.damaged is a subclass of the class att.dimensions, itself a subclass of the class att.ranging. Consequently these elements also therefore bear at least the following attributes: From the att.spanning class, damageSpan inherits the following additional attribute:

The following examples all refer to the recto of folio 5 of the unique manuscript of the Elder Edda. Here, the manuscript of has been damaged through irregular rubbing so that letters in various places are obscured and in some cases cannot be read at all.

In the first line of this leaf, the transcriber may believe that the last three letters of daga can be read clearly despite the damage: um aldr daga yndisniota

If, as is often the case, the damage crosses structural divisions, so that the damage element cannot be nested properly within the containing div elements, the damageSpan element may be used, in the same way as the delSpan and addSpan elements discussed in section .

[...]

[...]

Note that in this example the spanTo element points to the next pb element rather than to an inserted anchor element, since it is the whole of the leaf (the text between the two pb elements) which has sustained damage. For other techniques of handling non-nesting information, see chapter .

If, as is also likely, the damage affects several disjoint parts of the text, each such part must be marked with a separate damage or damageSpan element. To indicate that each of these is to be regarded as forming part of the same damaged area, the group attribute may be used as in the following example. In this (imaginary) text of Fitzgerald's translation from Omar Khayam, water damage has affected an area covering parts of several lines: The Moving Finger wries; and having writ, Moves on: nor all your Piety nor Wit Shall lure it back to cancel half a Line, Nor all your Tears wash out a Word of it

A more general solution to this problem is provided by the join element discussed in which may be used to link together arbitrary elements of any kind in the transcription. Here, several phenomena of illegibility and conjecture all result from a single cause: an area of damage to the text caused by rubbing at various points. The damage is not continuous, and affects the text at irregular points. In cases such as this, the join element may be used to indicate which tagged features are part of the same physical phenomenon.

If the damage has been so severe as to render parts of the text only imperfectly legible, the unclear element should be used to mark the fact. Returning to the Eddic example above, an encoder less confident in the daga reading might indicate this as follows: um aldr daga yndisniota

If it is desired to supply more information about the kind of damage, it is also possible to nest an unclear element within the damage element: um aldr daga yndisniota

Alternatively, the transcriber may not feel able to read the last three letters of daga but may wish to supply them by conjecture. Note the use of the resp attribute to assign the conjecture to Finnur Jónsson: um aldr daga yndisniota The supplied element may if desired be enclosed within a damage element: um aldr daga yndisniota The transcriber may also provide alternative conjectures by enclosing multiple supplied elements within a choice element.

Contrast the use of gap in the next line, where the transcriber believes that four letters cannot be read at all because of the damage: þar komr inn dimmi dreki fliugandi naþr frann neþan As with supplied, this gap might be enclosed by a damage element.

Where elements are nested in this way, information about agency, etc. is by default inherited. In the following imaginary example, there is a smoke-damaged part within which two stretches can be read with some difficulty, and a third stretch which cannot be read at all: and the proof of this is margin

The above examples record imperfect legibility due to damage. When imperfect legibility is due to some other reason (typically because the handwriting is ill-formed), the unclear element should be used without any enclosing damage element. In Robert Southey's autograph of the final six letters of attention are difficult to read because of the haste of the writing, though reasonably certain from the context. and from time to time invited in like manner his attention The cert attribute on the unclear element may be used to indicate the level of editorial confidence in the reading contained within it.

Use of the gap, del, damage, unclear, and supplied Elements in Combination

The gap, damage, unclear, supplied, and del elements may be closely allied in their use. For example, an area of damage in a primary source might be encoded with any one of the first four of these elements, depending on how far the damage has affected the readability of the text. Further, certain of the elements may nest within one another. The examples given in the last sections illustrate something of how these elements are to be distinguished in use. This may be formulated as follows: where the text has been rendered completely illegible by deletion or damage and no text is supplied by the editor in place of what is lost: place an empty gap element at the point of deletion or damage. Note that the gap could be wrapped in a del or damage element. Use the reason attribute to state the cause (damage, deletion, etc.) of the loss of text. where the text has been rendered completely illegible by deletion or damage and text is supplied by the editor in place of what is lost: surround the text supplied at the point of deletion or damage with the supplied element. Use the reason attribute to state the cause (damage, deletion, etc.) of the loss of text leading to the need to supply the text. where the text has been rendered partly illegible by deletion or damage so that the text can be read but without perfect confidence: transcribe the text and surround it with the unclear element. Use the reason attribute to state the cause (damage, deletion, etc.) of the uncertainty in transcription and the cert attribute to indicate the confidence in the transcription. where there is deletion or damage but at least some of the text can be read with perfect confidence: transcribe the text and surround it with the del element (for deletion) or the damage element (for damage). Use appropriate attribute values to indicate the cause and type of deletion or damage. Observe that the degree attribute on the damage element permits the encoding to show that a letter, word, or phrase is not perfectly preserved, though it may be read with confidence. where there is an area of deletion or damage and parts of the text within that area can be read with perfect confidence, other parts with less confidence, other parts not at all: in transcription, surround the whole area with the del element (for deletion; or the delSpan element where it crosses a structural boundary); or the damage element (for damage). Text within the damaged area which can be read with perfect confidence needs no further tagging. Text within the damaged area which cannot be read with perfect confidence may be surrounded with the unclear element. Places within the damaged area where the text has been rendered completely illegible and no text is supplied by the editor may be marked with the gap element. For each element, one may use appropriate attribute values to indicate the cause and type of deletion or damage and the certainty of the reading.

The rules for combinations of the add and del elements, and for the interpretation of such combinations, are similar:

if one add element (with identifier ADD1) contains another (with identifier ADD2), then the addition ADD1 was first made to the text, and later a second addition (ADD2) was made within that added text: This is the text with some added (interlinear!) material as written. if one del element contains another, and the seq attribute does not indicate otherwise, it should be assumed that the inner deletion was made before the enclosing one. In the following example, the word redundant was deleted before a second deletion removed the entire passage: This sentence contains some redundant unnecessary verbiage. if a del element contains an add element, the normal interpretation will be that an addition was made within a passage which was later deleted in its entirety: This sentence was deleted originally from the text. if an add element contains a del element, the normal interpretation will be that a deletion was made from a passage which had earlier been added: This sentence was added eventually to the text. When some text has been blackened out so thoroughly that can no longer be read, the encoding should be: runs out the door in shirt For consistency, one might prefer to encode the deletion as such, using del, and containing a gap, as in the following example: runs out the door in shirt This is something that would be necessary if one wanted to encode a subst including an illegible deletion: summons If some parts of the deleted text are readable, and other parts unreadable, it should be encoded as in the following example: Billy in The ng Silver Dollar..

Generic Modification

Most, if not all, transcriptional elements imply a certain level of semantic interpretation. For instance, using the add element to encode a word or phrase that occupies interlinear space involves a decision that it has been deliberately inserted as an addition rather than an alternative, and indeed a judgment that it was written after, rather than before, the other lines. Where it is felt desirable to keep the recording of what is on the page entirely separate from what is the editor’s interpretation, the generic mod element may be preferred. This element simply indicates any kind of modification that has been identified in the document, without prejudice as to its function. Occurrences of the mod element may be categorized by means of their type attribute, and visual aspects of their appearance can be described by means of the rend attribute, but they provide no further interpretation of the function or intention of the passage so marked up. The spanTo attribute may be used to indicate the end of a modified passage if this extends across the boundaries of some other XML element, for example from the middle of one line tagged as a line to the middle of another line some distance further on in the document.

words words words words with wavy underline <!-- more lines here --> wavy underlining finishes here more words

The distinction between an example such as that above and the simple use of hi to mark the visual salience of the underlining (apart from the use of the spanTo attribute) is that hi does not imply that the visual effect being recorded is understood to represent some kind of modification.

Metamarks

By metamark we mean marks such as numbers, arrows, crosses, or other symbols introduced by the writer into a document expressly for the purpose of indicating how the text is to be read. Such marks thus constitute a kind of markup of the document, rather than forming part of the text.

Unlike marginal notes or other additions to the text, metamarks are used by the writer to indicate a deliberate alteration of the writing itself, such as move this passage over there. An addition or annotation by contrast would typically concern some property of the passage other than its intended location or status within the text flow. A metamark may contain text, or some other graphic which the encoder wishes to represent, or it may simply consist of arrows, dots, lines etc. which the encoder simply describes.

The metamark element carries a function attribute which specifies the function of the metamark, using values such as reorder, flag, delete, insert or used. The passage to which the metamark applies may be indicated in either of two ways: the target attribute may be used to point to the element or elements containing the passage concerned, or the spanTo element may be used to point to a position in the document at which the passage concerned finishes. In the latter case, the metamark itself must be supplied at the position in the document where the passage concerned begins; in the former case it may be supplied at any convenient point. Both attributes should not be supplied.

The following example is taken from an 15th century legal book from the city of Göttingen, containing regulations of everyday life issued by the city council

, fol 1v.

In the second paragraph, the word lege ("read") was written in the left hand margin, next to the sentence beginning Ock en schullen de bruwere.... It is thought to function as a metamark, indicating that this sentence forms part of the regulations. A further sentence was then added, while at some later stage the text and also the metamark were deleted. We might encode this as follows as an embedded transcription (keeping in mind that the elements described here can also be used within text): lege Ock en schullen de bruwere des hilgen dages nicht over setten noch uppe den stillen fridach bruwen. Noch nymande over setten, se en sehin denne erst, dat uppe den bonen neyn stro noch, huw noch flaß ligghe, by pine eyner halven roden, deme bruwere so wol alse dem bruwheren to murende.

The change attribute used here to indicate the sequencing of these various interventions is discussed below, in section . The elements addSpan and delSpan are discussed in section .

The metamark element may also be used to encode the symbols etc. often found in marked-up proofs such as the following, taken from the Walt Whitman archive:

From a corrected proof of (Walt Whitman Archive)

In this example, the whole of what was originally the 14th section of the poem has been marked for deletion, both by horizontal and vertical lines, and by the proofreading mark resembling the deleatur or dele deletion symbol to left and right of the section. The deletion itself might be encoded by using the normal del or delSpan element, and the metamarks by the metamark element. This is quite a different case from that of the next example, in which the writer does not intend to suppress the content, but only to mark that it has been copied to another manuscript or reused.

From "I am that halfgrown angry boy" (MS q 25), David M. Rubenstein Rare Book & Manuscript Library, Duke University.

This page contains internal deletions, additions, and retracings but these are semantically quite different from the apparent deletion signalled by the larger of the two single vertical lines, which shows that the written material has been transferred or re-used, not deleted.

I am that halfgrown angry boy, fallen asleep The tears of foolish passion yet undried upon my cheeks. I pass through the travels and fortunes of thirty years and become old, Each in its due order comes and goes, And thus a message for me comes. The Entered - Yes

In this embedded transcription example, we class as metamarks both the long vertical line and the annotation Entered - yes. Both metamarks are assumed to indicate that the whole of the written zone with identifier X2 is marked as having been used. metamark can be similarly used within text to encode the same phenomenon as part of a transcription that privileges logical over physical and layout structures.

Fixation and Clarification

A writer may sometimes rewrite material a second time without significant change and in the same place. We consider this a distinct activity from addition as usually defined because no new textual material results; instead the status of existing material is reaffirmed. We may distinguish two variants of this: fixation where the first version was a tentative draft which is subsequently reaffirmed, for example by inking it over; and clarification, where the first version was badly written and has been rewritten for clarity. The element retrace is provided for both cases; its cause attribute may be used to distinguish these or other cases.

In this simple example, taken from the papers of Henrik Ibsen, the writer wrote the word skuldren hastily, and then returned to it to make the letter l larger and clearer:

From autograph ms of , Collin 2869, 4°, I.1.1, the Royal Library of Copenhagen

We might transcribe this word as follows: Skuldren

A single rewrite may not be sufficient, and it may be that the document becomes almost unreadable as a result of repeated clarification. In the following example, we can distinguish at least three attempts to write the letters er in the word bægerklang:

Detail from autograph ms in The Royal Library, Denmark (KBK Collin 262)

We might encode this by nesting the retrace element as follows: ved Bæg er ... The change attribute used here is discussed further below ().

The retrace element is used only for cases where text has been written multiple times. When metamarks and other markup-like strokes have been rewritten multiple times, the redo element described in the next section should be used in preference.

Confirmation, Cancellation, and Reinstatement of Modifications

A writer may indicate that an alteration is itself to be altered: for example, a struck-through passage may be restored via a dotted underlining, or the underlining of a passage may be deleted by a wavy line.

The following elements are provided to represent these situations:

The element restore () is provided for the comparatively simple case where a simple deletion is marked as having been subsequently cancelled. The undo element discussed here is more widely applicable and may be used for any kind of cancellation. It points to the element or elements which are being cancelled. These components need not be contiguous, provided that the cancellation is clearly a single act; each distinct act of cancellation requires a distinct undo element, however. Either of the attributes target or spanTo may be used to indicate the passages concerned.

Consider the following imaginary example:

Imaginary example demonstrating restoring and undoing

We hypothesize that the text has gone through three states or changes, as follows: This is just some sample text, we need a real example. This is not a real example. This is just some text, not a real example.

This sequence of events might be encoded as follows: This is just some sample text, we need not a real example. using two undo elements, each with a spanTo attribute, to delimit the two parts of the deletion which were reverted at change s3. Note that in this case, since target is not supplied, it is the effect of the parent element (the del) which is assumed to be undone.

Alternatively, we might more economically use the generic seg element to delimit the two sequences whose deletion is being reverted, and then use the target attribute on a single undo element: This is just some sample text, we need not a real example.

Transpositions

A transposition occurs when metamarks are found in a document indicating that passages should be moved to a different position. Typically this may be done using arrows, asterisks or numbers, or other means. By definition the result of a transposition is not present in the document, and should not therefore be encoded, if the intention is to represent the actual appearance of the document. Instead, the following elements may be used to indicate the intended reordering:

Consider for example, the following extract from an Ibsen manuscript

Extract from autograph (Poems) NBO Ms. 4º 1110a

The underlined numbers 1 and 2 here indicate that, although the word bör precedes the word hör in the text, the order of the two words should be reversed. We may encode this as follows: bör2. og hör1.

Note the use of the generic seg element to identify the sections of text being transposed. The following example uses an embedded transcription approach, which typically identifies lines of writing with the line element. This makes it trivial to refer to the transposed line, but when encoding transposition within text the encoder will need to find a way to identify the line with another element, such as seg.

Detail from autograph ms of (KBK Collin 2869)

2.) thi da er du med Himmelen i Pagt; — 1.) da kan du Folkets Jøkelhjerter tine; When transposition is made, the whole element indicated is understood to be moved, not just its contents. In the above example, the metamarks are thus understood to be moved along with the lines to which they apply.

One or more listTranspose elements may be supplied either embedded within the text, in the profileDesc of the header, or in a standOff depending on local preference. Each listTranspose can contain one or more transpose elements, each of which defines a single transposition.

Alternative Readings

Detail from autograph manuscript of the second version of , Pierpont Morgan MA 310

In this example two alternative readings are provided, but no preference is indicated. While the author apparently first composed the line Alone before his native river -, at some later point, he entertained the possibility of using the word beside instead of before. The manuscript supplies no indication of which word Moore favours at this point, although in fact, in the first printed edition of the word beside was chosen.

The element alt provided by the linking module gives a simple way of encoding the state of this manuscript, as follows: Alone before beside his native river ­—

The mode attribute here indicates that the two possible readings indicated by the target attribute are mutually exclusive. The weights attribute indicates the relative importance or preference to be attached to the two readings on a scale running from zero (most improbable) to one (most probable). In this case, we have a very strong preference for the second reading because this is the one that appears in the published version of the poem. The alt element is further discussed in section .

Instant Corrections

The use of elements such as del and add necessarily implies that the modifications they indicate were made at some time after the original writing. An exception to this is where a false start or instant correction has been identified: the author starts to write, and then immediately corrects what has been written.

The instant attribute defined by this module may be used on any element which is a member of the att.editLike class to modify this default assumption. When the value of instant is set to true, the addition or deletion is considered to belong to the same change as its parent element, while false means some change later than that of its parent.

An example of false start or instant correction can be seen in the following line:

Detail fron , one of the drafts for Whitman's

in which we can detect the following sequence of events: The letter T is written and then immediately deleted The word The is written, deleted, and replaced by the word His The added word His is then deleted The initial letter i of the words iron necklace is overwritten with a capital I To indicate that the first of these acts must have taken place during the main act of writing, before the other deletion and additions, we might encode this revision campaign as follows: T The His i I ron necklace