From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Sam Roberts" To: Subject: Re: I'm trying to set up docbook-tools... Date: Wed, 27 Dec 2000 06:36:00 -0000 Message-id: <001901bfe68f$01e59c40$1403a8c0@cogent.ca> References: <200007041511.LAA15779@snark.thyrsus.com> <00070410352500.07357@ehome.inhouse> <00070510365404.00678@needaguru> X-SW-Source: 2000/msg00215.html > > Despite all of the above, I have become reasonably proficient in using the > > Docbook-Tools set and in Docbook itself. But the tool kits still do not work > > well enough for me to actually use them to produce real documentation. I am They work well enough for us, so it is possible! See: http://www.cogent.ca/Download/Documents.htm The slang programmin language and cascade db docs are all from docbook. I wrote my own scripts and makefiles to drive jade and [pdf]jadetex based on taking a peek into the db2* scripts. It took a while, but it was no harder than dealing with LaTeX, back when I used it in university. Sgml isn't really a documentation language, it's a markup language, the markup is then used to generate documentation, by some people, and with some tools. For those of us who actually want documentation, the vagueness of all the sgml docs when it comes to actually generating documentation is frustrating, but sgml+docbook+jade+jadetex are still the best tools around. > additionally i would suggest you subcribe to > > docbook-apps@lists.oasis-open.org, I second this. docbook-apps is very active, and very helpful, if you're trying to use docbook you should be on this list. Sam From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Sam Roberts" To: Subject: Re: I'm trying to set up docbook-tools... Date: Wed, 05 Jul 2000 07:32:00 -0000 Message-ID: <001901bfe68f$01e59c40$1403a8c0@cogent.ca> References: <200007041511.LAA15779@snark.thyrsus.com> <00070410352500.07357@ehome.inhouse> <00070510365404.00678@needaguru> X-SW-Source: 2000-q3/msg00013.html Message-ID: <20000705073200.9MpWD7BnxDXbdropIgvfpGOhWZlpnxiz3UO6Ii9EZnw@z> > > Despite all of the above, I have become reasonably proficient in using the > > Docbook-Tools set and in Docbook itself. But the tool kits still do not work > > well enough for me to actually use them to produce real documentation. I am They work well enough for us, so it is possible! See: http://www.cogent.ca/Download/Documents.htm The slang programmin language and cascade db docs are all from docbook. I wrote my own scripts and makefiles to drive jade and [pdf]jadetex based on taking a peek into the db2* scripts. It took a while, but it was no harder than dealing with LaTeX, back when I used it in university. Sgml isn't really a documentation language, it's a markup language, the markup is then used to generate documentation, by some people, and with some tools. For those of us who actually want documentation, the vagueness of all the sgml docs when it comes to actually generating documentation is frustrating, but sgml+docbook+jade+jadetex are still the best tools around. > additionally i would suggest you subcribe to > > docbook-apps@lists.oasis-open.org, I second this. docbook-apps is very active, and very helpful, if you're trying to use docbook you should be on this list. Sam