Re: About the docs

IMHO, there is no substitute for LaTeX.  So far I can't really see much 
support for quality, easy to use, mathematics typesetting with anything other 
than LaTeX.  Computer programming is linked with math enough that in my 
opinion, anything lacking real math support is not worth learning.

So far I find DocBook too complicated to setup, use, and debug.

On Thursday 31 July 2003 01:13 pm, Dan Sharp wrote:
> Bram Moolenaar wrote:
> > 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 verified that I could use my XML docbook as the
> source in the openjade toolchain on RedHat 7.3 where I had originally
> used SGML source.  The reason I went with XML when I first started was
> because I read somewhere that future development was going to focus more
> on XML than SGML.  One tutorial I looked at about Installing and Using
> XML/SGML DocBook Editing Suite (
> http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tut
>orials/docbooksys/segmentedhtml/ ) has a small section on SGML vs. XML, but
> didn't say a whole lot, other than to recommend XML if you are starting new
> (it does have a short section and screenshot of Vim, the preferred editor
> of the author, so the author must know what (s)he is talking about :)  ).
>
> There is on online book about DocBook XSL at
> http://www.sagehill.net/book-description.html
>
> Anyway, just some thoughts.  I am by no means an experienced DocBook user.
>
> Dan Sharp
>
>
>
> -------------------------------------------------------
> 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
> _______________________________________________
> A-A-P-user mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/a-a-p-user

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQA/KVU0MDqogpR5tkMRAg9pAJ9gy+xXX4J0HHHLpjZ/1aizIOLNyQCghGCg
9ETddT3Q0q11k6QRFnoPOUg=
=PTrs
-----END PGP SIGNATURE-----