Re: [Doxygen-develop] Qt Properties

[Matthias K. <kr...@kd...>]

Hi again,

I give up without a helping hand. Too many of the methods are not documente=
d=20
and I have to read to code only to figure out that they're not doing what I=
'm=20
looking for. :-(

I made doxygen write "Access function: " + getReadAccessor() +=20
getWriteAccessor() in the property docs, but after about one day of reading=
=20
doxygen source I had hoped to get further.

If somebody can guide me on IRC I'm Vir on freenode or just reply to this=20
list. I'm subscribed.

Good night,
	Matthias

On Wednesday 22 March 2006 22:49, Matthias Kretz wrote:
> Hi,
>
> while documenting properties for the upcoming KDE4 API I noticed that
> documenting Q_PROPERTY macros partially works. But there's a few things I=
'd
> like to fix if you can tell me where to look:
>
> 1. The HTML documentation doesn't specify what the ReadAccessor and
> WriteAccessor are. I like the way it is done for Qt (look at
> http://doc.trolltech.com/4.1/qaction.html#checked-prop ).
>
> So I'd like to add the necessary code to write out "Access function:\n - "
> + getReadAccessor() + "\n - " + getWriteAccessor()
> Where do I have to look (apparently the accessor functions are written in=
to
> the XML output, but not the HTML output)?
>
> 2. If the accessor functions are undocumented doxygen currently gives a
> warning. Ideally doxygen should see that the documentation is not needed
> anymore and link the functions from the index to the property documentati=
on
> and not give any warnings - to the contrary it should give a warning if t=
he
> property and the accessors are documented.
> Is this possible? Where?

=2D-=20
C'ya
        Matthias
________________________________________________________
Matthias Kretz (Germany)                            <><
http://Vir.homelinux.org/
Mat...@gm..., kr...@kd...,
Mat...@ur...