[Development] Heads up: New QDoc template parameter documentation warning

[Paul Wicking]

Hi all,

the change integrated on 27 January at 14:07 UTC+1. If your local checkout of qtbase is older than that, COIN's precheck feature will show false positive warnings. Rebasing should resolve the issue.

Cheers,
Paul

On 20 Jan 2026, at 11:36, Paul Wicking <Paul.Wicking at qt.io> wrote:

Hi all,

TLDR; QDoc will now warn when template parameters aren't documented where they should be.

I'm merging a change to QDoc that validates template parameter documentation using the \a command. I've disabled the new warning on all active branches and prepared documentation fixes for affected submodules, so this shouldn't block anyone in COIN. Once the documentation fixes land, I'll re-enable the warning on dev. That said, I may have missed something, so if you hit issues related to this just let me know and I'll prioritize fixing it.

For anyone interested, this work stems from https://qt-project.atlassian.net/browse/QTBUG-117881.

Cheers,
Paul

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20260202/aa74ddd9/attachment.htm>