schema.markers.exsd Maven / Gradle / Ivy
The newest version!
The workspace supports the notion of markers on arbitrary
resources. A marker is a kind of metadata
(similar to properties) which can be used to
tag resources with user information. Markers are
optionally persisted by the workspace whenever a
workspace save or snapshot is done.
<p>
Users can define and query for markers of a given type.
Marker types are defined in a hierarchy that supports
multiple-inheritance. Marker type definitions also
specify a number attributes which must or may be
present on a marker of that type as well as whether
or not markers of that type should be persisted.
<p>
The markers extension-point allows marker writers to
register their marker types under a symbolic name that
is then used from within the workspace to create and
query markers. The symbolic name is the id of the
marker extension. When defining a marker extension,
users are encouraged to include a human-readable value
for the "name" attribute which indentifies their marker
and potentially may be presented to users.
a fully qualified identifier of the target extension point
a required identifier of the extension instance
an optional name of the extension instance
the fully-qualified id of a marker super type (i.e., a marker type defined by another marker extension)
"<tt>true</tt>" or "<tt>false</tt>" indicating whether or not markers of this type
should be persisted by the workspace. If the persistent characteristic
is not specified, the marker type is <b>not</b> persisted.
the name of an attribute which may be present on markers of this type
Following is an example of a marker configuration:
<p>
<pre>
<extension id="com.xyz.coolMarker" point="org.eclipse.core.resources.markers" name="Cool Marker">
<persistent value="true"/>
<super type="org.eclipse.core.resources.problemmarker"/>
<super type="org.eclipse.core.resources.textmarker"/>
<attribute name="owner"/>
</extension>
</pre>
</p>
All markers, regardless of their type, are instances of
<samp>org.eclipse.core.resources.IMarker</samp>.
The platform itself has a number of pre-defined
marker types. Particular product installs may
include additional markers as required.
Copyright (c) 2002, 2008 IBM Corporation and others.<br>
This program and the accompanying materials are made
available under the terms of the Eclipse Public License 2.0 which
accompanies
this distribution, and is available at
<a
href="https://www.eclipse.org/legal/epl-2.0">https://www.eclipse.org/legal/epl-v20.html</a>/
SPDX-License-Identifier: EPL-2.0