Remote File Types

Identifier:
org.eclipse.rse.subsystems.files.core.remoteFileTypes

Since:
3.0

Description:
This extension point is used to register information about whether particular file types should be considered to contain text or binary data. This information is important as it will determine how files will be transferred. The exact meaning of how the transfer of text files differs from binary files depends on the actual file service implementation. In general, though, services will strive to change the encoding of remote text files during transfer such that it matches the local platform default encoding.

Specific encoding conversions also depend on provided extensions to the org.eclipse.rse.services.codePageConverters extension point. For example, transferring files from a remote dstore Linux host to a local Windows client, the file service may convert text files from UTF-8 encoding to Windows cp1252 encoding, and convert remote LF only line endings to local CRLF line endings. The benefit of this conversion is that local (external) tools may operate on transferred files in the RSE files cache without having to worry about encodings.

Providers may provide an extension for this extension point. No code beyond the XML extension declaration is required. See also the org.eclipse.team.core.fileTypes extension point which provides similar information for Repository providers.

Configuration Markup:

<!ELEMENT extension (remoteFileTypes*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

>


<!ELEMENT remoteFileTypes EMPTY>

<!ATTLIST remoteFileTypes

extension CDATA #REQUIRED

type      (text|binary)

priority  CDATA #IMPLIED

>


Examples:


Copyright (c) 2006, 2007 IBM Corporation. All Rights Reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html Contributors: IBM Corporation - initial API and implementation