Further update, fop flops for me. Even with 784 megs allocated it goes 
nowhere.
Is there an alternative?

If there isn't I'd probably be willing to forgo the pdf for the html just to 
say on the same branch re docs.

----- Original Message ----- 
From: "steven yi" 
To: "Csound Developers Discussion List" 
Sent: Monday, January 10, 2005 1:24 AM
Subject: [CSOUND-DEV:5657] Docbook-XML Csound Manual


> Hi All,
>
> I've converted the Docbook Manual from SGML to XML and modified the 
> Makefile.  As it's a bit of a change, I thought I'd see if others can 
> compile it first as well as get some feedback on it before replacing the 
> SGML manual. I've put up a zip at:
>
> http://www.kunstmusik.com/csoundManual.zip
>
> With this zip, you'll need xsltproc installed compile to HTML and FOP 
> installed to produce a PDF.
> For Windows, xsltproc can be found in Cygwin, or standalone Windows 
> binaries at http://www.zlatkovic.com/libxml.en.html (I believe you'll need 
> the libxslt and libxml zip's from there).  For Linux, most distro's have 
> xsltproc installed.
>
> For FOP, it is available at: http://xml.apache.org/fop .  To get the 
> graphics to work, you'll need to also install the Java Advanced Imaging 
> API. Information about JAI is available at 
> http://xml.apache.org/fop/graphics.html#jai .  (BTW: FOP is written in 
> Java so requires a Java Virtual Machine installed; also, if you run FOP, I 
> recommend editing the fop.sh file and add "-Xmx384m" to the last line, so 
> it reads as such:
>
> $JAVACMD -Xmx384m -classpath "$LOCALCLASSPATH" $FOP_OPTS 
> org.apache.fop.apps.Fop "$@"
>
> This increases the max ram the VM can use to 384megs, which you'll need 
> for FOP to run as the manual is fairly large)
>
> I've tested this on Cygwin using Cygwin's xsltproc, MinGW using the 
> natively compiled xsltrpoc, as well as Linux.  The makefile in the zip is 
> set to compile with "make html" and  "make pdf", with the default set to 
> just HTML.
>
> Currently, the version in CVS still uses SGML but should be encapsulated 
> with respects to the stylesheets; this runs on Linux fine for me and 
> produces output identical to the ACRM.  On the other hand, I've gotten the 
> XML versions to run on multiple platforms, but the stylesheets are not 
> tweaked to be like the ACRM.
>
> If anyone could give this a try and let me know any feedback on how it 
> works for you (or doesn't), I'd appreciate it.
>
> Thanks,
> steven
>
> 

Regarding FOP, does it really flop or just produce a lot of error 
messages?  If it's just error messages and the pdf file is produced, 
everything is fine.  There's been changes to the xml-fo spec that FOP 
doesn't support and reports as an error but keeps going on anyways.  For 
me, I get a lot of error messages saying things about 
"relative-baseline". On the mailing lists I've seen, most people largely 
ignore those messages and the output comes out alright. 

Also, if you don't have JAI installed, fop my flop if it gets to the 
images and can't load the JAI imaging libraries to process them.

If neither are the issue, then could you send me the error messages you 
are receiving?

There are alternatives, but I haven't tried them, and the one I tried 
which is a popular alternative--passivetex--didn't work out for me at 
the time.

In general, for these types of things, I've been consulting this book:

http://www.sagehill.net/book-description.html

quite a bit; it's what helped me most when I was learning docbook-xml 
for use with blue's manual, figuring out what tools to use and how to 
customize the stylesheets.

steven

Michael Gogins wrote:

> Further update, fop flops for me. Even with 784 megs allocated it goes 
> nowhere.
> Is there an alternative?
>
> If there isn't I'd probably be willing to forgo the pdf for the html 
> just to say on the same branch re docs.

Steven,

I have prepared the XML files for the four new opcodes that have just been 
added
to csound, following your instructions. Can I send them to you?

all the best,

Victor



Victor Lazzarini
Music Technology Laboratory
Music Department
National University of Ireland, Maynooth 

Hi Victor,

I think I've already added the documentation, unless this is for four 
more opcodes I wasn't aware of.  (I believe this email somehow came 
late; if not, please feel free to send me any documentation and I will 
integrate.)

steven


Victor Lazzarini wrote:
> Steven,
> 
> I have prepared the XML files for the four new opcodes that have just 
> been added
> to csound, following your instructions. Can I send them to you?
> 
> all the best,
> 
> Victor
> 
> 
> 
> Victor Lazzarini
> Music Technology Laboratory
> Music Department
> National University of Ireland, Maynooth
> 
> 

you did.
Thanks
Victor
At 01:38 19/01/2005, you wrote:
>Hi Victor,
>
>I think I've already added the documentation, unless this is for four more 
>opcodes I wasn't aware of.  (I believe this email somehow came late; if 
>not, please feel free to send me any documentation and I will integrate.)
>
>steven
>
>
>Victor Lazzarini wrote:
>>Steven,
>>I have prepared the XML files for the four new opcodes that have just 
>>been added
>>to csound, following your instructions. Can I send them to you?
>>all the best,
>>Victor
>>
>>Victor Lazzarini
>>Music Technology Laboratory
>>Music Department
>>National University of Ireland, Maynooth

Victor Lazzarini
Music Technology Laboratory
Music Department
National University of Ireland, Maynooth