Advogato blog for kevindumpscore

22 Sep 2002

Sun, 22 Sep 2002 22:54:28 GMT

I updated the Alternative Csound Reference Manual to edition 4.21-1. This manual covers the latest version of the Csound program, 4.21. If you don't know, Csound is a sound synthesis program: http://www.csounds.com/.

I added documentation for the following opcodes: a, butbp, butbr, buthp, butlp, cngoto, convle, else, elseif, endif, ftload, ftloadk, ftsave, ftsavek, ink, invalue, ktableseg, oscilx, outk, outvalue, reverb2, subinstr, and sense.

DocBook/SGML, HTML, PDF, or ASCII text versions are available for download from here:
http://kevindumpscore.com/download.html#csound-manual

You can always look at the on-line edition here:
http://kevindumpscore.com/docs/csound-manual/

10 Jun 2002

Mon, 10 Jun 2002 06:10:08 GMT

I updated The Alternative Csound Reference Manual to edition 4.20-1. You can either download it or read it on-line. Here is a summary of the changes...

4.20-1 "Dee Dee Ramone Memorial" Edition:

Updated the examples for these opcodes: adsyn, flashtxt, grain3, grain, hrtfer, spat3d_UHJ, wgbowedbar, and wterrain.
Added the documentation for these opcodes: clfilt, midichannelaftertouch, midichn, midicontrolchange, mididefault, midinoteoff, midinoteoncps, midinoteonkey, midinoteonoct, midinoteonpch, midipitchbend, midipolyaftertouch, midiprogramchange, pgmassign, scanhammer, scantable, and xscanmap.
Updated the documentation for these opcodes: GEN30, valpass, and vcomb.

5 May 2002

Sun, 5 May 2002 04:52:18 GMT

Updated the Alternative Csound Reference Manual to edition 4.19-5. You can download it or read it online. Here's the play-by-play from the news.txt file...

4.19-5 "Stockhausen meets Aphex Twin" Edition:

Added examples for these opcodes: alpass, bexprnd, buzz, comb, event, expon, exprand, expsega, expsegr, flanger, gauss, gbuzz, line, linrand, linseg, linsegr, lowres, lowresx, mandol, mpulse, noise, pcauchy, pluck, poisson, rand, randi, streson, unirand, vlowres, and weibull.
Updated the examples for these opcodes: betarand, butterbp, butterbr, butterhp, butterlp, cauchy, expseg, fold, gogobel, marimba, randh, repluck, resony, reverb, rnd31, tempest, trirand, vibes, waveset, wgbow, wgbrass, wgclar, wgflute, wgpluck, and wgpluck2.
Pieced together the missing documentation for the event opcode. Thanks goes to Matt Ingalls for helping me fix my example.
HTML edition: Gave every command synopsis a normal format instead of a verbatim one. Got rid of the shading on programlistings.
Added the "marmstk1.wav" audio file to the examples sub-directory.

28 Nov 2001

Wed, 28 Nov 2001 19:47:11 GMT

TeX is supposedly bug-free. IT IS NOT!

TeX is written with hard-coded memory limits. Last night, I changed some of the 16-bit limits in its source code. But when I typed a "make distclean", it erased my entire /usr/bin/ sub-directory! Now I no longer have a gcc proogram.

TeX Sucks!!!!!!!!

21 Nov 2001

Wed, 21 Nov 2001 04:22:59 GMT

TeX sucks! No matter what I enter into my texmf.cnf, I keep getting: "TeX capacity exceeded, sorry [number of strings=51768]." I'll dance for joy the day I can switch from jadetex to a capable Open Source XSL-FO processor!

I saw that the FreeBSD Documentation Project published a 400 page users manual. How did they do it? Where is their texmf.cnf? Which DSSSL stylesheets did they use? Where's the source?

13 Nov 2001

Tue, 13 Nov 2001 06:37:05 GMT

Is anyone working on an Open Source XSL-FO processor that conforms to the 15 October 2001 XSL spec? I'm maintaining a 500+ page manual and FOP doesn't work for me. FOP is written in Java and requires way more RAM than I have available. Add to the FOP's problems with table formatting and you have one frustrated dude.

13 Nov 2001

Tue, 13 Nov 2001 06:13:01 GMT

Cactus decided to stick with his hacked-together guikachu-doc XML standard. He will use XSL to convert it to DocBook. XML makes this type of thing straight-forward. But I'm not really interested in helping him write a users manual with guikachu-doc.

NIH (Not Invented Here) syndrome is alive and well in the Open Source community.

7 Nov 2001

Wed, 7 Nov 2001 19:21:46 GMT

I stayed up past midnight converting the guikachu documentation to DocBook. I used the <variablelist> tag but this looks horrible when rendered using pdfjadetex. I tried htmldoc instead and that looks much better.

I emailed the URLs for my work to Cactus but I've yet to hear back. Will my changes be incorporated? Will my efforts be ignored? Stay tuned.

6 Nov 2001

Tue, 6 Nov 2001 19:44:18 GMT

Update! Cactus of the guikachu project just sent me an email. He said I could go forward and convert his documentation from his hacked-together guikachudoc format to DocBook.

I'll work on it tonight after work.

6 Nov 2001

Tue, 6 Nov 2001 16:16:44 GMT

I have been a long-time user of the music synthesis program Csound. It is free-to- use and you can look at its source code but it's not Open Source. It uses an MIT license with a clause that restricts its use to academic and research purposes.

I have been secretly working on converting its 500+ reference manual to DocBook. But since it's not Open Source, it's hard for me to get motivated enough to finish. I keep reminding myself that I'm making it "more free".

Richard Dobson, maintainer of Csound's phase vocoder code, has been looking for loopholes so that they can steal GPL code. To me, this is plain wrong. They need to make Csound Open Source instead.

Of course, this will never happen. Not until some people at MIT pick up the clue phone. If you think going up against Microsoft is hard, try the insular world of academia.