[Firebird-docs] firebirddocs.xml

[Paul V. <pa...@vi...>]

Hello all,

At present our main document, firebirddocs.xml, looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                              "file:../docs/docbookx/docbookx.dtd" [
    <!ENTITY preface SYSTEM
        "file:../docs/firebirddocs/preface.xml">
    <!ENTITY firebirdintro SYSTEM
        "file:../docs/firebirddocs/firebirdintro.xml">
    <!ENTITY migrationmssql SYSTEM
        "file:../docs/firebirddocs/migrationmssql.xml">
]>
<set>
    <book>
        <bookinfo>
            <title>Firebird Database Documentation</title>
            <copyright>
                <year>2001-2003</year>
                <holder>All Contributions are Copyright of their
                                   individual contributors.</holder>
            </copyright>
        </bookinfo>
        &preface;
        &firebirdintro;
    </book>

...etc. (long lines wrapped)


Is there a special reason for this? Wouldn't it be cleaner to move the
book tags and bookinfo elements to the book documents themselves? The
set in the main document would then come to look like:

<set>
    &firebirdintro;
    &migrationmssql;
    &docbuildhowto;
    &docwritehowto;
    ...
    ...
<set>

Just asking :-)


BTW: "book" after !DOCTYPE should be changed in "set", although it
doesn't affect the build (afaict).


Greetings,
Paul Vinkenoog