Enum JavaDoc: 1) outline 5.0 native Enum migration 2) warn not to use the switch() , 3) point out approaches for persistence and gui

• Key: LANG-258
• Type: Improvement
• Status: Closed
• Resolution: Fixed
• Priority: Major
• Assignee: Unassigned
• Reporter: Ralf Hauser
• Affects Version/s: 2.1
• Fix Version/s: 2.3

Description

http://jakarta.apache.org/commons/lang/api/org/apache/commons/lang/enums/Enum.html is great!

Now that Jdk5.0 has its own approach for type-safe enums, would it be great to provide a few sentences

• whether they simply should co-habit?
• how one would best migrate?
• where the concepts are different

Also, it would be great to provide some hints how to work on the with a MVC/GUI framework - see SB-20.

also, http://jakarta.apache.org/commons/lang/api/org/apache/commons/lang/enums/ValuedEnum.html has a minor typo

it says "doSomething(JavaVersion", but should say "doSomething(JavaVersionEnum"

also, it should contain a big warning that by using switch(), one opens up for type-unsafety!