Older blog entries for kevindumpscore (starting at number 5)

7 Nov 2001 (updated 7 Nov 2001 at 19:22 UTC) »

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.

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 (updated 6 Nov 2001 at 16:31 UTC) »

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.

6 Nov 2001 (updated 6 Nov 2001 at 01:49 UTC) »

Cactus posted a note on the gnome-doc mailing list asking for documentation help on his project. But instead of using DocBook (the Gnome standard) for his documentation, he is using some home-brewed standard he concocted by himself. Check out this XML document in the "guikachudoc" format (http://cvs.gnome.org/lxr/source/guikachu/doc/resources .xml)

Why are programmers/project leaders so afraid of DocBook?

What if every single Gnome program has its own ad-hoc documentation standard? That would be a maintenance nightmare. We need a standard for Open Source documentation! DocBook is what most of the major projects use.

His project, Guikachu , does seem cool though. It's a graphical editor that helps one design screens for Palm PDA programs. If you've ever typed PILRC resource files by hand, you'd realize that this program is a major time-saver.

6 Nov 2001 (updated 6 Nov 2001 at 16:33 UTC) »

Another project shot me down this past week. John Lazzaro of the sfront project wasn't interested in using DocBook. He wanted to keep his reference manual's horrendous HTML layout.

This layout is horrible (http:// www.cs.berkeley.edu/~lazzaro/sa/sfman/), it uses multiple tables with two separate running columns. The tables break in strange places. Sometimes the columns are only tenuously related to each other. It doesn't make any sense. Attempting to read it gives me a headache.

At least he keeps it up-to-date, uses FDL, and provides a way to look at it off-line. IMHO, that puts him light-years ahead of most Open Source projects as far as documentation goes.

6 Nov 2001 (updated 6 Nov 2001 at 00:50 UTC) »

Just got an advogato account today.

I find this interface very frustrating. Now all of a sudden, I can enter diary entries. Do I have to wait a certain amount of time before I am permitted to do things? It doesn't make sense.

In order to login I have to hit the People link. Then I see an Account link at the bottom of that page. Why can't I just login from the main page like Slashdot? I had to wade through a couple of links to get to this diary entry page too.

Who do I contact when I have problems? I don't see any contact information on the site. How do I join a project listed on advogato? Do I have to send an email to the person who maintains it? How do you send an email to someone else with an advogato account.

Where's a FAQ? Arrrrrrrgh!

New Advogato Features

New HTML Parser: The long-awaited libxml2 based HTML parser code is live. It needs further work but already handles most markup better than the original parser.

Keep up with the latest Advogato features by reading the Advogato status blog.

If you're a C programmer with some spare time, take a look at the mod_virgule project page and help us with one of the tasks on the ToDo list!