/[debian]/libjgoodies-looks-java/trunk/RELEASE-NOTES.txt
ViewVC logotype

Annotation of /libjgoodies-looks-java/trunk/RELEASE-NOTES.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 363 - (hide annotations)
Fri Sep 29 15:26:06 2006 UTC (14 years, 11 months ago) by gregoa
File MIME type: text/plain
File size: 20871 byte(s)
[svn-inject] Forking libjgoodies-looks-java source to Trunk
1 gregoa 361
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