summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIvan Komissarov <abbapoh@gmail.com>2021-10-18 10:49:21 +0300
committerIvan Komissarov <ABBAPOH@gmail.com>2021-10-19 23:01:55 +0000
commitc88ed67afbc4a4d119f08a1d27030a78c85ed245 (patch)
treefe0293654b523d1e465206299c1674c139e96d7c
parentc0277527d996156304324e9cadd25affc98b7428 (diff)
downloadqbs-c88ed67afbc4a4d119f08a1d27030a78c85ed245.tar.gz
doc: clarify that app is not runnable
... unless rpaths are set. Also, link Running Applications page with the "qbs run" docs. Change-Id: If981555cb617324d45408d98f7f5bc61ba737eaf Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
-rw-r--r--doc/qbs.qdoc14
1 files changed, 11 insertions, 3 deletions
diff --git a/doc/qbs.qdoc b/doc/qbs.qdoc
index ef5e71081..b44ba5880 100644
--- a/doc/qbs.qdoc
+++ b/doc/qbs.qdoc
@@ -1618,8 +1618,7 @@
\title Running Applications
- By default, running an application also builds it and installs it to a
- location from where it can be run on the desktop or on a device.
+ Qbs has the convenience \l{run}{qbs run} command that simplifies running applications.
For example, entering the following command runs the Qt Creator application:
@@ -1627,7 +1626,16 @@
qbs run --products qtcreator
\endcode
- This command also builds and installs the product, if necessary.
+ By default, running an application also builds it and installs it to a
+ location from where it can be run on the desktop or on a device. Also, this command
+ \l{Module::setupRunEnvironment}{sets up} the environment so that the application can find
+ dependent libraries.
+
+ This is not the case when running the binary manually - you'll have to make sure that the
+ app will find its dependencies and/or is relocatable. You can achieve that by
+ \l{How do I make use of rpaths?}{configuring rpaths} properly or setting the appropriate
+ environment variable for the respective host system.
+
*/
/*!