// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\group cmake-directory-properties-qtlinguisttools
\title CMake Directory Properties in Qt6 LinguistTools

\l{CMake Command Reference#Qt6::LinguistTools}{CMake Commands} know about the
following CMake directory properties:

\sa{CMake Property Reference}
*/


/*!
\page cmake-directory-property-qt-exclude-from-translation.html
\ingroup cmake-properties-qtlinguisttools
\ingroup cmake-directory-properties-qtlinguisttools
\keyword directory property QT_EXCLUDE_FROM_TRANSLATION

\title QT_EXCLUDE_FROM_TRANSLATION

\brief Marks the directory as excluded from translation

\cmakepropertysince 6.7

Set this directory property to \c ON to exclude all targets in the directory and
its subdirectories from translation. The command
\l qt_collect_translation_source_targets()
will skip such targets.

To exclude a single target, use the target property \l{target property
QT_EXCLUDE_FROM_TRANSLATION}{QT_EXCLUDE_FROM_TRANSLATION}.

\section1 Examples

In the following example, translatable strings will not be extracted from
targets that are defined in the \c tests directory.

\badcode
add_subdirectory(app)
add_subdirectory(tests)
set_property(DIRECTORY tests PROPERTY QT_EXCLUDE_FROM_TRANSLATION ON)
qt_add_translations(myapp)
\endcode

Alternatively, you can set the directory property in the \c{CMakeLists.txt} of
the \c tests subdirectory.

\badcode
# tests/CMakeLists.txt
qt_add_executable(...)
add_test(...)
set_directory_properties(PROPERTIES QT_EXCLUDE_FROM_TRANSLATION ON)
\endcode

\sa QT_EXCLUDE_SOURCES_FROM_TRANSLATION
*/


/*!
\group cmake-target-properties-qtlinguisttools
\title CMake Target Properties in Qt6 LinguistTools

\l{CMake Command Reference#Qt6::LinguistTools}{CMake Commands} know about the
following CMake target properties:

\sa{CMake Property Reference}
*/


/*!
\page cmake-target-property-qt-exclude-from-translation.html
\ingroup cmake-properties-qtlinguisttools
\ingroup cmake-target-properties-qtlinguisttools
\keyword target property QT_EXCLUDE_FROM_TRANSLATION

\title QT_EXCLUDE_FROM_TRANSLATION

\brief Marks the target as excluded from translation

\cmakepropertysince 6.7

Set this target property to \c ON to exclude it from translation. The command
\l qt_collect_translation_source_targets()
will skip such targets.

To exclude all targets under a subdirectory, use the directory property
\l{directory property QT_EXCLUDE_FROM_TRANSLATION}{QT_EXCLUDE_FROM_TRANSLATION}.

\section1 Examples

In the following example, translatable strings will not be extracted from the \c
mytest target.

\badcode
qt_add_executable(myapp main.cpp)
qt_add_executable(mytest test.cpp)
set_property(TARGET mytest PROPERTY QT_EXCLUDE_FROM_TRANSLATION ON)
qt_add_translations(myapp)
\endcode

\sa QT_EXCLUDE_SOURCES_FROM_TRANSLATION
*/


/*!
\page cmake-target-property-qt-exclude-sources-from-translation.html
\ingroup cmake-properties-qtlinguisttools
\ingroup cmake-target-properties-qtlinguisttools

\title QT_EXCLUDE_SOURCES_FROM_TRANSLATION

\brief List of source file paths that shall be excluded from translation

\cmakepropertysince 6.7

This target property specifies a list of source file paths that are excluded
from translation. Source files that match the patterns in this exclusion list
are ignored by \c{lupdate}.

The paths may be absolute or relative to \c{CMAKE_CURRENT_SOURCE_DIR}. The paths
may contain wildcards in a format that is accepted by
\l{QRegularExpression::wildcardToRegularExpression}.

\section1 Examples

Exclude \c untranslatable.cpp and recursively every file under the \c 3rdparty
directory.

\snippet cmake-macros/examples.cmake exclude sources from i18n

\sa qt_add_lupdate()
\sa {target property QT_EXCLUDE_FROM_TRANSLATION}
\sa {directory property QT_EXCLUDE_FROM_TRANSLATION}
*/
