David Douthitt and Mike Noyes wrote: > On Fri, Aug 23, 2002 at 05:54:58AM -0700, Mike Noyes wrote: > > On Thu, 2002-08-22 at 20:14, David Douthitt wrote: > > > On Thu, Aug 22, 2002 at 04:44:47AM -0700, Mike Noyes wrote: > > > > FreeBSD should have full support for DocBook XML. <snip> > > This is why I recommend PSGML with Emacs. PSGML parses the appropriate > > DTD, and provides a context sensitive pop-up of available tags. Learning > > the tags isn't that hard, but figuring out which tags you can use within > > others is difficult. PSGML only shows valid tags at a particular point > > in the document. > > Maybe I should try Emacs again.
I was thinking about this post the other day. The list of tags sounds like a nice Emacs feature, but I wouldn't choose the tool on its DTD parsing alone. I do not believe you have to be flexible here. I believe the problem LDP and Gnome documentation have is that they have existed for some time. Hence, much of the work is written in docbook 3.1 and SGML. LEAF is starting the docbook process at 4.1 while I believe 4.2 was just released. If as some of the LDP and Gnome howtos point out that everything is moving to XML, then set a policy that LEAF docbook work will be in docbook 4.2 and use only the XML DTD. I would recommend that this happen but there are other issues that I may not be thinking about that would say stay with SGML. For example: http://www.tldp.org/LDP/LDP-Author-Guide/docbook.html ... "The Extensible Markup Language (XML) has all the advantages of SGML, but is getting much more press and development time. For the purposes of writing documentation, the differences are minimal. "This brings us back to DocBook, which is a DTD available for both SGML and XML. Since the tags themselves do not change when moving from DocBook XML to DocBook SGML, much of this guide will apply to both versions of the DTD. Please especially see http://www.tldp.org/LDP/LDP-Author-Guide/docbookxml.html. This page explains the reason to go to docbook xml and what the transition issues are. I do not have transition issues because I am just starting. ;-) ... "There are a few changes between writing XML and SGML. Handling these differences should be relatively easy for most small documents, and many authors will not need to make any changes except for the XML declaration and DocBook declaration at the start of their document. ... What do you all think? Greg Morgan ------------------------------------------------------- This sf.net email is sponsored by: Jabber - The world's fastest growing real-time communications platform! Don't just IM. Build it in! http://www.jabber.com/osdn/xim _______________________________________________ Leaf-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/leaf-devel