Re: [docbook-tc] First crude attempt at DocBook V5 spec

[Jirka Kosek <jirka@kosek.cz>]

Norman Walsh wrote:

> It's pretty crude, but it's also done 24 hours before the meeting.
> Almost :-)

Yep, it is hard to cheat time if you have NTP client installed :-)

Thanks, Norm. Please find my mostly editorial notes inline:

> Copyright © 2001, 2002, 2003, 2004 The Organization for the Advancement of 

We should add 2005 here.

> *Table 1. DocBook Element Changes*
> 
> |action|, |beginpage|, |highlights|, |interface|, |invpartnumber|, |medialabel|, 
> |modespec|, |structfield|, |structname| 	
> 
> Deleted.

Do we really want to remove structfield and structname from DocBook? I 
think that not all programs are written in OO languages in these days 
and that there are a lot of people writing in pure C that will benefit 
from these elements.

Probably we should ask at docbook list if there is anyone using these 
elements before we will definitively remove them.

>         3.1.9. Universal Linking
> 
> Starting with DocBook V5.0, the |linkend| and |href| attributes are available on 
> almost all elements.
> 
> The |linkend| attribute provides an ID/IDREF link within the document. The 
> |href| attribute provides a URI-based link.
> 
> The |olink| and |ulink| elements have been removed from DocBook as these linking 
> constructs can now be achieved directly from the appropriate inline (such as 
> |productname| or |command|). For instances where no specific semantic inline is 
> needed, |link| is still available.

I think that we should mention here that href attribute is taken from 
XLink namespace and thus there is no further need for distinguishing 
between link/ulink/olink on markup level.

>     C. Notices
> 
> Copyright © The Organization for the Advancement of Structured Information 
> Standards [OASIS] 2001, 2002, 2003, 2004. All Rights Reserved.


Add 2005 here.

>  Normative Reference

I think that we should add XLink Rec here:

	http://www.w3.org/TR/xlink/

Probably we should also include reference to your recent XLink note to 
address xlink:type="simple" annoyances.

>       Non-Normative References

What about adding RNC tutorial:

	http://relaxng.org/compact-tutorial-20030326.html


See you (hear you;-) later,

				Jirka

-- 
------------------------------------------------------------------
   Jirka Kosek     e-mail: jirka@kosek.cz     http://www.kosek.cz
------------------------------------------------------------------
   Profesionální školení a poradenství v oblasti technologií XML.
      Podívejte se na náš nově spuštěný web http://DocBook.cz
        Podrobný přehled školení http://xmlguru.cz/skoleni/
------------------------------------------------------------------

S/MIME Cryptographic Signature