DocBook 5 for Debian
I am creating a new XSLT file to convert DocBook 5 "refentry" (man page)
files to texinfo files on a non-Debian system. I would like to bring
DocBook 5 into Debian.
DocBook 5 has incompatibilities with DocBook 4.x, so the two versions would
have to co-exist. I wanted to discuss this here before filing any ITPs,
etc., to solicit opinions from those who would be interested and affected.
Obviously, nothing new should impact anybody using DocBook 4.5 on Debian.
You can read about changes from DocBook 4.5 to DocBook 5.0 here:
http://tdg.docbook.org/tdg/5.0/ch01.html#introduction-whats-new
In general, each major revision of DocBook can introduce
backwards-incompatible changes from earlier versions. The DocBook
Technical Committee of OASIS intended that no major release would introduce
incompatible changes unless such changes had been announced in the previous
major release. However, they made an exception for DocBook 5 with its
shift to a RELAX NG and Schematron-based definition versus a DTD
definition. Thus, package names of the form "docbook5" and "docbook5-*",
"docbook6" and "docbook6-*", etc. seem appropriate for new packages
(although DocBook 6.0 is not expected to introduce backwards-incompatible
changes from DocBook 5.x because no such changes were announced at the
release of DocBook 5.0).
DocBook 5 DTDs are also available for XML and SGML, but they do not fully
define the syntax of a DocBook 5 file--the RELAX NG and Schematron
definitions do.
I think this inclusion of the major version number in the package name
should also apply to XSL packages, because XSLT files will be written for a
specific major version of DocBook. This implies that a DocBook 5
collection of XSL files will exist that will have a lot of overlap with the
existing docbook-xsl package under a different name. There is also an XSLT
file for transforming DocBook 4.5 files into DocBook 5.0 files, which would
be included in a proposed "docbook5-xsl" package.
I do not want to adopt the orphaned DocBook 4.x packages, because they are
not being updated upstream. I might consider updating them in the future
for new Debian Standards versions, but my focus is on working with DocBook
5.
I would also intend to make the HTML5 entity definitions for special
character names available for DocBook 5 use ("—", "–", etc.).
I think that would be appropriate for a "docbook5-xml" package.
Therefore, I propose filing ITPs for packages "docbook5", "docbook5-xsl",
and "docbook5-xml". The packages initially would be based on DocBook 5.1,
unless DocBook 5.2 is finalized in the meantime.
Any comments or suggestions?
Thank you,
Paul Hardy
Re: DocBook 5 for Debian
Guillem, On Wed, Aug 2, 2017 at 1:07 AM, Guillem Jover wrote: > Hi! > > On Tue, 2017-08-01 at 23:24:20 -0700, Paul Hardy wrote: > > I am creating a new XSLT file to convert DocBook 5 "refentry" (man page) > > files to texinfo files on a non-Debian system. I would like to bring > > DocBook 5 into Debian. > > In a way, we already have some DocBook 5 support. :) > > > Therefore, I propose filing ITPs for packages "docbook5", "docbook5-xsl", > > and "docbook5-xml". The packages initially would be based on DocBook > 5.1, > > unless DocBook 5.2 is finalized in the meantime. > > Please take a look at the existing docbook5-xml and docbook-xsl-ns > packages. > That is great. I will try to get a setup that works like what I have on my non-Debian system and see where gaps exist. I can follow up with the XML/SGML group. Thank you, Paul Hardy
Bug#700576: cowsay: Pleasy add kangaroo cow :)
tags -1 patch Attached is a kangaroo cow, all ready to be copied to the cows directory. The file author, copyright, and license are given in comments in the header. I am also attaching the email exchange where the creator of the kangaroo gave permission to use that kangaroo (after I flipped it horizontally) with the stated copyright and license terms. Francois, this package has no maintainer right now so if you want to upload this patch please do. The header information in kangaroo.cow could be copied into debian/copyright as well. Have fun! Thanks, Paul Hardy kangaroo.cow Description: Binary data permission.txt.gz.sig Description: PGP signature permission.txt.gz Description: application/gzip kangaroo.cow.sig Description: PGP signature
Bug#700576: cowsay: Please add a kangaroo cow
Control: tags -1 + pending - help I am going to prepare an NMU to fix this bug using the patch that I submitted previously. Thanks, Paul Hardy
Bug#700576: cowsay: Please add a kangaroo cow
Here is a kangaroo cow NMU patch created with "diff -r -N -u". The directories are "cowsay-3.03+dfsg2-5" (current Debian unstable version) and "cowsay-3.03+dfsg2-5.1" (kangaroo cow NMU version). Thanks, Paul Hardy cowsay-kangaroo-patch.txt.gz.sig Description: PGP signature cowsay-kangaroo-patch.txt.gz Description: application/gzip
Bug#700576: cowsay: Please add a kangaroo cow
I have submitted a merge request for this on salsa.debian.org. Thanks, Paul Hardy
Bug#700576: cowsay: Please add a kangaroo cow
Control: tags -1 + patch This patch changes the version of the kangaroo cow salsa merge from an NMU, "-5.1", to a QA upload, "-6" (because the package is orphaned) and makes the kangaroo cow license "GPL-2+". Thanks, Paul Hardy diff -u -r -N nmu-kangaroo/debian/changelog qa-kangaroo/debian/changelog --- nmu-kangaroo/debian/changelog 2018-11-10 06:02:59.0 -0800 +++ qa-kangaroo/debian/changelog 2019-02-03 09:39:39.272895685 -0800 @@ -1,9 +1,9 @@ -cowsay (3.03+dfsg2-5.1) unstable; urgency=medium +cowsay (3.03+dfsg2-6) unstable; urgency=medium - * Non-maintainer upload. - * Add kangaroo cow. + * QA upload. + * Add kangaroo cow (closes: #700576). - -- Paul Hardy Sat, 10 Nov 2018 05:40:41 -0800 + -- Paul Hardy Sun, 03 Feb 2019 09:39:28 -0800 cowsay (3.03+dfsg2-5) unstable; urgency=medium diff -u -r -N nmu-kangaroo/debian/copyright qa-kangaroo/debian/copyright --- nmu-kangaroo/debian/copyright 2018-11-10 06:20:40.0 -0800 +++ qa-kangaroo/debian/copyright 2019-02-03 09:35:54.219604693 -0800 @@ -46,7 +46,7 @@ Files: cows/kangaroo.cow Comment: Adapted from http://sumaleth.com/files/row_ascii_collection_1.2.html. Copyright: Copyright (C) 1994 Rowan Crawford. -License: GPL2+ +License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or nmu2qa-kangaroo.patch.sig Description: PGP signature
