> > So reworded: using namespaces to define tags, and use them > > along DocBook tags. This is exaclty not extending DocBook, > > but defining a DTD for our custom elements and use those > > two DTDs (DocBook and PHPDoc) side-by-side. > > This may be a misinformation. With tags I am always reffering to > elements. Please donīt touch them. Customization is another deal.
The "Customizing DocBook" section also deals with adding tags, to the DocBook DTD as I can remember. http://www.docbook.org/tdg/en/html/ch05.html#ch05-addelem I do not want to touch DocBook elements, nor customize DocBook this way. I said we maybe can make another DTD, with only defining our own tags, we would like to use along side by side with DocBook. As Jirka mentioned, this would not be too good as a design decision, and the files can get impossible to validate, so this is not the way today. Then the only thing left for me is to use the role="" attribute for some custom usage. I do not want to modify the DocBook DTD. > > Although I am __not__ speaking of extending DocBook, > > there is a chapter about "Customizing DocBook", in > > "DocBook: The definitive Guide". This customizing is what > > Jirka is talking about. So for DocBook it is allowed. > > I know that :) But what will do the rest of the > committeres all over this world? As Jirka said, as long as they use the DocBook DTDs from the phpdoc repositories dbxml directory, they can use tags added there. For other tools not dependant on this directory, there would be much-much more problems. There are some (IMHO not so elegant) solutions posted by Jirka, and I can understand what he is saying, but I do not like adding tags this way. > > It is our job to decide, whether we choose customizing > > or another way. I am against customizing DocBook this > > way, so we are on the same side (and so Hartmut, as > > I can see in this PDF). > > What do you mean with "our"? The member of the "PHP Documentation Team". I use this wording as the people who are working in phpdoc, not just those listed on the frontpage. >From now on in this letter, I will use we as "you Egon and me". IMHO generally we are talking about the same things. We do not want to add tags to DocBook into the DTD, because several reasons. Some of these reasons are technical, some of these are just opinions. We do want to keep the XML files validateable. Goba
