Graphical Modeling Framework Tooling - Eclipse Modeling Project: A Domain-Specific Language Toolkit - page 534

transformation. This transformation is currently implemented in Java code but
might eventually be implemented in QVT Operational Mapping Language (OML).
GMF provides merge functionality to help in reconciling changes made to the
generator model when retransforming from the mapping model. The
Experimental Software Development Kit (SDK) provides a trace facility that
helps maintain generated visual IDs consistent between regenerations. We rec-
ommend that you use these facilities if you plan to make changes or augment the
generator model in any way.
The generator model has references to the EMF generator model for use in
generating the diagram code. The figures used in the diagram are either serialized
into fields in the generator model during the transformation from gmfmap to
gmfgen, or they are referenced by class name from their corresponding generated
figure plug-in.
Following are descriptions of the major elements of the generator model,
with particular attention given to those that the Toolsmith most likely will
change before generation.
11.4.1 Gen Editor Generator
This element is the root of the generator model and contains general properties
and child elements for the generated diagram editor. Following is a description
of each.
Copyright Text
Use this property to enter the copyright statements you want to appear at the top
of your generated source code. Note that you do not need to enter the comment
markers, such as /*, */, //, <!--, or --> . These are added automatically,
and the generated source code respects the line breaks you enter in the multiline
dialog.
Note that copyright statements are added to Java and plugin.xml files
only, not to .properties files or the OSGi bundle manifest ( MANIFEST.MF ).
Also be aware that, thanks to current merge limitations, changes to this property
do not affect existing files. Delete all files and regenerate if you want the copy-
right text updated.
Diagram File Extension
This is the file extension registered with the org.eclipse.ui.editors
extension-point contribution in the generated diagram plug-in manifest. By
default, it is the name of the domain model with _diagram appended. The
extension you choose should be unique, if possible.