Opened 15 years ago

Closed 12 years ago

Last modified 12 years ago

#1281 closed Bugs (fixed)

Quickbook produces invalid BoostBook/DocBook XML

Reported by: Stephan Tolksdorf <andorxor (at) gmx (dot) de> Owned by: Joel de Guzman
Milestone: To Be Determined Component: quickbook
Version: Boost Development Trunk Severity: Problem
Keywords: Cc:

Description

The current trunk version of Quickbook produces XML code that is invalid according to the referenced boostbook.dtd

The following is a list of errors I found in the XML file generated from boost/tools/quickbook/doc/quickbook.qbk with a freshly compiled Quickbook. The line numbers refer to the first occurence of the respective problem.

Line 2: DOCTYPE refers to starting tag <library> though Quickbook uses <article>

Line 3: name and dirname and xmlns:xi are invalid attributes for <article>

Line 21: <articlepurpose> is an invalid tag

Line 30: <para> inside <para> in <blockquote>

Line 72: text without enclosing <para> in <listitem> (though <listitem> inside <varlistentry> has <para>)

Line 1590: "sect6" is invalid content for the <bridgehead> attribute renderas

Line 1913: <para> inside <para> after template expansion

Line 2545: no child element in empty <calloutlist>

Line 2658: <para> inside <para> before <programlisting>

Line 2661: <co> not allowed inside <phrase>

Line 2667: <para> inside <para> before <programlisting> + <calloutlist>

Change History (9)

comment:1 by Stephan Tolksdorf <andorxor (at) gmx (dot) de>, 15 years ago

I forgot one: <title> must come before <articleinfo> in <article>

comment:2 by Stephan Tolksdorf <andorxor (at) gmx (dot) de>, 15 years ago

From line 21 on all line numbers are off by -3. Sorry.

comment:3 by Daniel James, 12 years ago

(In [62465]) Fix the DOCTYPE generated by quickbook. Refs #1281

comment:4 by Daniel James, 12 years ago

(In [62466]) Don't wrap <co> in a <phrase>. Refs #1281.

comment:5 by Daniel James, 12 years ago

(In [62467]) Avoid double <para> in <blockquote>. Refs #1281.

comment:6 by Daniel James, 12 years ago

(In [62469]) Valid lists. Refs #1281

comment:7 by Daniel James, 12 years ago

(In [62470]) Deal with invalid docinfo details. Refs #1281.

Warn when boostbook attributes are used for docbook document types and don't output them.

comment:8 by Daniel James, 12 years ago

Resolution: → fixed
Status: new → closed

Most of these are now fixed. I've created new tickets for the remaining issues: #4302, #4303.

comment:9 by Daniel James, 12 years ago

(In [63896]) Restore the invalid doc info attributes.

Removing them breaks the release notes, there's still a warning that they're invalid. Refs #1281

Note: See TracTickets for help on using tickets.