[Development] QDoc can't ignore Q_PROPERTY

casper.vandonderen at nokia.com casper.vandonderen at nokia.com
Thu Mar 8 10:38:33 CET 2012


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
;-) )


Casper

On 3/8/12 3:56 AM, "ext Girish Ramakrishnan" <girish at forwardbias.in> wrote:

>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
>_______________________________________________
>Development mailing list
>Development at qt-project.org
>http://lists.qt-project.org/mailman/listinfo/development




More information about the Development mailing list