Boriss Mejias wrote:
Yves Jaradin wrote:
R. G. Cottrell wrote:
Torsten Anders wrote:
Dear Graeme

I do understand your frustration.

It's like you guys are deliberately being obstructive!

Denys Duchier mentioned in an email already back in 2003 that Oz doc is a "relic of the
past" (http://www.mozart-oz.org/lists/oz-users/5071.html).

Although Denys says that ozdoc is easy to use for own documentation files, it appears this is not the case with the Mozart documentation itself. For example, it seems it requires an nsgmls installation. Has anyone an idea how to render (parts of) the Mozart documentation without "any frills" (e.g., only HTML)?

Anyway, Graeme, I was also not able to render the documentation. Nevertheless, I did some minor documentation edits myself. I simply changed the SGML files without any rendering. Others later did the rendering into the various supported formats.

Do you feel this could be a suitable approach for yourself?
No, I'm afraid not. I want to be able to work for long periods of time disconnected from the net and not asking anyone's permission to do a complete rebuild.
You are of course welcome to build it yourself.
You will need at least the following tools:

Mozart (with contribs; at least gdbm, doc/SGML and os)
emacs
nsgmls
LaTeX (latex makeindex bibtex) with packages: mathptm, times, pstricks, pst-node, pifont, rotate and epsfig
dvips
Perl
Java
pnmcrop pnmscale pnmquant pnmtopng
gs

It will also probably be possible to use the build system only on Linux/Mac OS X/Unix as the Makefile uses mkfifo, etc. that are probably not available on cygwin/mingw.

For packaging Mozart on windows, the whole system is built on cygwin except for the documentation, which is built on a Linux machine, then moved to windows for running the script that creates chm files for windows doc. So you will need a unix machine for building the doc.
It just so happens that I have a dual-boot Linux/XP Pro box with Cygwin installed. :-)

cheers
Boriss
Cheers to you too, Boriss!

Graeme.


LaTeX is needed even to build the HTML docs as it is used to render the mathematical equations (I forgot about that in my previous email).

Feel free to ask about any error you may get as it seems that nobody knows the exact dependencies needed to build the documentation.

Cheers,
Yves
The Mozart community would certainly welcome any English-language proofreading of the documentation.
Yeah, well, my intentions were certainly there, but I wanted to see the thing build successfully before committing my time to going through the pain of multiple-times
negotiations and net traffic exposure.
I also don't want, any more than necessary, to be dependent on anyone else's good will in order to achieve what I set out to do.

Best
Torsten
Regards, Graeme.

_________________________________________________________________________________ mozart-users mailing list [email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users
_________________________________________________________________________________ mozart-users mailing list [email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users


_________________________________________________________________________________
mozart-users mailing list                               
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users

Reply via email to