Re: About the docs
Bram Moolenaar <[email protected]>
| Newsgroups | gmane.comp.tools.aap.user |
|---|---|
| Message-ID | <[email protected]> |
Dan Sharp wrote: > >>Sorry, I forgot about that. The DTD archive is at > >>http://www.oasis-open.org/docbook/xml/4.2/docbook-xml-4.2.zip > > > > OK, I managed to make xsltproc get started. > > > > Now I get lots of errors about things that SGML apparently admitted but > > XML does not. Such as using </> to end a field. > > > > Before I go over the text and fix all the errors, what will be advantage > > of using XML instead of SGML? The kind of tags is still the same, thus > > it won't make it easier for me to write the documentation. > > You will probably want more than my subjective opinion, but I would do > it for the future compatibility. The changes to make it work with XML > will still (in my experience) work with SGML, so they are backwards > compatible. I just found out the changes are not backwards compatible. In SGML I was using: <colspec colwidth='1.5in'> In XML it gives an error, the tag must be terminated, thus I changed it to: <colspec colwidth='1.5in'/> But that is (unexpectedly) not accepted in SGML. There might be more problems, I didn't try fixing all errors that were reported for the XML version (most were for using </> instead of a real tag closing). -- How To Keep A Healthy Level Of Insanity: 8. Don't use any punctuation marks. /// Bram Moolenaar -- [email protected] -- http://www.Moolenaar.net \\\ /// Creator of Vim - Vi IMproved -- http://www.Vim.org \\\ \\\ Project leader for A-A-P -- http://www.A-A-P.org /// \\\ Help AIDS victims, buy here: http://ICCF-Holland.org/click1.html /// ------------------------------------------------------- This SF.Net email sponsored by: Free pre-built ASP.NET sites including Data Reports, E-commerce, Portals, and Forums are available now. Download today and enter to win an XBOX or Visual Studio .NET. http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01