Il 22/01/24 19:03, Shawn Rutledge via Development ha scritto:

I guess your goal is to be able to see it in the header rather than having to look up the docs in the cpp file or online?  (Alternatively we could write all docs in headers, but then the headers get to be large, take storage space alongside every installation of Qt binaries, and slow down everyone’s compilations, so I guess that’s why we don’t do it that way?  Or we could somehow include doc diffs in API review patches for whatever API the script has already decided is “interesting".)

As I said, it's not just in order to see the tag in the header when the code is introduced, but also to see that a TP class is getting out of TP status because the tags are being removed (= the header is being touched, and will appear in the header review). If \preliminary is removed from the docs, it won't be obvious at API review time.

My 2 c,
--
Giuseppe D'Angelo | giuseppe.dang...@kdab.com | Senior Software Engineer
KDAB (France) S.A.S., a KDAB Group company
Tel. France +33 (0)4 90 84 08 53, http://www.kdab.com
KDAB - Trusted Software Excellence

Attachment: smime.p7s
Description: Firma crittografica S/MIME

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

Reply via email to