|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
|
5 <title>GEF Project Release Notes 3.2</title> |
|
6 </head> |
|
7 <body> |
|
8 |
|
9 <h1>GEF Project Release Notes</h1> |
|
10 |
|
11 <p>Release 3.2<br> |
|
12 Last revised September 29, 2005</p> |
|
13 |
|
14 <blockquote> |
|
15 <p><a href="#Target Operating Environments">1. Target |
|
16 Platforms</a><br> |
|
17 <a href="#Compatibility with Previous Release"> 2. Compatibility with |
|
18 Previous Release</a><br> |
|
19 <a href="#BreakingAPI">3. API Changes</a><br> |
|
20 <a href="#Known Issues">4. Known Issues</a></p> |
|
21 </blockquote> |
|
22 |
|
23 <h2>1. <a name="Target Operating Environments"></a> Target Platforms</h2> |
|
24 |
|
25 <p>GEF 3.2 requires the Eclipse 3.2 Rich Client Platform and the optional <b><code>org.eclipse.ui.views</code></b> |
|
26 plug-in. |
|
27 See the Eclipse Platform readme for requirements of the Eclipse |
|
28 platform.</p> |
|
29 |
|
30 <p>GEF 3.2 has been tested and validated on the following Java 2 |
|
31 Platform implementations:</p> |
|
32 <table width="821" border="1"> |
|
33 <tr bgcolor="#CCCCCC"> |
|
34 <th colspan="4"> |
|
35 <div align="center"> |
|
36 <b><font size="+1">Eclipse Reference Platforms</font></b> |
|
37 |
|
38 </div> |
|
39 </th> |
|
40 </tr> |
|
41 <tr> |
|
42 <td width="205"><b>Operating system</b></td> |
|
43 <td width="76"><b>Processor architecture</b></td> |
|
44 <td width="59"><b>Window system</b></td> |
|
45 |
|
46 <td width="453"><b>Java 2 Platform</b></td> |
|
47 </tr> |
|
48 <tr> |
|
49 <td width="205">Microsoft Windows XP</td> |
|
50 <td width="76">Intel x86</td> |
|
51 <td width="59">Win32</td> |
|
52 <td width="453">Sun Java 2 Standard Edition, version 1.4.2_08 for Microsoft Windows</td> |
|
53 |
|
54 </tr> |
|
55 <tr> |
|
56 <td width="205">Microsoft Windows XP</td> |
|
57 <td width="76">Intel x86</td> |
|
58 <td width="59">Win32</td> |
|
59 <td width="453"> <p>IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 1.4.2 SR1a</p> |
|
60 |
|
61 </td> |
|
62 </tr> |
|
63 <tr> |
|
64 <td width="205">Red Hat Enterprise Linux WS 3</td> |
|
65 <td width="76">Intel x86</td> |
|
66 <td width="59">GTK</td> |
|
67 <td width="453">Sun Java 2 Standard Edition, 1.4.2_08 for Linux x86</td> |
|
68 |
|
69 </tr> |
|
70 <tr> |
|
71 <td width="205">Red Hat Enterprise Linux WS 3</td> |
|
72 <td width="76">Intel x86</td> |
|
73 <td width="59">GTK</td> |
|
74 <td width="453">IBM 32-bit SDK for Linux on Intel architecture, Java 2 Technology |
|
75 Edition, Version 1.4.2 SR1a</td> |
|
76 |
|
77 </tr> |
|
78 <tr> |
|
79 <td width="205">SLES 9</td> |
|
80 <td width="76">Intel x86</td> |
|
81 <td width="59">GTK</td> |
|
82 <td width="453">Sun Java 2 Standard Edition, version 1.4.2_08 for Linux x86</td> |
|
83 |
|
84 </tr> |
|
85 <tr> |
|
86 <td width="205">SLES 9</td> |
|
87 <td width="76">Intel x86</td> |
|
88 <td width="59">GTK</td> |
|
89 <td width="453">IBM 32-bit SDK for Linux on Intel architecture, Java 2 Technology |
|
90 Edition, Version 1.4.2 SR1a</td> |
|
91 |
|
92 </tr> |
|
93 <tr> |
|
94 <td width="205">Sun Solaris 8</td> |
|
95 <td width="76">SPARC</td> |
|
96 <td width="59">Motif</td> |
|
97 <td width="453">Sun Java 2 SDK, Standard Edition, 1.4.2_08 for Solaris SPARC</td> |
|
98 |
|
99 </tr> |
|
100 <tr> |
|
101 <td width="205">HP HP-UX 11i</td> |
|
102 <td width="76">hp9000<br> |
|
103 PA-RISC</td> |
|
104 <td width="59">Motif</td> |
|
105 <td width="453"><p>HP-UX SDK for the Java 2 platform, version 1.4.2.07 for hp9000 PA-RISC</p></td> |
|
106 |
|
107 </tr> |
|
108 <tr> |
|
109 <td width="205" height="21">IBM AIX 5L Version 5.2</td> |
|
110 <td width="76">PowerPC</td> |
|
111 <td width="59">Motif</td> |
|
112 <td width="453"> <p>IBM 32-bit SDK for AIX, Java 2 Technology Edition, Version 1.4.2 SR1a</p> |
|
113 |
|
114 </td> |
|
115 </tr> |
|
116 <tr> |
|
117 <td width="205">Apple Mac OS X 10.3</td> |
|
118 <td width="76">PowerPC</td> |
|
119 <td width="59">Carbon</td> |
|
120 <td width="453">Java 2 Standard Edition 1.4.2 for Mac OS X</td> |
|
121 |
|
122 </tr> |
|
123 </table> |
|
124 |
|
125 <p>Although untested, GEF should work fine on other OSes where the Eclipse |
|
126 platform works.</p> |
|
127 |
|
128 <h2>2. <a name="Compatibility with Previous Release"></a> Compatibility with Previous Release</h2> |
|
129 |
|
130 <p><b>API Contract Compatibility:</b> GEF 3.2 is upwards contract-compatible |
|
131 with GEF 3.0 except for those areas noted in |
|
132 <a href="#BreakingAPI">Breaking API Changes</a>. Downward contract compatibility |
|
133 is not supported. There is no guarantee that compliance with 3.2 APIs would |
|
134 ensure compliance with 3.0 APIs. Refer to <i><a href="http://eclipse.org/eclipse/development/java-api-evolution.html">Evolving |
|
135 Java-based APIs</a></i> for a discussion of the kinds of API changes that |
|
136 maintain contract compatibility.</p> |
|
137 <p><b>Binary (plug-in) Compatibility:</b> GEF 3.2 is upwards binary-compatible |
|
138 with GEF 3.0 except in those areas noted in |
|
139 <a href="#BreakingAPI">Breaking API Changes</a>. Downward plug-in |
|
140 compatibility is not supported. Plug-ins based on GEF 3.2 will not work with GEF |
|
141 3.0. Refer to <i><a href="http://eclipse.org/eclipse/development/java-api-evolution.html">Evolving |
|
142 Java-based APIs</a></i> for a discussion of the kinds of API changes that |
|
143 maintain binary compatibility. |
|
144 <p><b>Non-compliant usage of API's</b>: All non-API methods and classes, and |
|
145 everything in a package with "internal" in its name, are |
|
146 considered implementation details which may vary between operating environment |
|
147 and are subject to change without notice. Client plug-ins that directly depend |
|
148 on anything other than what is specified in the API are inherently |
|
149 unsupportable and receive no guarantees about compatibility within a single |
|
150 release or across releases. Refer to <i><a href="http://www.eclipse.org/articles/Article-API%20use/eclipse-api-usage-rules.html">How |
|
151 to Use the Eclipse API</a></i> for information about how to write compliant |
|
152 plug-ins. </p> |
|
153 <h2>3. <a name="BreakingAPI"></a>API Changes</h2> |
|
154 <h4>Deprecated API that was removed in 3.2</h4> |
|
155 <ul> |
|
156 <li>The fields <code>viewer</code> and <code>contents</code> were removed from <code>ScalableRootEditPart</code> and <code>FreeformGraphicalRootEditPart</code>. |
|
157 (Bug 111102)</li> |
|
158 </ul> |
|
159 <h4>API Behavior Changes</h4> |
|
160 <ul> |
|
161 <li><code>BorderLayout</code> has been changed to vertically stretch the central figure (it used to center it before). (Bug 113008)</li> |
|
162 <li><code>TextFlow#getFirstOffsetForLine(int)</code> and <code>TextFlow#getLastOffsetForLine(int)</code> now expect the given int argument to be the exact baseline value. (Bug 113700)</li> |
|
163 </ul> |
|
164 <h4>Breaking API Changes</h4> |
|
165 <ul> |
|
166 <li>None</li> |
|
167 </ul> |
|
168 <h2>4. <a name="Known Issues"></a>Known Issues</h2> |
|
169 <h4>Printing</h4> |
|
170 <blockquote> |
|
171 <p>Some fonts scale differently on the printer than they do on the screen. This |
|
172 may result in printed text appearing wider than the same text on the screen. |
|
173 Clients can use margins to ensure that extra space is available to the figure |
|
174 when printing.</p> |
|
175 <p>Printing may not be implemented by SWT on some platforms.</p> |
|
176 </blockquote> |
|
177 <p><b>Mirrored mode (Right to Left)</b></p> |
|
178 <blockquote> |
|
179 <p>Printing figures that are on a mirrored (right-to-left) control may not work |
|
180 with some printer drivers.</p> |
|
181 <p dir="ltr">Advanced graphics might not work in mirrored mode. Bug |
|
182 <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=99564">99564</a></p> |
|
183 </blockquote> |
|
184 |
|
185 <hr> |
|
186 <p>Java and all Java-based trademarks are trademarks of Sun |
|
187 Microsystems, Inc. in the United States, other countries, or both.</p> |
|
188 <p>IBM is a trademark of International Business Machines Corporation in |
|
189 the United States, other countries, or both.</p> |
|
190 <p>Microsoft, Windows, Windows NT, and the Windows logo are trademarks |
|
191 of Microsoft Corporation in the United States, other countries, or both.</p> |
|
192 <p>Other company, product, and service names may be trademarks or |
|
193 service marks of others.</p> |
|
194 <p>(c) Copyright IBM Corp. and others 2006</p> |
|
195 |
|
196 </body> |
|
197 </html> |