[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: doxygen in .h files and make tags
From: |
Steffen Dettmer |
Subject: |
Re: doxygen in .h files and make tags |
Date: |
Tue, 2 Feb 2010 13:44:50 +0100 |
On Fri, Jan 29, 2010 at 11:39 PM, <address@hidden> wrote:
> * Steffen Dettmer wrote on Fri, Jan 29, 2010 at 02:10:16PM CET:
> > here we use doxygen to comment functions in the .h files.
> > When using "make tags", tags for the definitons but not for
> > the declarations are generated. In case of "own functions"
> > this is great (you jump to the implemenations when analysing
> > code) but in other cases it is not and someone may want to
> > see the documentation.
> >
> > What best practices exist here?
>
> You can install Exuberant Ctags and let it tag declarations for
> you, too (use the --<LANG>-kinds= option).
ohh indeed, `make ctags' generates tags_c that also contains refs
to the .h files by default!
> I think cscope can parse declarations as well; git Automake
> provides a 'make cscope' rule.
address@hidden:/tmp/steffen_exp/new-autotools/systest_exp # make cscope
make: *** No rule to make target `cscope'. Stop.
address@hidden:/tmp/steffen_exp/new-autotools/systest_exp # grep -i scope Mak*
address@hidden:/tmp/steffen_exp/new-autotools/systest_exp # head -1 Makefile
# Makefile.in generated by automake 1.11.1 from Makefile.am.
address@hidden:/tmp/steffen_exp/new-autotools/systest_exp #
What do I wrong?
(personally I don't know cscope, but a team mate is using it)
> I don't think either of those distinguish between functions
> that you also define and those that you don't define, but why
> should you declare functions from third parties?
Typically, when the headers do not compile, clash, use wrong
types, are missing `const' qualifiers or generate warnings (if
files should not be changed, and only one or very very few
declarations of it are needed).
But back to `make tags', how it is intended to be used, should
users have something like `export ETAGS_ARGS=--declarations' in
their ~/.profile? But this does not work (does not influence
$(ETAGS_ARGS)).
Is there something like `./configure ETAGS_ARGS=--declarations'
(which unfortunately does not work with autoconf-2.65)?
Using `make ETAGS_ARGS=--declarations' works but is inconvenient.
How to set it best?
oki,
Steffen
- Re: doxygen in .h files and make tags,
Steffen Dettmer <=