[tei-council] <egXML> example

[Martin Holmes]

I think I just had an aha moment:

If the purpose of the example is to illustrate the use of @valid, then 
@valid needs also to be on the embedded CDATA <egXML> as well as the 
outer one:

    <exemplum xml:lang="en">
      <egXML xmlns="http://www.tei-c.org/ns/Examples" xml:lang="und"
	   valid="false">
<![CDATA[
        <egXML xmlns="http://www.tei-c.org/ns/Examples" valid="false">
          <langUsage>
            <language ident="fr">English</language>
          </langUsage>
        </egXML>
<!-- Though syntactically valid, this example is incorrect -->
]]>
      </egXML>
    </exemplum>

The comment also needs to point out what is being illustrated:

<!-- Though syntactically valid, this example is incorrect because
      the text of the <language> element does not match its @ident
      value. Therefore the attribute @valid is set to false.  -->

Now, if I'm right, the purpose of the example will be apparent. I've 
implemented that change and we'll see what the result looks like when 
Jinks has finished with it in an hour or so:

<http://teijenkins.hcmc.uvic.ca:8080/job/TEIP5-Documentation/lastSuccessfulBuild/artifact/Guidelines-web/en/html/ref-egXML.html>

I'm still not sure if we should have that as the first example of 
<egXML>, but that's a different question.

Cheers,
Martin

On 12-03-24 06:45 AM, Sebastian Rahtz wrote:
> this thing does seem extraordinary.  if we revert to
>
> <exemplum xml:lang="en">
>      <egXML xmlns="http://www.tei-c.org/ns/Examples" xml:lang="und">
>        <![CDATA[<egXML xmlns="http://www.tei-c.org/ns/Examples">
>          <langUsage>
>            <language ident="fr">French</language>
>          </langUsage>
>        </egXML>]]>
>      </egXML>
>    </exemplum>
>
> it is entirely valid, but misleading, cos the XML is not XML just
> looks like it. so I feel inclined to keep "valid=false", lose the comment,
> and correct the semantics.
>
> if you wonder its in CDATA to avoid the whole thing being processed.
> --
> Sebastian Rahtz
> Head of Information and Support Group, Oxford University Computing Services
> 13 Banbury Road, Oxford OX2 6NN. Phone +44 1865 283431
>
> Sólo le pido a Dios
> que el futuro no me sea indiferente
>
>
>