subproject-howto, fdl.sgml, debiandoc+docbook=headache
Hi. I have started writing a subproject-howto in debiandoc sgml as a native
Debian package (see the attached ITP; see also a recent pre-release of the
document, HTML output only, at http://people.debian.org/~synrg). I have a
problem including the license text.
First, like the apt-howto, I would like to put my document under the FDL.
However, unlike that document, I would prefer to have the license itself as
an appendix based on fdl.sgml from FSF. The apt-howto has a short
notification in the document itself, while the full copy of the license is
provided in copyright, which is a part of the Debian packaging. Sure, it is
a native Debian package, so you might consider ./debian/copyright as "part
of the source" but still, it doesn't feel right.
My problem is that fdl.sgml is written in docbook instead of debiandoc. "No
problem," says I, "I'll just sed the docbook stuff in the document to make
it debiandoc instead." How naive I was. It didn't take very long to
discover that section numbering in the FDL relies on some features of
docbook I cannot find in debiandoc. Lists are too simple. <enumlist> is
wrong because it uses numbers. <taglist> is better, but requires me to
explicitly letter each section. What I really need is something that
automatically letters each section, as <orderedlist numeration="upperalpha">
would do in docbook.
But then it occurred to me that perhaps someone here has already made
a debiandoc fdl.sgml. Has anyone done that? If not, I'd like to give
it a try, but am such a newbie at sgml that I hope you'll tolerate my
questions if/when I get lost. :)
nSLUG http://www.nslug.ns.ca firstname.lastname@example.org
Debian http://www.debian.org email@example.com
[ pgp key fingerprint = 7F DA 09 4B BA 2C 0D E0 1B B1 31 ED C6 A9 39 4F ]
[ gpg key fingerprint = 395C F3A4 35D3 D247 1387 2D9E 5A94 F3CA 0B27 13C8 ]
--- Begin Message ---
Version: N/A; reported 2002-05-02
* Package name : subproject-howto
Version : 1.0
Upstream Author : synrg <firstname.lastname@example.org>
* URL : http://ftp.debian.org/
* License : TBA (FDL is under consideration)
Description : A HOWTO for starting a Debian subproject
There is an unreleased early draft of this native Debian package (html
version only) at:
It is obviously not finished yet, but it will be fleshed out and
version 1.0 will be uploaded before the end of this month.
I have deliberately chosen the shorter "subproject-howto" name rather
than "debian-subproject-howto" as the latter is a bit unwieldly.
Besides, "subproject of what project?" is implicit (cf. harden and
harden-* packages where "harden what distribution?" is implicitly
While my first draft was placed under the GPL, as this document
is patterned after junior-doc/quickguide which is currently
GPL'd, it will certainly not remain this way. I am considering
the GNU FDL license in spite of all of the recent controversy.
It seems to suit my purposes best.
The document is written in debiandoc format.
Ben Armstrong <email@example.com>
To UNSUBSCRIBE, email to firstname.lastname@example.org
with a subject of "unsubscribe". Trouble? Contact email@example.com
--- End Message ---