Document in which Qt version a qmake function was introduced

...starting with Qt 5.0.0.

The text is manually inserted there, because \since does not work
within sections.

Task-number: QTBUG-74737
Change-Id: I0fe2d0a113d48be0266030c8466b062c6f743aab
Reviewed-by: Robert Szefner <robertsz27@interia.pl>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
bb10
Joerg Bornemann 2019-03-27 15:42:12 +01:00
parent 06d753e87b
commit 6fff899697
1 changed files with 64 additions and 0 deletions

View File

@ -3031,6 +3031,8 @@
\snippet code/doc_src_qmake-manual.pro 159
This function was introduced in Qt 5.0.
See also \l{clean_path(path)}{clean_path()},
\l{relative_path(filePath[, base])}{relative_path()}.
@ -3065,6 +3067,8 @@
redundant ones removed, and "."s and ".."s resolved (as far as possible).
This function is a wrapper around QDir::cleanPath.
This function was introduced in Qt 5.0.
See also \l{absolute_path(path[, base])}{absolute_path()},
\l{relative_path(filePath[, base])}{relative_path()},
\l{shell_path(path)}{shell_path()}, \l{system_path(path)}{system_path()}.
@ -3079,6 +3083,8 @@
Returns a list of all defined variable names.
This function was introduced in Qt 5.0.
\section2 escape_expand(arg1 [, arg2 ..., argn])
Accepts an arbitrary number of arguments. It expands the
@ -3142,6 +3148,8 @@
\snippet code/doc_src_qmake-manual.pro 163
This function was introduced in Qt 5.0.
\section2 fromfile(filename, variablename)
Evaluates \c filename as a qmake project file and returns the value assigned
@ -3156,6 +3164,8 @@
The \c getenv function, however, supports environment variables with
parentheses in their name.
This function was introduced in Qt 5.12.
\section2 join(variablename, glue, before, after)
Joins the value of \c variablename with \c glue. If this value is
@ -3245,6 +3255,8 @@
sum = $$num_add($$first, $$second_neg)
\endcode
This function was introduced in Qt 5.8.
\section2 prompt(question [, decorate])
Displays the specified \c question, and returns a value read from stdin.
@ -3273,6 +3285,8 @@
\note This function is available only on Windows hosts.
This function was introduced in Qt 5.12.1.
\section2 relative_path(filePath[, base])
Returns the path to \c filePath relative to \c base.
@ -3285,6 +3299,8 @@
directory; in that case, this function effectively acts as
$$clean_path().
This function was introduced in Qt 5.0.
See also \l{absolute_path(path[, base])}{absolute_path()},
\l{clean_path(path)}{clean_path()}.
@ -3304,10 +3320,14 @@
This is an internal function that you will typically not need.
This function was introduced in Qt 5.0.
\section2 reverse(variablename)
Returns the values of \c variablename in reverse order.
This function was introduced in Qt 5.0.
\section2 section(variablename, separator, begin, end)
Returns a section of the value of \c variablename. This function is a
@ -3323,6 +3343,8 @@
This function returns \c path for in-source builds. It returns an empty
string if \c path points outside of the source tree.
This function was introduced in Qt 5.0.
\section2 shell_path(path)
Converts all directory separators within \c path to separators that are
@ -3330,12 +3352,16 @@
the shell that is invoked by the make tool). For example, slashes are
converted to backslashes when the Windows shell is used.
This function was introduced in Qt 5.0.
See also \l{system_path(path)}{system_path()}.
\section2 shell_quote(arg)
Quotes \c arg for the shell that is used while building the project.
This function was introduced in Qt 5.0.
See also \l{system_quote(arg)}{system_quote()}.
\target fn_size
@ -3349,6 +3375,8 @@
This is an internal function that you will typically not need.
This function was introduced in Qt 5.0.
\section2 sorted(variablename)
Returns the list of values in \c variablename with entries sorted
@ -3357,6 +3385,8 @@
Numerical sorting can be accomplished by zero-padding the values to
a fixed length with the help of the \l{format_number()} function.
This function was introduced in Qt 5.8.
\section2 split(variablename, separator)
Splits the value of \c variablename into separate values, and returns them
@ -3403,6 +3433,8 @@
See also \l{member()}, \l{num_add()}.
This function was introduced in Qt 5.8.
\target str_size()
\section2 str_size(arg)
@ -3410,6 +3442,8 @@
See also \l{fn_size}{size()}.
This function was introduced in Qt 5.8.
\target system_replace
\section2 system(command[, mode[, stsvar]])
@ -3438,6 +3472,8 @@
invoke commands. For example, slashes are converted to backslashes for the
Windows shell.
This function was introduced in Qt 5.0.
See also \l{shell_path(path)}{shell_path()}.
\section2 system_quote(arg)
@ -3445,6 +3481,8 @@
Quotes \c arg for the shell that is used by the \c{system()}
functions.
This function was introduced in Qt 5.0.
See also \l{shell_quote(arg)}{shell_quote()}.
\target take_first()
@ -3455,6 +3493,8 @@
This provides convenience for implementing queues, for example.
This function was introduced in Qt 5.8.
See also \l{take_last()}, \l{fn_first}{first()}.
\target take_last()
@ -3465,6 +3505,8 @@
This provides convenience for implementing stacks, for example.
This function was introduced in Qt 5.8.
See also \l{take_first()}, \l{fn_last}{last()}.
\target unique
@ -3485,6 +3527,8 @@
Escapes the values of \c variablename in a way that enables parsing them as
qmake code.
This function was introduced in Qt 5.0.
*/
/*!
@ -3508,6 +3552,8 @@
This is an internal function that you will typically not need.
This function was introduced in Qt 5.0.
\section2 CONFIG(config)
This function can be used to test for variables placed into the
@ -3714,6 +3760,8 @@
Prints a message on the console. Unlike the \c message function, neither
prepends text nor appends a line break.
This function was introduced in Qt 5.0.
See also \l{message(string)}{message()}.
\section2 message(string)
@ -3739,6 +3787,8 @@
Creates the directory path \c dirPath. This function is a wrapper around the
QDir::mkpath function.
This function was introduced in Qt 5.0.
\section2 requires(condition)
Evaluates \c condition. If the condition is false, qmake skips this
@ -3765,6 +3815,8 @@
Updates the time stamp of \c filename to match the time stamp of
\c reference_filename.
This function was introduced in Qt 5.0.
\section2 unset(variablename)
Removes \c variablename from the current context.
@ -3781,12 +3833,16 @@
the string will be ignored. Comparison is performed segment-wise from left
to right; if one version is a prefix of the other, it is considered smaller.
This function was introduced in Qt 5.10.
\section2 versionAtMost(variablename, versionNumber)
Tests that the version number from \c variablename is less than or equal to
\c versionNumber. Works as
\l{versionAtLeast(variablename, versionNumber)}{versionAtLeast()}.
This function was introduced in Qt 5.10.
\section2 warning(string)
Always succeeds, and displays \c string as a warning message to the user.
@ -3798,6 +3854,8 @@
an empty file. If \c mode is \c append and the file already exists, appends
to it instead of replacing it.
This function was introduced in Qt 5.0.
\section1 Test Function Library
Complex test functions are implemented in a library of .prf files.
@ -3844,6 +3902,8 @@
\snippet code/doc_src_qmake-manual.pro 178
This function was introduced in Qt 5.0.
\section2 qtCompileTest(test)
Builds a test project. If the test passes, true is returned and
@ -3884,10 +3944,14 @@
See also \l{load(feature)}{load()}.
This function was introduced in Qt 5.0.
\section2 qtHaveModule(name)
Checks whether the Qt module specified by \c name is present.
For a list of possible values, see \l{Variables#QT}{QT}.
This function was introduced in Qt 5.0.1.
*/
/*!