Doc: document restriction for Product.name values

Change-Id: I3134c4ba1c781260d2d14501eb8579e6ec628e02
Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>

1 files changed, 13 insertions, 1 deletions

diff --git a/doc/reference/items/product.qdoc b/doc/reference/items/product.qdoc
index b27f76c3d..acf0b0a60 100644
--- a/doc/reference/items/product.qdoc
+++ b/doc/reference/items/product.qdoc
@@ -83,7 +83,19 @@
             \li name
             \li string
             \li empty string
-            \li The name of the product. Used to identify the product in a \c Depends item, for example.
+            \li The name of the product. Used to identify the product in a \c Depends item, for
+                example. The value of this property must be a simple JavaScript expression that
+                does not depend on module properties or values that are non-local to this product.
+                \code
+                CppApplication {
+                    name: "hello" + "world"                     // valid
+                }
+                CppApplication {
+                    name: "app_for_" + qbs.targetOS.join("_")   // invalid
+                }
+                \endcode
+                To change the name of your product's target artifact, modify \c{Product.targetName}
+                instead.
         \row
             \li profiles
             \li stringList