summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoerg Bornemann <joerg.bornemann@qt.io>2019-03-27 15:42:12 +0100
committerJoerg Bornemann <joerg.bornemann@qt.io>2019-04-03 20:23:29 +0000
commit6fff8996972b936709569f14ccc4d684846dbb1a (patch)
treeb75baebd10943472471a99b54c9b72c7d309aca0
parent06d753e87b71e6b02bbe937b488c8598c9945521 (diff)
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>
-rw-r--r--qmake/doc/src/qmake-manual.qdoc64
1 files changed, 64 insertions, 0 deletions
diff --git a/qmake/doc/src/qmake-manual.qdoc b/qmake/doc/src/qmake-manual.qdoc
index 84e3fb6df4..1e1b365141 100644
--- a/qmake/doc/src/qmake-manual.qdoc
+++ b/qmake/doc/src/qmake-manual.qdoc
@@ -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.
*/
/*!