7 204 2004-12-02T07:45:54-05:00 $Date: 2005-10-17 09:59:18 -0400 (Mon, 17 Oct 2005) $ NormanWalsh 2004Norman Walsh A few annotation changes reflecting mainly decisions of the DocBook Technical Committee at the October telcon. http://norman.walsh.name/2004/09/10/annotations http://norman.walsh.name/2004/09/16/annotationMarkup HenryAdams No one means all he says, and yet very few say all they mean, for words are slippery and thought is viscous. The last timeMinutes of the October, 2004 telcon the DocBook TCTechnical Committee discussed annotations, there seemed to be consensus on two points. First, that one of the principle motivations for simple, inline annotations is accessibility. Second, that authors will find it easier to use annotations if the distinction between simple, inline annotations and “block” annotations is made on the basis of the element name. Inline annotations contain only text and other phrase-level markup. They are typically displayed as “tooltips” in a browser. Block annotations, like this one, are more akin to footnotes. The browser presentation is a typically a pop-up window. To that end, I've updated the customization layer used here so that the “alt” element is allowed in all inline context. The alt element identifies a simple, inline annotation. The name “alt” has the advantage of being both short and suggestive of the accessibility aspect of this kind of annotation. The annotation element no longer has a class attribute, it is now used only for block annotations. Comments? Suggestions?