1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-05 16:15:25 +02:00
cdt/rse/doc/org.eclipse.rse.doc.isv/reference/misc/runtime-options.html
2009-01-20 17:44:21 +00:00

119 lines
4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2005, 2008. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
<!-- David Dykstal (IBM) - [208953] document how to disable system types -->
<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">
<link REL="STYLESHEET" HREF="../../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Remote System Explorer runtime options</title>
</head>
<body>
<h1>Remote System Explorer runtime options</h1>
<p>
Some RSE runtime preferences are set using system properties.
With RSE release 2.0, all new runtime preferences are set using the plugin_customization.ini method.
</p>
<h2>System properties</h2>
<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.
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>
<p>
See <a href="../../../org.eclipse.platform.doc.isv/guide/product_configproduct.htm">Customizing a product</a>
for a description of plugin preference customization.
</p>
<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>
<dt>org.eclipse.rse.core/{systemTypeID}.systemType.enabled</dt>
<dd>
<p>
This preference allows you to disable installed system types on a product basis.
Values may be true or false.
</p>
<dl>
<dt>true</dt>
<dd>The system type is enabled. Connections of this system type may be created.</dd>
<dt>false</dt>
<dd>The system type is disabled. Connections of this system type may not be created. The system type will be unavailable in the user interface.</dd>
</dl>
<p>The default value is true for each installed system type.</p>
<p>The following example shows how to disable the "telnet" system type.</p>
<xmp>
org.eclipse.rse.core/org.eclipse.rse.systemtype.telnet.systemType.enabled = false
</xmp>
</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.
</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>