1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-04 07:35:24 +02:00

[192208] updating runtime preference for API preferences

This commit is contained in:
David Dykstal 2007-06-19 00:40:41 +00:00
parent 215b451b78
commit 3742e0d0b2

View file

@ -2,7 +2,7 @@
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2005, 2006. 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 2005, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
<meta name="Author" content="IBM">
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
@ -11,32 +11,88 @@
</head>
<body>
<h1>Remote System Explorer runtime options</h1>
<p>Version 1.0 - Last revised September 20, 2006</p>
<p>The Remote System Explorer (RSE) is configurable through System properties. Many of these
properties can be used to specify initial RSE settings.</p>
<p>
Some RSE runtime preferences are set using system properties.
With release 3.3, all new runtime preferences are set using the plugin_customization.ini method.
See <a href="/help/topic/org.eclipse.platform.doc.isv/guide/product_configproduct.htm">Customizing a product</a>
for a description of plugin preference customization.
</p>
<h2>System properties</h2>
<p>The following System properties are used by RSE.</p>
<p>Properties can be set in the following ways:</p>
<ul>
<li>use -DpropName=propValue as a VM argument to the Java VM</li>
<li>set the desired property in the config.ini file in the appropriate configuration
area</li>
</ul>
<p>
The following system properties are used by RSE.
Properties are set using
<code>-DpropertyName=propertyValue</code>
as a VM argument to the Java VM.
</p>
<dl>
<dt><a name="showNewConnectionPrompt" id="showNewConnectionPrompt"></a>rse.showNewConnectionPrompt</dt>
<dd>whether to show the New Connection prompt in RSE views by default. "True" or "false".</dd>
<dt><a name="showLocalConnection" id="showLocalConnection"></a>rse.showLocalConnection</dt>
<dd>whether to create and show a Local connection by default when RSE starts with a new worspace. "True" or "false".</dd>
<dt><a name="enableSystemTypes" id="enableSystemTypes"></a>rse.enableSystemTypes</dt>
<dd>a comma-separated list of system types to enable by default. This property can be used to limit the system types in RSE.</dd>
<dt><a name="showProfilePage" id="showProfilePage"></a>rse.showProfilePage</dt>
<dd>whether to show a New Profile wizard by default when creating a new connection for the first time. "True" or "false". If this is "false", a new profile with the hostname is created without asking the user.</dd>
<dt><a name="showNewConnectionPrompt" id="showNewConnectionPrompt"></a>rse.showNewConnectionPrompt</dt>
<dd>
whether to show the New Connection prompt in RSE views by default.
The value may be <code>true</code> or <code>false</code>.
The default is <code>true</code>.
</dd>
<dt><a name="showLocalConnection" id="showLocalConnection"></a>rse.showLocalConnection</dt>
<dd>
whether to create and show a Local connection by default when RSE starts with a new workspace.
The value may be <code>true</code> or <code>false</code>.
The default is <code>true</code>.
</dd>
</dl>
<h2>Plugin customizations</h2>
<h3>Core Preferences</h3>
<dl>
<dt>org.eclipse.rse.core/DEFAULT_PERSISTENCE_PROVIDER</dt>
<dd>
The id of the default persistence provider.
This provider is used when new profiles are created and an explicit persistence provider is not set for them.
The default value is <code>org.eclipse.rse.persistence.MetadataPropertyFileProvider</code>
</dd>
</dl>
<h3>User Interface Preferences</h3>
<dl>
<dt>org.eclipse.rse.ui/MNEMONICS_POLICY</dt>
<dd>
<p>
The value is a bit field composed of or'ing the following bit flag values together to achieve
the desired setting.
</p>
<dl>
<dt>bit mask - value 1</dt>
<dd>
If on, specifies whether or not to insert mnemonic indications into
the current text of a label.
If off, all other options are ignored.
</dd>
<dt>bit mask - value 2</dt>
<dd>
If on, specifies to generate mnemonics of the form (X) at the end of labels for
those languages matching the locale pattern.
If off, then only characters from the label will be used as mnemonics.
</dd>
</dl>
<p>
The default value is 3.
</p>
</dd>
<dt>org.eclipse.rse.ui/APPEND_MNEMONICS_PATTERN</dt>
<dd>
The value is a regular expression that is matched against the current locale.
Some products will desire to append mnemonics only for certain locales.
The default pattern matches Chinese, Japanese, and Korean.
</dd>
<dt>org.eclipse.rse.ui/SHOW_EMPTY_LISTS</dt>
<dd>
Allows a product to customize whether or not to show empty list messages in the remote system view
when expanding a filter that results in an empty list of resources.
The default value is <code>true</code>.
</dd>
</dl>
</body>
</html>