[Development] QDoc can't ignore Q_PROPERTY

[casper.vandonderen at nokia.com]

Just to make sure everybody understands:
With this change applied all NOTIFY properties that are currently documented will not be documented anymore.

If there are no objections before coming Tuesday (13 March) 09:00 Oslo time I will put this patch in.


Casper
________________________________________
From: Ramsay Lincoln (Nokia-MP/Brisbane)
Sent: Friday, March 09, 2012 12:37 AM
To: Vandonderen Casper (Nokia-MP/Oslo)
Cc: ext Girish Ramakrishnan; development at qt-project.org
Subject: Re: [Development] QDoc can't ignore Q_PROPERTY

On 03/08/2012 07:38 PM, Vandonderen Casper (Nokia-MP/Oslo) wrote:
> It might be that this was indeed an oversight.
>
> Can you create a bug report and assign it to me (I am not promising I have
> time to fix it now, or you can fix qdoc yourself and add me as reviewer
> ;-) )

Ok... The "fix" is (as far as I can tell) a single line of code. With
that in place, NOTIFY signals are handled the same as getters and
setters for properties. Perhaps most significantly, documentation for
the signal is silently ignored by qdoc.

While trying to find that line, I found two other bits of code dealing
with getters and setters but not notifiers. I've updated them too but I
don't actually know what they do.

http://codereview.qt-project.org/#change,19374

--
Lincoln Ramsay - Senior Software Engineer
Qt Development Frameworks, Nokia - http://qt.nokia.com/