MathPack - Best way to Package & Document?

Frank Sergeant frank at canyon-medical.com
Mon Jul 23 22:19:55 UTC 2001


"Jarvis, Robert P. \(Contingent\)" <Jarvisb at timken.com> writes:

> > What is a good method of handling the documenation?  Word 2000?
> 
> As far as the docs go, MS-Word would be a pretty poor choice ...

I could not agree more.

I have adopted HTML as my primary documentation delivery format.
I have just made the plunge into DocBook and so far I am happy.
I'll see how it goes as I get more experience with it.  Anyway,
the easiest way to deal with DocBook is to install sgmltools 
in Linux or Unix.  The "source" document is kept in sgml or xml
and 'sgml2html' produces an html version, complete with 
automatically generated table of contents.  Similarly, plain
text, TeX, PostScript, etc. can be produced from the same
original source document.

I have had certain concerns that it is overkill and that
a much simpler markup would be better (there are various
"no tags" initiatives).  On the other hand, I edit the
sgml source in emacs with syntax highlighting and think
I'll be able to live with it.

Just in case any of that helps,

-- Frank
frank at canyon-medical.com




More information about the Squeak-dev mailing list