Just as with itemised lists, would it be possible to provide rudimentary table support?
Something like this would be great:
/****f* Bar/foo
* FUNCTION
* foo computes the foo factor.
* SYNOPSIS
*/
int foo( float correction, int method )
/*
* PARAMETERS
* correction - correction factor
* method - calculation method to use
* NOTES
* method should be one of the following:
* ||method||description||
* |M_GUESS|Make a random guess|
* |M_MONTECARLO|Monte Carlo simulation|
* |M_RECURSE|Infinite-recursion algorithm|
* BUGS
* None
*****/