[Development] Are SiCs through #include cleanups considered acceptable?

Knoll Lars Lars.Knoll at theqtcompany.com
Tue Apr 14 08:44:11 CEST 2015


On 14/04/15 08:36, "Mathias Hasselmann" <mathias at taschenorakel.de> wrote:
>Am 10.04.2015 um 17:51 schrieb Thiago Macieira:
>> On Friday 10 April 2015 15:03:04 André Somers wrote:
>>> I do think it needs a bit of work on the documentation side of things
>>>to
>>> make it clear that really any QList<QByteArray> now behaves as/is a
>>> QByteArrayList. The documentation still says it is a class.
>>
>> For documentation purposes only.
>>
>Is lying to the user really the proper approach for documentation? I'd
>totally prefer if the documentation tells the user that special methods
>are available for QList specializations.

Agree. Currently I believe qdoc can’t handle template specializations
properly though. So we’ll need to fix that part first. In the meantime, we
could add a sentence inside the QByteArrayList docs saying that it’s in
reality a typedef.

Cheers,
Lars



More information about the Development mailing list