Bug 493540 - [Welcome] Fix up documentation for new theme-specific path resolution
Document that Universal Intro now allows theme-specific files by
attempting to first resolve file-path properties in a directory
named by the theme identifier.
Signed-off-by: Brian de Alwis <bsd@mt.ca>
Change-Id: I9b7650387176dfd270411a0e249d0234e3009883
diff --git a/bundles/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm b/bundles/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm
index 6ee6810..6539486 100644
--- a/bundles/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm
+++ b/bundles/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html lang="en">
<HEAD>
-<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2016. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
@@ -73,6 +73,11 @@
<b><a href="../reference/api/org/eclipse/ui/branding/IProductConstants.html">IProductConstants</a></b>.
See the javadoc for a complete description of these properties and their values. We'll look at these
further in <a href="product_configproduct.htm">Customizing a product</a>.
+</p>
+<p>
+Product customization properties are also used by other platform services such as to
+<a href="ua_intro_universal_contributing.htm">configure the Universal Welcome/Intro</a>.
+</p>
</BODY>
</HTML>
diff --git a/bundles/org.eclipse.platform.doc.isv/guide/ua_intro_universal_contributing.htm b/bundles/org.eclipse.platform.doc.isv/guide/ua_intro_universal_contributing.htm
index 5fe7b6e..bb17cab 100644
--- a/bundles/org.eclipse.platform.doc.isv/guide/ua_intro_universal_contributing.htm
+++ b/bundles/org.eclipse.platform.doc.isv/guide/ua_intro_universal_contributing.htm
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
-<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2016. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
@@ -89,7 +89,7 @@
file name of the image to be used as the root page brand mark. The image
should ideally be PNG with alpha blending but other formats are also valid.
Image file names relative to the product bundle must have a 'product:'
- prefix.
+ prefix.
</li>
<li>
<b>introBrandingImageText</b> - an alternative text to be used for the
@@ -103,6 +103,16 @@
plugin.properties file.
</li>
</ul>
+<p>As of version 4.6, the universal intro supports replacing file-based
+properties such as <b>introBrandingImage</b> with a theme-specific
+alternative. For example, a product may contribute a <b>introBrandingImage</b>
+as <code>"product:gizmo.png"</code>, but this image does not match the
+the <code>com.acme.theme</code> theme. A more suitable image can be placed
+in the product bundle in <code>com.acme.theme/gizmo.png</code>.
+When a replacement image is not found, the resolver will fall back
+to the general image <code>gizmo.png</code> image found at the root
+of the product bundle.
+</p>
<p>
Second half of universal intro variables are accessible as preferences. The
@@ -159,4 +169,4 @@
<p> </p>
</body>
-</html>
\ No newline at end of file
+</html>
