Stephane Bortzmeyer <[EMAIL PROTECTED]> writes: > On Saturday 2 October 1999, at 15 h 12, > Adam Di Carlo <[EMAIL PROTECTED]> wrote: > > > I didn't read all the sections yet but I find it odd that you go > > into how to install the SGML/XML environment prior to launching into > > expositions on how to work with the various DTDs. > > I don't understand: there are no real explanations about "how to install the > SGML/XML environment" since I just assume "apt-get install task-sgml".
Still -- this instruction, simple as it is, should be *ahead* of the discussion on the various DTDs, so the user can follow along with the document. > > I also think you need to add a brief section talking about the > > Debian SGML/XML infrastructure briefly, mentioning sgml-base and the > > "SGML Sub-Policy" contained in that package. > > I hesitate: the purpose of the HOWTO is to be practical, so that people can > start as soon as possible. It is intended for people who wish to write a > Linux > HOWTO, or to patch a Debian documentation, or to print a DocBook file they > received, not for Debian SGML maintainers or students in markup languages. > > Anyway, if someone writes a nice paragraph about the Debian SGML > infrastructure (for slink and for potato), I would be glad to include it. > Otherwise, I'll try to hack something. The reason I think it's good is that advanced editors need SGML/XML entity mgmt capabilities (add/override entities). > > and the sgml-tools > > list, and the DocBook mail list. > > I point to their respective Web sites, where this info is. Beginners in a > hurry don't want to subscribe to a mailing list to start. Oh, ok, I didn't notice that. Its probably better to point to a well-known web page rather than a mail list. > > You might also add > > cygnus-stylesheets, which is used in particular by the gnome folks. > > I do not know them a lot. I will postpone their inclusion until I had time to > examine them. Sure... these are mostly useful as the db2x scripts. > > I'd be pleased to offer you CVS space in the > > cvs.debian.org:/cvs/debian-doc area if you want it. > > I was planning to ask you for that, as soon as the HOWTO is sufficiently > debugged. Well, let me know a good CVS modules name and I'll add it. Nice work Stephane! Maybe once it's in CVS you'll allow me to hack on it a bit, smoothing over the rough spots. -- .....Adam Di [EMAIL PROTECTED]<URL:http://www.onShore.com/>
