[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Discuss-gnuradio] a call for a better wiki

From: Eric Blossom
Subject: Re: [Discuss-gnuradio] a call for a better wiki
Date: Sun, 23 Mar 2008 19:43:46 -0700
User-agent: Mutt/1.5.17 (2007-11-01)

On Sun, Mar 23, 2008 at 11:40:06AM -0400, George Nychis wrote:
> Josh Blum wrote:
>> The blocks in gnuradio need some kind of categorical hierarchy. Not blks2, 
>> wxgui, gruimpl, gengen... More like sources, sinks, modulators, encoders, 
>> filters...
>> We could manually compile a list of usable blocks that maps each block to 
>> a category. Or hide the category information in the documentation of each 
>> block, and extract it from the doxygen xml files.
>> Then you can generate a webpage or a cool interactive javascript thing. 
>> And link each block to the doxygen page. That would be a *very* helpful 
>> thing to have.
>> -Josh
> I definitely agree with this.  They need to be broken down in to 
> functionality to make it even remotely easy to find the type of blocks 
> you're looking for by searching through the code.  Then we can break the 
> documentation up into these categories.
> What categories do people think are a comprehensive list?
> Even if we don't break the code down into this structure now, because I 
> don't know how difficult that will be to completely move everything around, 
> we can at least break it down nicely in the documentation.
> - George


There is currently a category list, and most blocks are currently
assigned to one of the categories in the list.  I'm not attached to
the current list, and some of the blocks are definitely
miscategorized.  Please feel free to propose a revised list and then
reclassify the blocks.

The list of categories is in


The blocks are assigned to the groups by the

  \ingroup <foo>

markup in their .h doxygen class comment.

The documentation categories are completely orthogonal to the
directory hierarchy, so there's no reason to move stuff around to change

See http://www.doxygen.org for docs.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]