dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Rockbox mail archive

Subject: Re: Plugin API documentation

Re: Plugin API documentation

From: Dominik Riebeling <>
Date: Tue, 13 Jan 2009 18:39:22 +0100

On Tue, Jan 13, 2009 at 3:26 PM, Maurus Cuelenaere
<> wrote:
> The way I see it how this should be done is something like:
>> /*
>> Description of function. [REQUIRED]
>> arg1: description of arg1 [OPTIONAL]
>> arg2: description of arg2 [OPTIONAL]
>> returns: description of return value [OPTIONAL]
>> */
>> int (*function)(int arg1, int arg2);

That's pretty much like doxygen comments work, which would look like
this (given that the AUTOBRIEF option is turned on, otherwise you'd
need an additional _at_brief in the first line):

/** short description of the function.
 * optional longer description of the function
 * _at_param arg1 description of arg1
 * _at_param arg2 description of arg2
 * _at_return description of return valus

So I'd suggest when refactoring also moving to that syntax -- you
could still use your generator, or optionally run doxygen on it. There
are also groups (though I don't remember off the top of my head how
that tag was). As a side note, doxygen also understands tags with
leading \ instead of _at_ so that could also get used. I, however, prefer
the latter.

 - Dominik
Received on 2009-01-13

Page template was last modified "Tue Sep 7 00:00:02 2021" The Rockbox Crew -- Privacy Policy