Add documentation for the QT_NO_UTF8_SOURCE property

Add the missing documentation for the QT_NO_UTF8_SOURCE. The property
can be set directly or using the qt6_allow_non_utf8_sources function.

Fixes: QTBUG-126435
Pick-to: 6.5 6.7 6.8
Change-Id: I2a255e6d4f761f14a2fa30ae51b4f671ed75586f
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
This commit is contained in:
Alexey Edelev 2024-07-16 11:20:53 +02:00
parent 6cafe0f2b4
commit 37e6159ab0
2 changed files with 24 additions and 0 deletions

View File

@ -488,6 +488,29 @@ That library provides implementations of main (or WinMain).
On targets that must provide their own entry point, set the property \c qt_no_entrypoint to inhibit linking against Qt's entrypoint library.
*/
/*!
\page cmake-target-property-qt-no-utf8-source.html
\ingroup cmake-properties-qtcore
\ingroup cmake-target-properties-qtcore
\title QT_NO_UTF8_SOURCE
\target cmake-target-property-QT_NO_UTF8_SOURCE
\summary {Prevents forcing source files to be treated as UTF-8 for Windows.}
\cmakepropertysince 6.0
When building with some compilers for Windows, targets that link to a Qt library
will use flags that force the compiler to treat its source files as UTF-8. This
is currently implemented for Visual Studio and Intel compilers. You can disable
this behavior on a per-target basis by setting the property to \c TRUE:
\badcode
set_property(TARGET target_name PROPERTY QT_NO_UTF8_SOURCE TRUE)
\endcode
\sa {qt6_disable_unicode_defines}{qt_disable_unicode_defines()}{qt6_allow_non_utf8_sources()}
*/
/*!
\page cmake-target-property-qt-resource-prefix.html
\ingroup cmake-properties-qtcore

View File

@ -31,4 +31,5 @@ this behavior on a per-target basis by calling \c{qt_allow_non_utf8_sources()}
and passing the target as the argument.
\sa {qt6_disable_unicode_defines}{qt_disable_unicode_defines()}
{cmake-target-property-QT_NO_UTF8_SOURCE}
*/