[Top][All Lists]

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

Re: [Discuss-gnuradio] Fwd: Documentation for out-of-tree module

From: Nemanja Savic
Subject: Re: [Discuss-gnuradio] Fwd: Documentation for out-of-tree module
Date: Tue, 4 Feb 2014 18:58:35 +0100

Under tag <doc>.

On Tue, Feb 4, 2014 at 5:15 PM, Zhe Feng <address@hidden> wrote:

Hi all, 

I'm working on an out-of-tree module and I want to make the documentations which can be shown in the windows when people double click the blocks. 

I guess the documentations are written in the header file in /gr-xx/include/xx. So I tried to modify the header files of blocks which already exist in gnuradio, for example, the channel_model block in gr-channel. The documentation was updated after reinstallation. It confirms my guess. But when I modify the header file of my own block in /gr-xx/include/xx, the documentation wasn't updated after reinstallation. The documentations are still something like:

make(xx, xx) -> sptr
Return a shared_ptr to a new instance of xx::xx.
To avoid accidental use of raw pointers, xx::xx constructor is in a private implementation class. xx::xx::make is the public interface for creating new instances.
Params: (xx, xx)

I searched some previous questions related to documentation on discussion-gnuradio, someone said documentations should be done by doxygen for C++ blocks and by sphinx for python blocks. But I found these are more related to these html documentations(maybe I'm wrong). 

Did I miss something or do something wrong? Could anyone give me any suggestions to resolve problem? 

Thanks a lot!
Zhe Feng 
University of Michigan Ann Arbor 

Discuss-gnuradio mailing list

Nemanja Savić

reply via email to

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