<?xml version="1.0" encoding="UTF-8"?>

<!-- Start license statement: do not remove 

EpiDoc: Guidelines for Structured Markup of Epigraphic Texts in TEI
Copyright (C) 2000-2006 by all contributors listed in <div type="gl-responsibility">, below.
Additional contributors' copyright may be designated in individual source files.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

Information about the EpiDoc community can be obtained via 
http://epidoc.sf.net.

End license statement: do not remove -->
<!DOCTYPE div SYSTEM "../dtd/tei-epidoc.dtd">
<!-- Start CVS information: do not remove -->
<!-- $Header: /cvsroot/epidoc/guidelines/src/unclear.xml,v 1.11 2007/05/11 11:36:53 gabrielbodard Exp $ -->
<!-- End CVS information: do not remove -->

<div xmlns="http://www.tei-c.org/ns/1.0" xmlns:tei="http://www.tei-c.org/ns/1.0"
    xmlns:xi="http://www.w3.org/2001/XInclude" id="unclear">
    <head>Transcription wherein the character would not be unambiguous outside its context</head>
    <ab><rs type="conformance">leiden</rs></ab>
    
    <p>Note: depending on your font, browser, browser settings, operating system and other factors,
        the subscript dots used in examples in this section may display after the character instead
        of beneath it.</p>
    <div id="unclear-typographic" type="gl-typographic" >
        <head>Traditional typographic representation</head>
        <list type="unordered">
            <item><bibl ><title level="a" type="abbreviated">Panciera</title>, <abbr
                        expan="page">p.</abbr><biblScope type="pages">17</biblScope></bibl>; <bibl
                    ><title level="a" type="abbreviated">Dohnicht</title>, <abbr
                        expan="page">p.</abbr><biblScope type="pages">3</biblScope></bibl>: <list
                    type="unordered">
                    <item id="TypoEx-1">
                        <hi rend="italic">ạḅc̣</hi>
                    </item>
                        </list></item>
            <item>Alternative example:
            <list type="unordered">
                <item id="TypoEx-2">Ṃ</item>
            </list></item>
            
        </list>
    </div>
    <div id="unclear-regex" type="gl-regextest">
        <head>Regular Expression Test</head>
        <list type="unordered">
            <item id="Regex-1"> blah</item>
        </list>
        <link id="TestLink-1" type="regextest" targets="TypoEx-1 EncEx-1 Regex-1" />
        <link id="TestLink-2" type="regextest" targets="TypoEx-1 EncEx-2 Regex-1" />
        <link id="TestLink-3" type="regextest" targets="TypoEx-1 EncEx-3 Regex-1" />
        <link id="TestLink-4" type="regextest" targets="TypoEx-1 EncEx-4 Regex-1" />
        <link id="TestLink-5" type="regextest" targets="TypoEx-1 EncEx-5 Regex-1" />
        <link id="TestLink-6" type="regextest" targets="TypoEx-2 EncEx-6 Regex-1" />
    </div>
    <div id="unclear-edition" lang="la" type="gl-edition" >
        <head lang="en">EpiDoc appearance with standard XSLT</head>
        <p lang="en">Note that TEI provides the option of being more specific than Leiden about the details of of the difficulty (note final example).
        Without the deliberate encoding of <xref href="div-apparatus.xml">an apparatus component</xref> to pick up and display the extra distinctions,
        the effort of full markup may be lost.</p> 
        <list type="unordered">
            <item id="EncEx-1">
                <unclear reason="undefined" cert="high">abc</unclear>
            </item>
            <item id="EncEx-2">
                <unclear reason="undefined" cert="high">a</unclear><unclear reason="undefined" cert="high">b</unclear><unclear reason="undefined" cert="high">c</unclear>
            </item>
            <item id="EncEx-3">
                <unclear reason="damage" cert="high">abc</unclear>
            </item>
            <item id="EncEx-4">
                <unclear reason="execution" cert="high">abc</unclear>
            </item>
            <item id="EncEx-5">
                <unclear reason="undefined" cert="high">abc</unclear>
            </item>
            <item id="EncEx-6">
                <app>
                    <rdg>
                        <unclear cert="high" reason="undefined">N</unclear>
                    </rdg>
                    <rdg n="default">
                        <unclear cert="high" reason="undefined">M</unclear>
                    </rdg>
                    <rdg>
                        <unclear cert="high" reason="undefined">H</unclear>
                    </rdg>
                </app>
            </item>
        </list>
    </div>
    <div id="unclear-notes" type="gl-notes" >
        <head>Notes</head>
        <div id="unclear-usage" >
            <head>Usage</head>
            <p>The EpiDoc DTD permits only the appearance of character data and the <tag>g/</tag>
                element within <tag>unclear</tag><tag>/unclear</tag>. When an editor or encoder
                encounters a continuous string of unclear characters in a text, two encoding options
                are available: each character may be encapsulated within its own
                    <tag>unclear</tag><tag>/unclear</tag> or the entire string may be encapsulated
                within a single <tag>unclear</tag><tag>/unclear</tag>. No other markup may appear
                inside <tag>unclear</tag><tag>/unclear</tag>, so if other aspects of a long string
                of unclear characters warrant additional tagging internal to the string, the
                per-character solution may be preferable or even required. For background on this
                issue, see a discussion on the <xref href="http://lsv.uky.edu/archives/markup.html"
                    >markup list</xref> in July
                and August of 2005, subject: EpiDoc DTD issues [1: unclear].</p>
        </div>
        <div id="unclear-reason" >
            <head>The <att>reason</att> Attribute</head>
            <p>TEI defines a <att>reason</att> attribute for the <tag>unclear</tag> element. In the
                EpiDoc DTD, this attribute has three possible values: "damage", "execution" and
                "undefined." "Undefined" is designated as the default/automatic value. See further
                the markup list discussion referenced above. The default stylesheets render all
                instances of <tag>unclear</tag> with the standard subscript dot, regardless of the
                value of the <att>reason</att> attribute.</p>
        </div>
        <div id="unclear-readings" >
            <head>Alternative readings</head>
            <p>In cases where a letter trace is compatible with a range of characters but the
                context does not offer an unambiguous choice but the editor wishes to offer a
                default value, the alternative interpretations may be offered in a series of
                    <tag>rdg</tag> elements within an <tag>app</tag>; in which case the particular
                reading to be rendered must be labelled with an attribute <att>n</att>='default'
                (see e.g. 6 above).</p>
            <p>It is also envisaged that the possibility will exist to record the general shape of
                the surviving traces using embedded SVG or similar elements which could then be
                rendered as a drawing.</p>
            <p>Where the editor is not willing to commit to a default reading, see <xref
                    href="vestiges.xml" 
                >vestiges</xref>.</p>
        </div>
    </div>
    <div id="unclear-tei-p4links" type="gl-tei-p4links" >
        <head>TEI P4 links</head>
        <list type="unordered">
            <item>
                <xref href="http://www.tei-c.org/P4X/ref-UNCLEAR.html"
                    >
                    <tag>unclear</tag>
                </xref>
            </item>
            <item>
                <xref href="http://www.tei-c.org/P4X/CE.html#CECECE"
                    >17.1.2 Structured Indications of Uncertainty</xref>
            </item>
            <item>
                <xref href="http://www.tei-c.org/P4X/PH.html#PHCOMB"
                    >18.2.4 The Use of the Gap, Del, Damage, Unclear and
                    Supplied Tags in Combination</xref>
            </item>
        </list>
    </div>
    <div id="unclear-responsibility" type="gl-responsibility" org="uniform" part="N"
        sample="complete">
        <head>Responsibility for this section</head>
        <listBibl >
            <bibl >
                <respStmt>
                    <resp>author</resp>
                    <name>Tom Elliott</name>
                </respStmt>
            </bibl>
            <bibl >
                <respStmt>
                    <resp>author</resp>
                    <name>Gabriel Bodard</name>
                </respStmt>
            </bibl>
            <bibl >
                <respStmt>
                    <resp>author</resp>
                    <name>Charles Crowther</name>
                </respStmt>
            </bibl>
            <bibl >
                <respStmt>
                    <resp>contributor</resp>
                    <name>Hugh Cayless</name>
                </respStmt>
            </bibl>
            <bibl >
                <respStmt>
                    <resp>contributor</resp>
                    <name>Tim Finney</name>
                </respStmt>
            </bibl>
            <bibl >
                <respStmt>
                    <resp>contributor</resp>
                    <name>Chris Lilley</name>
                </respStmt>
            </bibl>
        </listBibl>
    </div>
    <div id="unclear-cvs" type="gl-cvs" >
        <head><abbr expan="Concurrent Versioning System">CVS</abbr> Information</head>
        <p id="unclear-cvs-revision-number">Revision number: <seg n="cvs-revision-number"
                cert="high" part="N">$Revision: 1.11 $</seg></p>
        <p id="unclear-cvs-revision-name">Revision name (if any): <seg n="cvs-revision-name"
                cert="high" part="N">$Name: r-5 $</seg></p>
        <p id="unclear-cvs-revision-date">Revision date: <seg n="cvs-revision-date" cert="high"
                part="N">$Date: 2007/05/11 11:36:53 $</seg></p>
        <p id="unclear-cvs-revision-author">Revision committed by: <seg n="cvs-revision-author"
                cert="high" part="N">$Author: gabrielbodard $</seg></p>
    </div>
</div>
