Meeting up at LinuxTag 2012

Like every year, I am driving to Berlin this week to attend LinuxTag 2012 to attend the excellent program. If you want to meet up and chat about projects, technologies, Free Software or other things, send me an email or leave a comment with this post and we will arrange for it.

Syndicated 2012-05-15 13:12:56 from Tim Janik

Testbit Tools Version 11.09 Released

(Image: Mag3737)

And here’s another muffin from the code cake factory…

About Testbit Tools
The ‘Testbit Tools’ package contains tools proven to be useful during the development of several Testbit and Lanedo projects. The tools are Free Software and can be redistributed under the GNU GPLv3+.

This release features the addition of buglist.py, useful to aid in report and summary generation from your favorite bugzilla.

Downloading Testbit Tools
The Testbit Tools packages are available for download in the testbit-tools folder, the newest release is here: testbit-tools-11.09.0.tar.bz2

Changes in version 11.09.0:

Feedback

If you find this release useful, we highly appreciate your feature requests, bug reports, patches or review comments!

See Also

1. The Bugzilla Utility buglist.py – managing bug lists
2. Wikihtml2man Introduction – using html2wiki

Syndicated 2011-10-01 00:18:55 from Tim Janik

Wikihtml2man Introduction (aka html2man, aka wiki2man)

What’s this?
Wikihtml2man is an easy to use converter that parses HTML sources, normally originating from a Mediawiki page, and generates Unix Manual Page sources based on it (also referred to as html2man or wiki2man converter). It allows developing project documentation online, e.g. by collaborating in a wiki. It is released as free software under the GNU GPLv3. Technical details are given in its manual page: Wikihtml2man.1.

Why move documentation online?
Google turns up a few alternative implementations, but none seem to be designed as a general purpose tool. With the ubiquituous presence of wikis on the web these days and the ease of content authoring they provide, we’ve decided to move manual page authoring online for the Beast project. Using Mediawiki, manual pages turn out to be very easily created in a wiki, all that’s then needed is a backend tool that can generate Manual Page sources from a wiki page. Wikihtml2man provides this functionality based on the HTML generated from wiki pages, it can convert a prerendered HTML file or download the wiki page from a specific URL. HTML has been choosen as input format to support arbitrary wiki features like page inclusion or macro expansion and to potentially allow page generation from other wikis than MediaWiki. Since wikihtml2man is based purely on HTML input, it is of course also possible to write the Manual Page in raw HTML, using tags such as h1, strong, dt, dd, li, etc, but that’s really much less convenient to use than a regular wiki engine.

What are the benefits?
For Beast, the benefits of moving some project documentation into an online wiki are:

• We increase editability by lifting review requirements.
• We are getting quicker edit/view turnarounds, e.g. through use of page preview functionality in wikis.
• We allow assimilation of user contributions from non-programmers for our documentation.
• Easier editability may lead to richer documentation and possibly better/frequently updated documentation.
• Other projects also seem to make good progress by opening up some development parts to online web interfaces, like: Pootle translations, Transifex translations or PHP.net User Notes.

What are the downsides?
We have only recently moved our pages online and still need to gather some experience with the process. So far possible downsides we see are:

• Sources and documentation can more easily get out of sync if they don’t reside in the same tree. We hope to be mitigating this by increasing documentation update frequencies.
• Confusion about revision synchronization, with the source code using a different versioning system than the online wiki. We are currently pondering automated re-integration into the tree to counteract this problem.

How to use it?
Here’s wikihtml2man in action, converting its own manual page and rendering it through man(1):

  wikihtml2man.py http://testbit.eu/Wikihtml2man.1?action=render | man -l -

Where to get it?
Release tarballs shipping wikihtml2man are kept here: http://dist.testbit.eu/testbit-tools/.
Our Tools page contains more details about the release tarballs.

Have feedback or questions?
If you can put wikihtml2man to good use, have problems running it or other ideas about it, feel free to drop me a line about it. Alternatively you can also add your feedback and any feature requests to the Feature Requests page (a forum will be created if there’s any actual demand).

What’s related?
We would also like to hear from other people involved in projects that are using/considering wikis to build production documentation online (e.g. in manners similar to Wikipedia). So feel free to leave a comment about your project if you do something similar.

See Also

1. New Beast Website – using html2wiki
2. The Beast Documentation Quest – looking into documentation choices

Syndicated 2011-05-12 23:49:23 from Tim Janik

Attending LinuxTag 2011

Like every year, I am driving to Berlin this week to attend LinuxTag 2011 to attend the excellent program. If you want to meet up and chat about projects, technologies, Free Software or other things, send me an email or leave a comment with this post and we will arrange for it.

Syndicated 2011-05-09 12:29:55 from Tim Janik

BEAST v0.7.4 released

BEAST/BSE version 0.7.4 is available for download at:

• http://beast.testbit.eu/_dist/beast/v0.7/
• This release integrates the bse-alsa driver for which no seperate package is now needed.

BEAST is a music composition and modular synthesis application released as free software under the GNU LGPL that runs under Unix. Refer to the About page for more details.

The 0.7.4 release integrates the bse-alsa package, several speedups, important bug fixes and translation updates.

Please feel free to provide useful feedback or contribute on IRC, the mailing list and in the Wiki.

TRANSLATORS: Please help us to improve the BEAST translation, just download the tarball, edit po/.po and email it to us or submit translations directly via the Beast page at Transifex.

Overview of Changes in BEAST/BSE 0.7.4:

• Renamed the project to Better Audio System / Better Sound Engine
• Moved project website to: http://beast.testbit.eu/
• Various build system fixes [stw,timj]
• License fixups for some scripts [stw]
• Fixed subnormal tests on AMD64 if SSE unit is in DAZ mode [stw]
• Replaced slow resampler checks with a much faster resampling test [stw]
• Performance improvements for various tests [stw]
• GLib 2.28 unit test porting [stw]
• Speed improvements for record field name [stw]
• Fixed XRUNs in ALSA driver on 64bit systems [timj]
• Added beast.doap [Jonh Wendell]
• PO handling improvements.
• Updated German translation.
• Updated Norwegian bokmål translation [Kjartan Maraas]
• Added e-Telugu translation [Veeven]

Syndicated 2011-04-09 01:50:16 from Tim Janik