[Development] PSA: QDoc's \deprecated command is better since Qt 6.2

[Paul Wicking]

Hi all,

The following is a quick update from us documentation folks:

If something is deprecated, use \deprecated in documentation, not \obsolete.

QDoc now lets you record the version something is deprecated and suggest replacements with the \deprecated command. These descriptions become the first paragraph of the resulting documentation.

Usage:
    \deprecated
    \deprecated [6.2]
    \deprecated [6.2] Use QFoo() instead.
    \deprecated Use QFoo() instead.

Any such description must have proper punctuation as QDoc doesn’t inject that if it’s missing.

Happy documenting!

//! Paul