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? The
Mozart community would certainly welcome any English-language
proofreading of the documentation.
Best
Torsten
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 mozart-
[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
