[Development] QDoc can't ignore Q_PROPERTY

Girish Ramakrishnan girish at forwardbias.in
Thu Mar 8 03:56:41 CET 2012


Hi,

On Wed, Mar 7, 2012 at 5:48 PM, Lincoln Ramsay <lincoln.ramsay at nokia.com> wrote:
> On 03/03/2012 02:25 AM, ext Thiago Macieira wrote:
>> On sexta-feira, 2 de março de 2012 18.01.15, Denis Shienkov wrote:
>>> The fact is that if the names of class methods and the same properties names
>>> - then QDoc ignores the description for the methods.
>>
>> That's intentional. You document the property. The getter and setter methods
>> do not need to be documented.
>
> I like this, but I don't like that you must explicitly document the
> NOTIFY signal for a property.
>
> Is there a particular reason that NOTIFY signals aren't handled the same
> as getters and setters?
>

I think this is just an oversight. qdoc wasn't fixed after NOTIFY
support was fully added.

Girish



More information about the Development mailing list