Doc: adding details to qmake docs

Added documentation about the create_prl and link_prl to the CONFIG variable in the qmake manual

Task-number: 165165

Rev-by: Geir Vattekar

Rev-by: Volker Hilsheimer

1 files changed, 19 insertions, 0 deletions

diff --git a/doc/src/qmake-manual.qdoc b/doc/src/qmake-manual.qdoc
index d840c71..afd881f 100644
--- a/doc/src/qmake-manual.qdoc
+++ b/doc/src/qmake-manual.qdoc
@@ -1019,6 +1019,25 @@
 
     \snippet doc/src/snippets/code/doc_src_qmake-manual.qdoc 24
 
+    When linking a library, \c qmake relies on the underlying platform to know
+    what other libraries this library links against. However, if linking
+    statically, \c qmake will not get this information unless we use the following
+    \c CONFIG options:
+
+     \table 95%
+     \header \o Option   \o Description
+     \row    \o create_prl  \o This option enables \c qmake to track these
+        dependencies. When this option is enabled, \c qmake will create a file
+        ending in \c .prl which will save meta-information about the library
+        (see \l{LibDepend}{Library Dependencies} for more info).
+     \row    \o link_prl    \o When this is enabled, \c qmake will process all
+        libraries linked to by the application and find their meta-information
+        (see \l{LibDepend}{Library Dependencies} for more info).
+     \endtable
+
+    Please note that \c create_prl is required when \i {building} a static library,
+    while \c link_prl is required when \i {using} a static library.
+
     On Windows (or if Qt is configured with \c{-debug_and_release}, adding the
     \c build_all option to the \c CONFIG variable makes this rule the default
     when building the project, and installation targets will be created for