Am 24.09.2024 um 19:24 schrieb Christian Ehrlicher via Development:



Am 24.09.2024 um 15:12 schrieb Paul Wicking via Development:
Dear Qt Developers,

I am writing to address a series of recent code review changes that propose
removing the `\since [version]` documentation strings from various modules in
Qt:
...
By making these adjustments, we can ensure that our documentation remains a
comprehensive resource for all developers—whether they're maintaining legacy
systems, planning migrations, or simply seeking to understand the evolution of
Qt.
You're aware that noone will see those \since tags in any documentation except he builds it by himself (which even I did not manage until now for unknown reasons - maybe because I try to build the documentation for qtbase only - don't know) and also needs to modify config.qdocconf before?
So basically we're leaving in code which is ifdef'd out aka dead code.
Maybe we should focus on improving the documentation instead discussing if (or if not) we remove dead code added 20 years ago.

Hello Christian,

maybe I fail to understand what exactly you are refering to. If we both are talking about comments like "\since 4.8" for `QRegExp::swap()` then you are wrong. This comment definitely becomes "This function was introduced in Qt 4.8." in the documenation provided by the official installers. If this should not work consistency this seems like a bug in Qt's documentation tools.

Ciao
Mathias
-- 
Development mailing list
Development@qt-project.org
https://lists.qt-project.org/listinfo/development

Reply via email to