OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] elements inside <remark>

This is a case of the documentation preceding the implementation. Although the content 
model of remark in Docbook 5.0 is limited, it is expanded in DocBook 5.1, which is 
just entering beta testing. DocBook 5.0 was released in Nov 2009, and Norm filed a 
change request in January 2010 to expand the content model of remark.  The DocBook 
Technical Committee accepted the change, and it will be in 5.1.

Bob Stayton
Sagehill Enterprises

----- Original Message ----- 
From: "maxwell" <maxwell@umiacs.umd.edu>
To: "apps docbook" <docbook-apps@lists.oasis-open.org>
Sent: Thursday, July 22, 2010 11:54 AM
Subject: [docbook-apps] elements inside <remark>

According to the documentation on DB 5
(http://www.docbook.org/tdg5/en/html/remark.html), it appears that a large
number of inline elements ought to be able to appear inside a <remark>
element.  However, the docbook.rng
(http://www.docbook.org/xml/5.0b9/rng/docbook.rng) appears to allow only a
few of these:
   inlinemediaobject, remark, superscript, subscript,
   xref, link, olink, anchor, biblioref, alt, annotation,
   indexterm.singular, indexterm.startofrange, indexterm.endofrange,
   phrase, replaceable
Missing from this list afaict are many of the gui inlines, markup inlines,
operating system inlines, etc. that the documentation says should be
allowed (and which I believe DocBook 4.5 allowed).

Perhaps this is intentional; there are some comments at
http://www.oasis-open.org/docbook/specs/docbook-5.0b6-spec-wd-01.html to
the effect that DB5 "drastically" reduced the content models of many
inlines. This description uses the <command> element as an example, and
this content model seems to correspond to the DB5 schema.  Again, this
differs from the documentation at
http://www.docbook.org/tdg5/en/html/command.html.  So maybe this is a case
of the documentation at http://www.docbook.org/tdg5/en/html/command.html
(etc.) not having caught up with the schema?

Or maybe http://www.docbook.org/tdg5/ is not the definitive documentation
for DB5, because it's v1.1 of the documentation, and for now 1.0 is what I
should be using?

So maybe my question boils down to this:  Where can I find both the
current and consistent schema and human-readable documentation for DB5?

   Mike Maxwell

To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]