---
author: ''
category: ''
date: 2007/02/09 12:38
description: ''
link: ''
priority: ''
slug: P467
tags: programming, qmail, ra-plugins
title: Playing with literate programming
type: text
updated: 2007/02/09 12:38
url_type: ''
---
I am using ra-plugins as a toy to do things I never bothered in other projects.

I am doing unit-testing. And now... some literate programming!

Ok, not much, and not very well, but at least I am playing with Lp4all_ which is a nice, simple tool to generate nice HTML from slightly wiki-marked sources.

You can see some little things in my code here_. My veredict so far? A nice way to keep the code documented in a fashion that ocasinal browsers can follow.

The main thing missing is automatic cross-referencing.

In general, I am finding that this (and unit testing) helps me express explicitly to myself what the heck I am trying to do, and see if the code actually does it. Which is a really good thing.

.. _here: //ralsina.me/lateral/literate/utils.h.html

.. _lp4all: http://www.linux-france.org/~dmentre/lp4all/