Slight cleanup of documentation?

[Torsten Anders]

Dear Non,

help at the Mozart documentation is welcome!

> It looks like you start out with sgml files, which get turned into
> html.

You probably already found the documentation of the SGML format at

   http://www.mozart-oz.org/documentation/ozdoc/index.html

This is then used to render pdf and HTML. The ozdoc use its briefly  
discussed in the following mail by Denys Duchier.

   http://www.mozart-oz.org/lists/oz-users/5071.html

I quote two sections:

   ozdoc itself is fairly simple. Try "ozdoc --help"

   Oz doc processing will never be documented. It is a relic of the
past. Nowadays, we would just use XML/XSLT, with perhaps some extras
thrown in (e.g. for highlighting), but it would all be standard and
much more straighforward.


Best
Torsten


On Jan 11, 2008, at 5:25 PM, RGC wrote:

> Hi Folks,
>
> I'm new to Mozart and Oz, and as I was looking through the
> documentation I noticed that there are a few rough edges that
> I thought indicated that English was perhaps not the first
> language of the authors.
>
> Maybe I can do something about that.  I'm offering to work my
> way through the documentation, starting with the tutorial, and
> make near-minimal changes to make it read better and express
> what I think the authors are trying to express.
>
> I'm using Kubuntu 7.10 and I've downloaded the source package.
> It looks like you start out with sgml files, which get turned into
> html.  I've never edited an sgml file, but I've found a mode for
> emacs mode for editing them. (Emacs is far from my first choice
> for editing text, but I guess I could stand it.)
>
> Are there any better solutions for editing sgml files on Kubuntu?
> Or perhaps even on Windoze XP?
>
> Is there a more recent version of the documentation that I should work
> from,
> rather than what I find in mozart_1.3.2.20060615+dfsg.orig.tar.gz ?
>
> Any other hints/advice/encouragement?
>
>
> Regards, Non.
>
> ______________________________________________________________________ 
> ___________
> mozart-users mailing list                               mozart- 
> users at mozart-oz.org
> http://www.mozart-oz.org/mailman/listinfo/mozart-users

--
Torsten Anders
Interdisciplinary Centre for Computer Music Research
University of Plymouth
Office: +44-1752-233667
Private: +44-1752-558917
http://strasheela.sourceforge.net
http://www.torsten-anders.de