On 4/9/20 1:02 PM, Bruce Dubbs wrote:
On 4/9/20 12:03 PM, Pierre Labastie via blfs-dev wrote:
On Thu, 2020-04-09 at 23:05 +0800, Kevin Buckley via blfs-dev wrote:
I'd like to make a suggestion, as regards the names of the
BLFS XML files for the SGML/XML/DocBook sections.
I've just come to add some of the DocBook packages to my
LFS/BLFS system, and hence my own copy of the Book sources,
and got a bit confused as to what related to what.
As things stand the relevant BLFS sources files, and the
package sources they expect to have unpacked are:
sgml-common.xml sgml-common-0.6.3.tgz
sgml-common-0.6.3-manpage-1.patch
sgml-dtd.xml docbook-4.5.zip
docbook.xml docbook-xml-4.5.zip
docbook-xsl.xml docbook-xsl-nons-1.79.2.tar.bz2
docbook-xsl-nons-1.79.2-stack_fix-1.patch
docbook-xsl-doc-1.79.2.tar.bz2
sgml-dtd-3.xml docbk31.zip
docbook5.xml docbook-5.0.zip
docbook51.xml docbook-v5.1-os.zip
however, sgml-dtd.xml and sgml-dtd-3.xml are actually about
installting DocBook SGML DTDs, not generic SGML DTDs, as can
be read in the introductory paragraph for each package.
Given that multiple SGML and XSL DTDs cam exist on the
same system, I feel that is would be more consistent if
the BLFS source files were renamed as follows:
sgml-common.xml sgml-common-0.6.3.tgz
sgml-common-0.6.3-manpage-1.patch
docbock-sgml-45.xml docbook-4.5.zip
docbook-xml-45.xml docbook-xml-4.5.zip
docbook-xsl.xml docbook-xsl-nons-1.79.2.tar.bz2
docbook-xsl-nons-1.79.2-stack_fix-1.patch
docbook-xsl-doc-1.79.2.tar.bz2
docbook-sgml-31.xml docbk31.zip
docbook-xml-50.xml docbook-5.0.zip
docbook-xml-51.xml docbook-v5.1-os.zip
but, in suggesting that, I'm unsure as to what that entails
for the Book gneration process as a whole, not least the
<?dbhtml filename="docbook-xsl.html"?>
tags,
So, even though I can't present a fully formed "change
request", I hope that the underlying idea is seen as
a sensible thing to do.
file names are only referenced in the file that has the same name as
the directory plus .xml extension (the <xi:include .../> tags). So when
changing the filenames, those files have to be changed too. This is the
only mandatory thing
But: it is better to have the html file have a name close to the xml
one (the html name is defined in the <?dbhtml ...?> processing
instruction). And also the id attribute in the <sect1> tag, should be
close to that. But this is not mandatory. If changing the id, it has to
be changed also in all <xref linkend=".../> tags referencing it.
We rarely change these files, but I agree that the naming is confusing.
I run into the problem at release time, but have never gotten to fixing
it. I'll see if I can do that today.
Thanks for bringing it up.
OK, I've updated the problem docbook pages at revision 22981. Please
check it out.
Primarily there was confusion between sgml, dtd, and xml. I changed the
titles of the dtd pages and made internal page changes to match.
-- Bruce
--
http://lists.linuxfromscratch.org/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
