#
Reference Provider

###### Identifier:

org.eclipse.ui.workbench.texteditor.quickdiffReferenceProvider

###### Since:

3.0

###### Description:

Allows contributors to add reference providers for the quick diff display.

###### Configuration Markup:

<!ELEMENT extension (referenceprovider+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

- point - The fully qualified name of the extension point.
- id - The optional id of this extension.
- name - The optional name of this extension.

<!ELEMENT referenceprovider EMPTY>

<!ATTLIST referenceprovider

class CDATA #REQUIRED

label CDATA #IMPLIED

id CDATA #REQUIRED

default (true | false) >

The definition of a reference provider for the quick diff display.

- class - The class of the reference provider, which must implement `org.eclipse.ui.editors.quickdiff.IQuickDiffReferenceProvider`.
- label - The display label for the provider, which will show up in the menu that allows the user to set the quick diff reference to this provider.
- id - A string uniquely identifying this reference provider.
- default - If this flag is set to `true`, this reference provider will be installed per default the first time quick diff is enabled for a document. If multiple providers are installed with the flag set are encountered, the first one is taken.

###### Examples:

The following is an example of a reference provider definition. It contributes a provider that uses the version of a document saved on disk as a reference.

     <extension point="quickdiff.referenceprovider">
      <referenceprovider
       id="default"
       name="%LastSavedProvider.name"
       label="%quickdiff.referenceprovider.label"
       class="org.eclipse.ui.internal.editors.quickdiff.providers.LastSaveReferenceProvider">
      </referenceprovider>
     </extension>

###### API Information:

There is no additional API for managing reference providers.

###### Supplied Implementation:

The `org.eclipse.ui.editors` plugin contributes `LastSaveReferenceProvider`. See its implementation as an example.

Copyright (c) 2001, 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html