From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Alan W. Irwin" To: docbook-tools-discuss@sources.redhat.com Subject: Re: Where, what and how - The future of DocBook Date: Wed, 27 Dec 2000 06:36:00 -0000 Message-id: References: X-SW-Source: 2000/msg00412.html I am a member of a two-man team that converted a largish piece (more than 100 pages) of technical documentation from latexinfo to DocBook 4.1 XML. Fortunately, my partner is a real smart cookie so I let him handle most of the technical end. I have concentrated on editing the syntax changes with considerable help from him on doing the routine part of it with scripts. Since the conversion was completed I have been entering lots of extra content with an ordinary editor (jed). I understand there is a great DocBook interface available with emacs, but I haven't bothered with it yet because it is not really needed. From my experience I would assert you don't need any special tool to edit and improve documentation written in DocBook. The tags that are ordinarily used are easy to memorize. Of course, it probably helps that I am a good touch typist. If you don't have that skill I guess you need to find some tool that gives you WYSIWYG. But it wasn't necessary in my case, and I suspect that is true for most documenters. To move away from this useful but still rather generalized discussion, the only real concern I have about DocBook at the moment is getting glitch-free builds of our documentation with Cygnus DocBook 4.1 XML on Redhat 6.2 systems.... ;-) The major glitch for us is the pdfjadetex command does not work in the slightest (see my previous postings). I am confident that problem is such a glaring error with such a simple demonstration that it will be rapidly solved. We have no such glitches on our Debian DocBook 4.1 XML system for building our documentation so it provides a nice comparison to help sort out problems in the recent 4.1 XML Cygnus version of DocBook. Alan email: irwin@beluga.phys.uvic.ca phone: 250-727-2902 FAX: 250-721-7715 snail-mail: Dr. Alan W. Irwin Department of Physics and Astronomy, University of Victoria, P.O. Box 3055, Victoria, British Columbia, Canada, V8W 3P6 __________________________ Linux-powered astrophysics __________________________ From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Alan W. Irwin" To: docbook-tools-discuss@sources.redhat.com Subject: Re: Where, what and how - The future of DocBook Date: Tue, 05 Dec 2000 15:53:00 -0000 Message-ID: References: X-SW-Source: 2000-q4/msg00053.html Message-ID: <20001205155300.M4RmF7hKHFYO-iCMThIWYivRhfO3Bt8V4vcgWO6U1x8@z> I am a member of a two-man team that converted a largish piece (more than 100 pages) of technical documentation from latexinfo to DocBook 4.1 XML. Fortunately, my partner is a real smart cookie so I let him handle most of the technical end. I have concentrated on editing the syntax changes with considerable help from him on doing the routine part of it with scripts. Since the conversion was completed I have been entering lots of extra content with an ordinary editor (jed). I understand there is a great DocBook interface available with emacs, but I haven't bothered with it yet because it is not really needed. From my experience I would assert you don't need any special tool to edit and improve documentation written in DocBook. The tags that are ordinarily used are easy to memorize. Of course, it probably helps that I am a good touch typist. If you don't have that skill I guess you need to find some tool that gives you WYSIWYG. But it wasn't necessary in my case, and I suspect that is true for most documenters. To move away from this useful but still rather generalized discussion, the only real concern I have about DocBook at the moment is getting glitch-free builds of our documentation with Cygnus DocBook 4.1 XML on Redhat 6.2 systems.... ;-) The major glitch for us is the pdfjadetex command does not work in the slightest (see my previous postings). I am confident that problem is such a glaring error with such a simple demonstration that it will be rapidly solved. We have no such glitches on our Debian DocBook 4.1 XML system for building our documentation so it provides a nice comparison to help sort out problems in the recent 4.1 XML Cygnus version of DocBook. Alan email: irwin@beluga.phys.uvic.ca phone: 250-727-2902 FAX: 250-721-7715 snail-mail: Dr. Alan W. Irwin Department of Physics and Astronomy, University of Victoria, P.O. Box 3055, Victoria, British Columbia, Canada, V8W 3P6 __________________________ Linux-powered astrophysics __________________________