Convenience items can now install separated debug info

This patchset adds the 'installDebugInformation' and
'debugInformationInstallDir' properties to the NativeBinary item and
adds Group items that install debug info to the Library and Application
items.

Also, update How-To about installing debug symbols

More documentation (for the Library and the NativeBinary items) will be
added in a separate patchset

Change-Id: I32687b99871fe40a8e26db09aa118a89ae73f922
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>

1 files changed, 25 insertions, 7 deletions

diff --git a/doc/howtos.qdoc b/doc/howtos.qdoc
index 61da7af53..696c444cb 100644
--- a/doc/howtos.qdoc
+++ b/doc/howtos.qdoc
@@ -151,15 +151,31 @@
     }
     \endcode
 
-    If the \l{cpp::separateDebugInformation}{cpp.separateDebugInformation} property is set to
-    \c true, \QBS will create debugging symbols with the corresponding file tags
+    Now, you can install your \l{Application}{application}, \l{DynamicLibrary}{dynamic library}
+    or \l{LoadableModule}{loadable module} among with its debugging symbols as follows:
+    \code
+    CppApplication {
+        // ...
+        install: true
+        installDir: "bin"
+        installDebugInformation: true
+        debugInformationInstallDir: "bin"
+    }
+    \endcode
+
+    If you are not using \l{List of Convenience Items}{convenience items},
+    you can install debug symbols manually using the \l{Group} item. If the
+    \l{cpp::separateDebugInformation}{cpp.separateDebugInformation} property is set to \c true,
+    \QBS will create debugging symbols with the corresponding file tags
     \c "debuginfo_app" (for an application), \c "debuginfo_dll" (for a dynamic library),
     or \c "debuginfo_loadablemodule" (for a macOS plugin).
 
-    Now, you can install your application and its debugging symbols as follows:
     \code
-    CppApplication {
-        // ...
+    Product {
+        type: "application"
+        Depends { name: "cpp" }
+        cpp.debugInformation: qbs.buildVariant !== "release"
+        cpp.separateDebugInformation: true
         Group {
             fileTagsFilter: cpp.separateDebugInformation ? ["debuginfo_app"] : []
             qbs.install: true
@@ -171,7 +187,8 @@
 
     If you're building a shared library, you need to use the \c "debuginfo_dll" tag instead:
     \code
-    DynamicLibrary {
+    Product {
+        type: "dynamic_library"
         // ...
         Group {
             fileTagsFilter: cpp.separateDebugInformation ? ["debuginfo_dll"] : []
@@ -185,7 +202,8 @@
     If you're building a macOS plugin, you need to use the \c "debuginfo_loadablemodule"
     tag instead:
     \code
-    LoadableModule {
+    Product {
+        type: "loadablemodule"
         // ...
         Group {
             fileTagsFilter: cpp.separateDebugInformation ? ["debuginfo_loadablemodule"] : []