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.
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.
On Aug 15, 2008, at 1:28 AM, R. G. Cottrell wrote:
Some time ago I made a sincere offer to do some light editing on the
Mozart-Oz documentation to remove some of the peculiarities that marked
it out as the product of someone who is not a native speaker of English.
I saw that as something useful that I could do to help the open source
movement while at the same time learning to use a quite strange (to me)
computer language that seemed to have some very elegant design features.
Unfortunately, my multiple, frustrating, attempts to make minor changes
to the content came to nought, because I was completely unable to fathom
the process required to build the docs from scratch, or make the mods
and see them reflected in the hypertext interface. As a result, my plan
to read and understand the entire body of documentation, starting with
the tutorial, fell flat.
Somebody who is familiar with sgml and XML should get off their butt and
either make the shift to some sort of XML or at least correct the build
process so that it builds the docs.
It's like you guys are deliberately being obstructive!
Comments, anyone?
Regards, Graeme.
_________________________________________________________________________________
mozart-users mailing list
[email protected]
http://www.mozart-oz.org/mailman/listinfo/mozart-users
--
Torsten Anders
Interdisciplinary Centre for Computer Music Research
University of Plymouth
Office: +44-1752-586219
Private: +44-1752-558917
http://strasheela.sourceforge.net
http://www.torsten-anders.de
_________________________________________________________________________________
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
