[Development] New \nullptr qdoc macro in 5.12, please start using it

[Friedemann Kleint]

Hi,

in Qt 5.12; there is a new \nullptr qdoc macro to be used for nullptr 
(see "Documentation: Add \nullptr macro and use where applicable" 
3eac688ec005833509bffc7097c378af9c5b515f 
https://codereview.qt-project.org/#/c/249583/ ).

The underlying motivation (besides using modern C++) is  that Qt for 
Python users trip over the documentation stating "0 can be passed to 
this pointer * parameter...), thinking they can pass (int) 0 (see 
https://bugreports.qt.io/browse/PYSIDE-903 ).

I would like to encourage the maintainers to go through their 
documentation and look for things like "void *foo() \** returns 0 
when..." or "0 can be passed to this pointer * parameter")  and change 
this to \nullptr (see fex https://codereview.qt-project.org/#/c/249610/ ).

This will then expand to None in the Qt for Python documentation.

Thanks,

Friedemann

-- 
Friedemann Kleint
The Qt Company GmbH