[tei-council] 3519866... are we nearly there yet?

[Kevin Hawkins]

On 10/6/12 2:37 PM, Lou Burnard wrote:
> Thanks for helpful comments, and on a saturday night too...
>
> I've now checked in my best shot at implementing this pesky ticket.
> Please propose clarifications and better examples, or identify lacunas.
>
>    http://tei.svn.sourceforge.net/tei/?rev=10930&view=rev

See also http://tei.svn.sourceforge.net/tei/?rev=10924&view=rev as 
mentioned yesterday.

> Or, when Mr Jenkins has finished, you can look in his bleeding edge HTML
> directory for the following revised sections:
>    ST (revised 1.3.1.1.3)

Looking at 
http://teijenkins.hcmc.uvic.ca:8080/job/TEIP5-Documentation/lastSuccessfulBuild/artifact/Guidelines-web/en/html/ST.html#STGAre 
...

Your CSS is invalid.  Instead of

text-style:italic

it is

font-style:italic

However, I would actually use

font-style: italic

here (with the space) because you go on to imply that @style, unlike 
@rend, doesn't use space characters to separate tokens.

I think it would be good to avoid the phrase "unconstrained tokens" 
since this is opaque to most readers.  I think you're going to need to 
explain that @rend may contain one or more tokens from any vocabulary 
devised by the encoder, each separated by space characters.  And instead 
of implying that @style doesn't use space to divide tokens, I would say 
it explicitly.

>    CO (revised 3.3.1)

(See 
http://teijenkins.hcmc.uvic.ca:8080/job/TEIP5-Documentation/lastSuccessfulBuild/artifact/Guidelines-web/en/html/CO.html#COHQW 
.  Looks fine to me.)

>    HD (revised 2.3.4)

Looking at 
http://teijenkins.hcmc.uvic.ca:8080/job/TEIP5-Documentation/lastSuccessfulBuild/artifact/Guidelines-web/en/html/HD.html#HD57 
...

First of all, mention of <styleDefDecl> should also go in the list of 
children of <encodingDesc> at the beginning of section 2.3.

In 2.3.4.1, I would change

or either of the existing standard languages:

to

or any standard language such as

Next, where you first mention <styleDefDecl> in 2.3.4.1, I would say 
that it is a child of <encodingDesc> since it's not clear where to find 
this element, which hasn't been mentioned recently.

It seems to me that 2.3.4.2 (about <styleDefDecl>) should not be under 
2.3.4 (about <tagsDecl>) since it is not a child of that element. 
Instead, it should be a child of 2.3.  Not sure what order to put it in: 
it depends on where in the list at the beginning of section 2.3 you 
insert it.

In the section currently numbered 2.3.4.2, you say "whichever default 
style definition language is in force for the context in which it 
appears".  Are you referring to the numbered list (1 to 3) of what's 
applicable appearing in section 1.3.1.1.3?  If so, please 
cross-reference it.

Finally, in the current 2.3.4.2, I don't care for "That context may be 
varied".  Maybe "The default style language in force may be overridden"? 
  And drop "in the usual way" later in the sentence: it's unnecessary.

--K.