On Mon, Aug 18, 2008 at 2:31 PM, Torsten Anders < [EMAIL PROTECTED]> 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)? > To generate documentation is just a nightmare before every mozart release. I think we should explore other ways to generate documentation in html, pdf and maybe chm (windows) formats. The point here is to see what we need from a documentation generating system: 1) To parse sgml or xml as input formats. In this way changes won't be (hopefully) so huge. Currently nsgmls is used for this. 2) Render latex formulas which are embedded in the document with a special tag. 3) To highlight oz syntax (most of the examples). Currently emacs is used for this. Any suggestion is welcome on the topic. I think the time spent in setting up a system (all the packages with right the corresponding versions) to be able to generate the documentation increases from time to time and having something standard and recent might save time in the future. For instance, we should take a look at DocBook. Cheers, Gustavo
_________________________________________________________________________________ mozart-users mailing list [email protected] http://www.mozart-oz.org/mailman/listinfo/mozart-users
