qt5base-lts/doc/global
Giuseppe D'Angelo e996253774 Add a marker for post-C++17 APIs in exported classes
MSVC will export any function in an exported class, including inline
ones. Conversely: client code calling inline functions in imported
classes will end up simply calling the symbol of the function, even if
the function is fully inline.

This is a problem for adding post-C++17 APIs in Qt. Such APIs are added
as inline functions protected by feature-macro tests, so that both Qt
and client apps can use any C++ version they want (any combination
works).

However, if we add a function using post-C++17 API to an exported class,
then the combination "Qt built in C++17" + "client built in post-C++17"
won't work any more. The client will expect the symbol for that function
to be exported by Qt, but Qt won't have it (built in C++17).

As a workaround, add a marker that turns these functions into "faux
templates", like Q_WEAK_OVERLOAD does.

Change-Id: I2adab81e3129c881c5a8e0772948b176fa4db1b6
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
2022-04-11 23:26:00 +02:00
..
externalsites Document what QtTest's various loggers do 2022-03-22 17:43:13 +01:00
includes Doc: Use \QtVersion macro to display correct version in code snippet 2022-03-14 16:13:06 +01:00
includes-online Unify license header usage. 2016-03-29 10:20:03 +00:00
template Doc: Add qdoc macro for tabbed content 2022-04-05 10:30:00 +02:00
compat.qdocconf Doc: Ignore QML/JavaScript parsing errors 2017-02-07 08:34:39 +00:00
config.qdocconf Update copyright year to 2022 2022-01-04 12:44:19 +01:00
externalsites.qdocconf Doc: Do not include the external sites by default 2014-09-03 09:40:59 +02:00
fileextensions.qdocconf Add shader files to examples documentation file list 2015-09-22 21:40:13 +00:00
html-config.qdocconf QDoc: Introduce a variable to set table of contents depth. 2014-06-11 15:13:29 +02:00
html-footer-online.qdocconf Update copyright year to 2022 2022-01-04 12:44:19 +01:00
html-footer.qdocconf Update copyright year to 2022 2022-01-04 12:44:19 +01:00
html-header-offline.qdocconf Doc: Fixed QDoc's navigation mechanism. 2013-06-25 14:03:24 +02:00
html-header-online.qdocconf doc: Update online navigation header to match http://doc.qt.io/ 2018-10-17 16:16:28 +00:00
htmltabs.qdocconf Doc: Add qdoc macro for tabbed content 2022-04-05 10:30:00 +02:00
macros-online.qdocconf Doc: Add qdoc macro for tabbed content 2022-04-05 10:30:00 +02:00
macros.qdocconf wasm: move user configurable settings 2022-02-23 12:04:37 +10:00
manifest-meta.qdocconf Doc: Add thumbnail for Widgets Gallery Example 2020-11-30 17:16:22 +01:00
qt-cpp-defines.qdocconf Add a marker for post-C++17 APIs in exported classes 2022-04-11 23:26:00 +02:00
qt-html-templates-offline-simple.qdocconf Doc: Adjust offline style for the litehtml rendering engine 2020-03-26 15:28:31 +01:00
qt-html-templates-offline.qdocconf Merge remote-tracking branch 'origin/5.12' into 5.13 2019-05-09 13:06:11 +00:00
qt-html-templates-online.qdocconf Merge remote-tracking branch 'origin/5.12' into 5.13 2019-05-09 13:06:11 +00:00
qt-module-defaults-offline.qdocconf doc/global: Remove references to Qt 5 in comments 2020-11-19 17:27:30 +01:00
qt-module-defaults-online-commercial.qdocconf Doc: Update global documentation config for Qt 6 2020-06-08 13:41:07 +02:00
qt-module-defaults-online.qdocconf Update copyright year to 2022 2022-01-04 12:44:19 +01:00
qt-module-defaults.qdocconf doc/global: Remove references to Qt 5 in comments 2020-11-19 17:27:30 +01:00