This question is for Javier and whoever else wishes to respond. It is not urgent. Answer when you have some time. I am writing some documentation. For the sake of reference, my document assumes that the reader runs Debian, but in fact the document is probably more or less useful on any Unix-style system, from Solaris and Red Hat to FreeBSD and Mac OS X. Whether anyone will ever package the document for those other systems, I don't know: it is not a matter of great concern to me. My question is: is it normal and acceptable in your view to mark this kind of document up in debiandoc-sgml, or would it be better to mark it up in docbook-sgml/xml? Personally, I have no strong preference, but this is because I do not yet adequately understand the issues involved. I do know that I want the document to look as good as possible when printed on paper. However, the Debian Project's objections against OASIS, which governs docbook, make me wonder whether using docbook is the right thing to do, especially when an alternative (debiandoc) seems to be available. Actually, in the past I have usually used LaTeX for this kind of thing; but people seem to prefer the SGML/XML markups for software documentation these days. If people like SGML/XML, then okay, I'll use it. But, docbook or debiandoc? Advice is requested. Please copy to me. -- Thaddeus H. Black 508 Nellie's Cave Road Blacksburg, Virginia 24060, USA +1 540 961 0920, t@b-tk.org, thb@debian.org
Attachment:
pgpqXgwPUp49C.pgp
Description: PGP signature