package org.csstudio.platform.data;

/** The enumerated version of {@link IMetaData}.
 *  <p>
 *  Handles the mapping from enumeration integers to state strings.
 *  
 *  @see IMetaData
 *  @see IEnumeratedValue
 *  @author Kay Kasemir 
 */
public interface IEnumeratedMetaData extends IMetaData
{
    /** Obtain the state strings.
     *  <p>
     *  The array element <code>i</code> represends state number <code>i</code>.
     *  @return The state strings.
     */
    public String[] getStates();

    /** Convenience routine for getting a state string.
     *  <p>
     *  Also allows getting undefined states. Applications that want to
     *  specifically handle undefined states should use
     *  <code>getStates()</code> instead.
     *  @param state The state to get.
     *  @return A state string.
     */
    public String getState(int state);
}
@@ -418,16 +418,25 @@
 /code%3E.%0A
+     *  %0A
      *  
@@ -451,33 +451,63 @@
 The state string
-s
+ array, never %3Ccode%3Enull%3C/code%3E
 .%0A     */%0A    pu

comment on non-null