Bug 511580 - added note about dialog settings customization
Change-Id: If111263afb2a287adc05172072d9ad5a870ebebf
Signed-off-by: Andrey Loskutov <loskutov@gmx.de>
Also-By: Mickael Istria <mistria@redhat.com>
diff --git a/bundles/org.eclipse.platform.doc.isv/guide/product_configproduct.htm b/bundles/org.eclipse.platform.doc.isv/guide/product_configproduct.htm
index 3b874c6..81d58de 100644
--- a/bundles/org.eclipse.platform.doc.isv/guide/product_configproduct.htm
+++ b/bundles/org.eclipse.platform.doc.isv/guide/product_configproduct.htm
@@ -88,6 +88,27 @@
as part of a plug-in's public API. That is, you are taking a risk if you
refer to preferences that are used by plug-ins but not defined formally in the
API. </p>
+
+<h3><a name="dialogSettings"></a>Dialog settings defaults</h3>
+
+<p>If the custom preferences file is used as described above, setting the <tt>org.eclipse.ui/default_dialog_settings_rootUrl</tt>
+property in that file allows to specify a folder containing default dialog settings values for product plug-ins.
+The property value must be a valid URL.<br>
+The preference can be set using the following URL schemes.
+</p>
+<pre>
+org.eclipse.ui/default_dialog_settings_rootUrl=http://mycompany/dialog_settings
+org.eclipse.ui/default_dialog_settings_rootUrl=file:/etc/mycompany/dialog_settings
+org.eclipse.ui/default_dialog_settings_rootUrl=platform:/plugin/my.company.bundle/dialog_settings
+</pre>
+<p>
+The directory specified by this URL must contain folders with
+<tt>dialog_settings.xml</tt> files for every plug-in to be customized,
+each directory with the symbolic name of concrete plug-in,
+such as such as <tt>dialog_settings/org.eclipse.ui.ide/dialog_settings.xml</tt>, <tt>dialog_settings/org.eclipse.ui.navigator/dialog_sttings.xml</tt>, <tt>dialog_settings/my.company.bundle/dialog_settings.xml</tt>...
+Those <tt>dialog_settings.xml</tt> files for each bundle can be retrieved from a running instance of the Eclipse Platform, under the folder <tt>${workspace}/.metadata/.plugins</tt>. You can simply copy-paste those existing files into the directory set as value for the <tt>org.eclipse.ui/default_dialog_settings_rootUrl</tt> preference.
+</p>
+
<h3>Splash screens</h3>
<p>The product splash screen is specified in the <tt>config.ini</tt> which is
located underneath the product's <tt>configuration</tt> directory. The <b>osgi.splashPath</b> property
