I'm using the DocBook V5.1CR3 RELAX NG Schema of assemblies
as a reference and after carefully reading everyting related
to assemblies in "DocBook 5.1: The Definitive Guide"
V1.4.14, I think I've found the following discrepancies:
All over this chapter:
http://docbook.org/tdg51/en/html/ch06.html
Attribute type is discussed in many places. However
according to the schema, only structure has a type
attribute, not elements output, filterin, filterout.
Moreoever, attribute type is set on elements output,
filterin, filterout in several examples.
In my understanding, except on element structure, attribute
type should be replaced by attribute outputformat.
In some examples, attribute format is set on element
output. In my understanding, attribute type should be
replaced by attribute outputformat.
"3.5. Transformations"
http://docbook.org/tdg51/en/html/ch06.html#transformations
A use case for attribute grammar should be given.
Some resource elements are missing required attribute href.
A module element cannot contain <toc> or <index>. In my
understanding, one should reference a resource pointing to a
topic containing <toc> or <index>.</index></toc></index></toc>
Same problem as above.
In paragraph and in the example which follows:
Instead, we introduce one more convention: if a module
refers to another resource and contains an info element,
then the elements within that info replace any elements of
the same name in the referenced resource's metadata. (If the
referenced resource has no metadata, then the specified info
becomes the first child of the referenced resource.)
in my understanding, element info should be replaced by element merge.
Same problem as above in the example.
Please clarify the effect of elements filterin, filterout on
the contents pulled from the resource referenced by a
module.
For example, just writing "print only content is excluded
globally" to describe
<structure xml:id="user-guide">
...
<filterout type="web" condition="print"/>
is not very clear.
(In contrast, writing "If no conditions are specified on
filterout, the module is unconditionally excluded" is quite
clear.)
attribute fileref must be replaced by attribute href
Please clarify attributes type, defaultformat.