/[debian]/libjgoodies-looks-java/branches/upstream/2.0.4/RELEASE-NOTES.txt
ViewVC logotype

Contents of /libjgoodies-looks-java/branches/upstream/2.0.4/RELEASE-NOTES.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 362 - (show annotations)
Fri Sep 29 15:26:05 2006 UTC (14 years, 10 months ago) by gregoa
File MIME type: text/plain
File size: 20871 byte(s)
[svn-inject] Tagging upstream source version of libjgoodies-looks-java
1
2
3 JGoodies Looks
4 Version 2.0.4
5 Release Notes
6
7
8 INTRODUCTION
9
10 This maintenance release fixes a severe regression (issue #142)
11 that affects the JGoodies Windows L&fs in classic Windows mode
12 on Java 1.4/Java 1.5 where a window displays a JPasswordField.
13 It is strongly recommended to update your Looks library version.
14
15 Also, the font choice in Chinese, Korean, and other non-western
16 environments has been improved for the case where the Java env
17 lacks the multi-language files.
18
19
20 BUGS FIXED
21
22 #141: fonttest.jar manifest classpath broken.
23 #142: Broken classic Windows password field in 1.4 and 1.5.
24 #143: Broken font choice in non-western envs that lack i18n files
25
26
27 OTHER CHANGES
28
29 o FontTest shows more detailed internationalization data.
30 o Added a JUnit test for Fonts#canDisplayLocalizedText(Font, Locale).
31
32
33 ---------------------------------------------------------------------------
34 Find below the change history for older releases.
35
36
37 JGoodies Looks
38 Version 2.0.3
39 Release Notes
40
41
42 INTRODUCTION
43
44 This maintenance release fixes a regression, comes with improved
45 support for the Windows Vista Beta2, and ships the Plastic themes
46 "Experience Royale" for XP's Royale style, and "Light Gray"
47 for Vista's Aero style.
48
49
50 BUGS FIXED
51
52 #130: Plastic internal frames paint wrong drop shadow.
53 #135: Fonts#getWindowsControlFont returns null on Vista Beta2.
54 #136: NPE in DefaultPlasticOnWindowsPolicy on Vista Beta2.
55 #137: Component height too small on Vista Beta2.
56 #138: Add a color theme that mimics Vista's Aero default.
57
58
59 NEW FEATURES
60
61 o Added the Plastic themes "Experience Royale" and "Light Gray".
62 o Improved the mechanism that chooses the default Plastic theme
63 to detect Luna Normal/Home Stead/Metallic, the MS Royale skin,
64 and Vista's Aero. "Experience Royale" is the default on XP-Royale,
65 "Light Gray" is the default on Vista-Aero.
66
67
68 OTHER CHANGES
69
70 o Distribution ships with a precompiled Font Test jar.
71 o Removed the Palette2 from the Looks Demo desktop tab.
72 o Minor cleanup in the build.xml and default.properties.
73
74
75 ---------------------------------------------------------------------------
76
77 Find below the change history for older releases.
78
79
80 JGoodies Looks
81 Version 2.0.2
82 Release Notes
83
84
85 INTRODUCTION
86
87 This maintenance release fixes a regression, a bug, and improves
88 the password field appearance in non-Windows environments.
89
90
91 BUGS FIXED
92
93 #122: Regression: Missing popup menu drop shadows.
94 #123: Windows popup menu may lack the selection background.
95 #127: Spinner editor insets too large since Mustang b82.
96
97
98 OTHER CHANGES
99
100 o Marked Options.TEXT_AREA_INFO_BACKGROUND_KEY as deprecated.
101 We suggest to use a factory that vends JTextArea's
102 with the background set to the editable background instead.
103 You may use a text area that sets the background in #updateUI
104 to ensure that it is refreshed on Look&Feel changes.
105 o Combo box popup uses the combo box width as minimum,
106 even if a popup prototype display value has been set.
107 o The Windows and Plastic password fields now use the
108 UIManager's echo character, share the password view,
109 and this patch is used in Java 1.4 and Java 5 only.
110 o The Looks Demo shows non-editable and disabled spinners.
111 o Improved the selection background of non-editable
112 Windows combo boxes that use a custom renderer.
113
114 ---------------------------------------------------------------------------
115
116 Find below the change history for older releases.
117
118
119
120 JGoodies Looks
121 Version 2.0.1
122 Release Notes
123
124
125 INTRODUCTION
126
127 This maintenance release fixes a bug that affects those who
128 want to use the visual backward compatible Looks1xWindowsFontPolicy
129 on Windows 95/98/NT/ME. It also fixes two minor bugs that affect
130 all platforms.
131
132
133 BUGS FIXED
134
135 #107: IllegalArgumentException for degenerated popup with shadow.
136 #118: Potentially wrong font for menu item accelerators.
137 #120: NPE in visual backward compatiblity FontPolicy on Windows 98.
138
139
140 OTHER CHANGES
141
142 o Added toolbar tool tips and a keyboard action to the Looks Demo.
143
144
145 ---------------------------------------------------------------------------
146
147 Find below the change history for older releases.
148
149
150
151 JGoodies Looks
152 Version 2.0
153 Release Notes
154
155
156 INTRODUCTION
157
158 This JGoodies Looks version 2.0 fixes bugs, comes with
159 many improvements and uses an overhauled font lookup.
160 The contained Windows L&f and Plastic L&fs supercede
161 all previous version w.r.t. consistency, design precision,
162 and support for Java 5, Java 6 and Windows Vista.
163
164 Version 2.0 is binary and visually incompatible with the
165 Looks 1.x; however most API changes are simplifications and
166 the visual changes improve the consistency of your apps.
167
168 The font lookup in the Windows L&f has been overhauled.
169 Text component insets have been adjusted to better comply
170 with the "Microsoft Layout Specification and Guidelines".
171 Also, Windows Vista is now supported: bounds, insets and
172 font baseline positions are consistent on the Vista betas.
173
174 The Plastic L&f family component bounds and insets
175 have been adjusted to the new Windows bounds and insets.
176 The Plastic font lookup has been completely overhauled;
177 it is great on Windows and works well on other platforms.
178
179 The new font customization mechanism allows you to change
180 the fonts per L&f, platform, locale and desktop settings.
181
182
183 CHANGES THAT AFFECT THE BINARY COMPATIBILITY
184
185 The old font options (FontSizeHints, etc) have been replaced
186 by the new FontPolicy mechanism and predefined FontPolicies.
187
188 o Replaced Options.CONTROL_FONT_KEY and MENU_FONT_KEY by:
189 - PLASTIC_FONT_CHOICE_POLICY_KEY
190 - PLASTIC_CONTROL_FONT_KEY
191 - PLASTIC_MENU_FONT_KEY
192 - WINDOWS_FONT_CHOICE_POLICY_KEY
193 - WINDOWS_CONTROL_FONT_KEY
194 - WINDOWS_MENU_FONT_KEY
195 o Removed Options.EXT_WINDOWS_NAME
196 o Removed Options.FONT_SIZE_HINTS_KEY
197 o Removed Options#getGlobalFontSizeHints
198 o Removed Options#setGlobalFontSizeHints
199 o Removed PlasticLookAndFeel#getFontSizeHints
200 o Removed PlasticLookAndFeel#setFontSizeHints
201 o Removed WindowsLookAndFeel#getFontSizeHints
202 o Removed WindowsLookAndFeel#setFontSizeHints
203 o Removed FontSizeHints
204 o Removed LookUtils#createButtonMargin(boolean)
205 o Removed LookUtils#installNarrowMargin
206 o Removed FontUtils
207 o Options#initializeDefaultReplacements now private
208 o Removed obsolete Plastic themes: SkyBluerTahoma,
209 ExperienceBlueDefaultFont, DesertBluerDefautFont
210
211
212 CHANGES THAT AFFECT THE VISUAL COMPATIBILITY
213
214 Options#getUseNarrowButtons returns true by default.
215 Although the narrow margins are the correct button margins,
216 it leads to poor design if you don't ensure a reasonable
217 minimum width for buttons with a short text, e.g. "OK".
218 You can disable this feature using #setUseNarrowButtons(false),
219 which was the behavior in the JGoodies Looks 1.x.
220
221 Options.DEFAULT_LOOK_NAME is now PLASTICXP_NAME
222 making PlasticXP the default L&f when chosen via
223 the Options L&f names. PLASTICXP_NAME is also returned
224 by Options#getCrossPlatformLookAndFeelClassName.
225
226 On Windows 95/98/ME/NT/2000/2003/XP the JGoodies Windows L&f
227 follows the "Microsoft Layout Specifications and Guidelines"
228 even closer than the JGoodies Windows L&f version 1.3.
229 Components that are arranged in a row have perceived bounds
230 of 14 dialog units (dlu). Since Windows XP command buttons
231 (in the default styles) have two transparent lines in
232 the top and bottom, the concrete command button bounds
233 are 2 pixels larger than for the textfield, combo, etc.
234 If you lay out them in a row and center them vertically
235 the perceived (aka visual) bounds will be aligned.
236 On Windows Vista the JGoodies Windows L&f dimensions
237 and insets are based on the "Windows Vista UX Guidelines"
238 version 0.8. The JGoodies sizes differ slightly from
239 the sizes recommended by these guidelines. For example
240 the guidelines recommend to make a text field on 96dpi
241 with normal fonts 20px tall, a combo 21px and buttons 22px
242 (or 13dlu). The JGoodies Windows L&f uses consistent sizes,
243 insets and font baseline positions for all components
244 that are arranged in a row - just as recommended in all
245 previous Windows editions, but based on 13dlu because
246 the new default font Segoe UI is significantly taller.
247
248 The default font chosen on Windows now honors the desktop
249 font setting (Normal/Large/Extra Large) if supported
250 by the Windows version, Windows language, and Java renderer.
251 Microsoft recommends to use the desktop setting "font size"
252 to get larger fonts, many applications ignore it and
253 just scale with the software resolution (96dpi/120dpi).
254 On 96dpi the new font doesn't differ from the
255 font chosen by the Looks 1.x; it's Tahoma 8pt on modern
256 Windows, and Segoe UI 9pt on Vista. On 120dpi the new font
257 is 1px taller than the font used by the Looks 1.x.
258
259 The Plastic L&f family uses Windows fonts on Windows
260 and logical fonts on all other platforms. In the Looks 1.x
261 most Plastic themes used the Tahoma font on all platforms.
262 If Tahoma was absent, the logical fonts were used.
263
264
265 VISUAL BACKWARD COMPATIBILITY
266
267 We recommend to use the new default settings and it is
268 strongly recommended to use the new font lookup on Windows.
269 However, here's how you can get the appearance of
270 the Looks 1.x. The configurations listed below
271 must be performed before you install a look&feel.
272
273 To get the wrong wide button margins, call:
274 Options.setNarrowMargins(false).
275
276 To use the Looks 1.x fonts in the Windows L&f use:
277 WindowsLookAndFeel.setFontPolicy(
278 FontPolicies.getLooks1xWindowsPolicy());
279
280 To use the Looks 1.x fonts in the Plastic L&fs use:
281 PlasticLookAndFeel.setFontPolicy(
282 FontPolicies.getLooks1xPlasticPolicy());
283
284 To give Plastic the new fonts on Windows and the
285 Looks 1.x fonts on other platforms use:
286 PlasticLookAndFeel.setFontPolicy(
287 FontPolicies.getTransitionalPlasticPolicy());
288
289 You can customize the control font and menu font
290 in the system properties for Windows and Plastic:
291 java -jar -DWindows.controlFont="Tahoma-plain-11"
292 -DWindows.menuFont="Tahoma-plain-12"
293 -DPlastic.controlFont="Tahoma-plain-11"
294 -DPlastic.menuFont="Verdana-bold-12"
295 myapplication.jar
296 If the menu font is not specified, the control font
297 will be used for menus too.
298
299
300 BUGS FIXED
301
302 #10: Plastic looks can't display Chinese, Japanese, Korean.
303 #50: ToolBar 3D effect ignores the orientation.
304 #51: Windows combobox with custom render is too narrow.
305 #60: Wrong combobox height in Java 5 and Java 6.
306 #67: Wrong menu border in Windows XP L&f.
307 #69: Broken menu item anti-aliasing in Java 5 or later.
308 #70: Inconsistent bounds, insets and baselines on Windows Vista.
309 #71: Password echo character too small on Windows Vista.
310 #73: Windows L&f ignores the desktop control font size setting.
311 #74: Color theme lost on Applet refresh.
312 #79: Windows combobox too narrow.
313 #80: Plastic combo arrow button is focusable in Java 6.
314 #81: Wrong icon for "OptionPane.questionIcon" property.
315 #83: Windows tabbed pane has line under selected tab
316 in Java 5 or later if the content border is disabled.
317 #84: Windows L&F combo margin too wide in table.
318 #86: Windows combobox too narrow if the renderer has zero insets.
319 #89: Plastic L&F editable combo margin too large in table.
320 #90: Spinner does not stop the timer when loosing focus.
321 #91: Progress invisible in Plastic Silver theme.
322 #94: Windows default title font shall be plain not bold.
323 #95: Display Windows toolbar drag handles.
324 #96: Fix Windows formatted text field background.
325 #97: Fix text area disabled/non-editable background.
326 #98: Fix Windows disabled non-editable combo background.
327 #100: Fix WindowsXP title color on Java 1.4.2.
328 #101: Windows combo text phantom UI doesn't change with L&f.
329 #102: Plastic menu doesn't restore opaque state.
330 #103: Disabled menu items lack shadow in classic mode.
331 #105: Menu items mnemonic display shall check for show/hide status.
332 #108: JMenu on JPopupMenu not always drawn in selected state.
333 #110: NPE with invalid default Plastic theme set via system props.
334 #111: RTL menus have problems with accelerator alignment.
335 #113: Combo popup with prototype ignores scrollbar visibility.
336 #114: Accelerator text overlaps menu text if no-icons is set.
337 #115: Need a fix for the Java bug 4530952.
338
339
340 KNOWN ISSUES
341
342 Plastic 3D effect broken on Mac OS X Tiger with Java 1.4 and 5.
343 Due to a bug in the Tiger Java2D implementation, the pseudo 3D
344 up and down effects are not rendered. Instead a plain white
345 is painted. See also issue #92.
346
347
348 NEW FEATURES
349
350 #55: Add option to make combo popups wider than the combo.
351 You can set a popup prototype display value that
352 is used to determine with popup widths.
353
354 o Narrow buttons can be disabled in the system properties.
355 o Added a JPopupMenu client property for no-margin borders,
356 see Options#NO_MARGIN_KEY. This is useful if a JPopupMenu
357 contains a single component, for example a JScrollPane.
358 o Added a JTextArea client property for an info background.
359 This hint is used for non-editable areas that shall use
360 the editable background, not the inactive background.
361
362
363 DISTRIBUTION CHANGES
364
365 o Merged the source folders 'src/common', 'src/plastic'
366 and 'src/windows' to 'src/core'.
367 o The sources no longer ship as a source Zip archive.
368 They now come in the directory structure used by the CVS.
369 This makes it easier to build the distribution using ANT.
370 If you want to attach the library sources in an IDE,
371 point to folder 'src/core'.
372
373
374 OTHER CHANGES
375
376 o The Windows and Plastic L&fs have been tweaked for Windows Vista.
377 o Overhauled the Windows combobox layout and rendering.
378 o Overhauled the Plastic combobox layout and rendering.
379 o Improved appearance of the Looks Demo tabs on Windows.
380 o The ANT build can now create a Maven bundle.
381 o The demo's DemoFrame class accepts a parameter for the L&f:
382 "Windows", "Plastic", "Plastic3D", "PlasticXP",
383 or a full class name like:
384 "com.sun.java.swing.plaf.windows.WindowsLookAndFeel",
385 "javax.swing.plaf.metal.MetalLookAndFeel".
386
387
388 ---------------------------------------------------------------------------
389
390 Find below the change history for older releases.
391
392
393
394 JGoodies Looks, Version 1.3.2
395 Release Notes
396
397
398 INTRODUCTION
399
400 This update fixes a couple of bugs, most noticably in the drop shadow
401 feature. Also the source code style has been slightly improved.
402
403
404 BUGS FIXED
405
406 #43: ShadowPopupFactory doesn't respect the lightweight property.
407 #45: NPE in ShadowPopup.hide().
408 #47: JavaCup.gif reported missing in Windows L&f.
409 #50: ToolBarUI doesn't take the orientation into account.
410 #53: ClassCastException in ShadowPopup.
411 #56: NPE in ShadowPopupFactory on OS X 10.4.
412
413
414 OTHER CHANGES
415
416 o Set 'build.compile.source' and 'build.compile.target' to '1.4'
417 in the default.properties; build.xml honors these settings.
418 o Improved the style of the Java sources:
419 + removed some tab characters,
420 + ensured consistent modifier order,
421 + fixed JavaDoc tags.
422
423
424 ---------------------------------------------------------------------------
425
426 Find below the change history for older releases.
427
428
429
430 JGoodies Looks, Version 1.3.1
431 Release Notes
432
433
434 INTRODUCTION
435
436 This update fixes bug #38; it's worth to ship a new version.
437 All other known non-font related issues could be fixed too.
438
439
440 BUGS FIXED
441
442 o #02: Plastic combo lacks 3D effect in 3D toolbar.
443 o #36: Plastic l&fs lack auditory cues.
444 o #37: Extra non-western themes don't work with Looks 1.3.
445 o #38: Options#isTabIconsEnabled broken.
446 o #39: Poor size for null values in combo box renderer.
447
448
449 OTHER CHANGES
450
451 o Core: Added two Plastic color themes intended for non-western fonts,
452 see DesertBluerDefaultFont and ExperienceBlueDefaultFont.
453 These themes ship in source form, are part of the binary jar,
454 but are not installed as default themes. You can use these
455 themes via PlasticLookAndFeel#setMyCurrentTheme(PlasticTheme).
456 Via PlasticLookAndFeel#installTheme(PlasticTheme) you can
457 include them in the list of known Plastic themes.
458 o Core: PlasticXP spinner uses consistent button widths.
459 o Dist: Startet a JUnit test suite.
460 o Docs: Replaced older package names with the new names.
461 o Build: ANT build file can perform JUnit tests.
462
463
464 ---------------------------------------------------------------------------
465
466 Find below the change history for older releases.
467
468
469
470 JGoodies Looks, Version 1.3
471 Release Notes
472
473
474 INTRODUCTION
475
476 This release fixes bugs and uses new package and class names.
477 Java 1.5 is now supported, but some micro design improvements
478 made in the Looks are optimized for Java 1.4.2 and Java 1.4.1.
479
480
481 BUGS FIXED
482
483 o Plastic internal frames use the outdated Java cup icon.
484 o Inactive drop shadows still try to snapshot via the Robot.
485 o Broken position calculation in Windows password field.
486 o Broken custom table header in Windows XP style.
487 o #04: Broken Windows JTabbedPane HTML word wrap.
488 o #05: Plastic Theme and Tab Layout Policy.
489 o #17: WindowsToolBarSeparatorUI not same in 1.4.1 and 1.4.2.
490 o #18: Height of menu items with a custom icon.
491 o #20: Popup drop shadow may be corrupted.
492 o #23: Menu items not anti-aliased [in 1.5 with aa enabled].
493 o #24: Spinners drawn incorrectly.
494 o #27: Plastic JTabbedPane scroll buttons unclear.
495 o #28: Broken painting with custom combo renderer in 1.5.
496 o #30: ShadowPopupBorder may throw a SecurityException.
497 o #31: JToggleButton L&F not respecting icon text gap.
498
499
500 CHANGES THAT AFFECT THE BINARY COMPATIBILITY
501
502 o Package names changed from com.jgoodies.plaf to com.jgoodies.looks
503 o ExtWindowsLookAndFeel -> WindowsLookAndFeel
504 o All ClearLook classes have been removed from the Looks.
505 These will show up as a LintLookAndFeel later.
506
507
508 CHANGES THAT AFFECT THE VISUAL COMPATIBILITY
509
510 o PlasticXP's password field paints a dot, not the star.
511
512
513 KNOWN ISSUES
514
515 For all issues see http://looks.dev.java.net/servlets/ProjectIssues
516
517 This release still lacks an improved font management
518 for the Plastic l&f family on non-Windows platforms.
519 For a workaround see issue #10.
520
521
522 OTHER CHANGES
523
524 o Core: Uses more shared UI instances.
525 o Docs: Added and fixed version tags.
526 o Dist: Fixed implementation title and vendor in the JAR manifest.
527 o Dist: Fixed broken package information in the JAR manifest.
528 o Demo: Added test case for all tab placements in both layouts.
529 o Build: Added project name tag to the ANT build file.
530 o Build: Added overview page.
531

  ViewVC Help
Powered by ViewVC 1.1.26