Program: 78508
Project: 78508
Buggy source:
/** 
 * <p>Returns the ModelMBean's descriptor which contains MBean wide policies.  This descriptor contains metadata about the MBean and default policies for persistence and caching.</p> <P id="descriptor"> The fields in the descriptor are defined, but not limited to, the following.  Note that when the Type in this table is Number, a String that is the decimal representation of a Long can also be used.</P> <table border="1" cellpadding="5"> <caption style="display:none">ModelMBean Fields</caption> <tr><th>Name</th><th>Type</th><th>Meaning</th></tr> <tr><td>name</td><td>String</td> <td>MBean name.</td></tr> <tr><td>descriptorType</td><td>String</td> <td>Must be "mbean".</td></tr> <tr><td>displayName</td><td>String</td> <td>Name of MBean to be used in displays.</td></tr> <tr><td>persistPolicy</td><td>String</td> <td>One of: OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never. See the section "MBean Descriptor Fields" in the JMX specification document.</td></tr> <tr><td>persistLocation</td><td>String</td> <td>The fully qualified directory name where the MBean should be persisted (if appropriate).</td></tr> <tr><td>persistFile</td><td>String</td> <td>File name into which the MBean should be persisted.</td></tr> <tr><td>persistPeriod</td><td>Number</td> <td>Frequency of persist cycle in seconds, for OnTime and NoMoreOftenThan PersistPolicy</td></tr> <tr><td>currencyTimeLimit</td><td>Number</td> <td>How long cached value is valid: &lt;0 never, =0 always, &gt;0 seconds.</td></tr> <tr><td>log</td><td>String</td> <td>t: log all notifications, f: log no notifications.</td></tr> <tr><td>logfile</td><td>String</td> <td>Fully qualified filename to log events to.</td></tr> <tr><td>visibility</td><td>Number</td> <td>1-4 where 1: always visible 4: rarely visible.</td></tr> <tr><td>export</td><td>String</td> <td>Name to be used to export/expose this MBean so that it is findable by other JMX Agents.</td></tr> <tr><td>presentationString</td><td>String</td> <td>XML formatted string to allow presentation of data to be associated with the MBean.</td></tr> </table> <P> The default descriptor is: name=className,descriptorType="mbean", displayName=className, persistPolicy="never",log="F",visibility="1" If the descriptor does not contain all these fields, they will be added with these default values. <p><b>Note:</b> because of inconsistencies in previous versions of this specification, it is recommended not to use negative or zero values for <code>currencyTimeLimit</code>.  To indicate that a cached value is never valid, omit the <code>currencyTimeLimit</code> field.  To indicate that it is always valid, use a very large number for this field.</p>
 * @return the MBean descriptor.
 * @exception MBeanException Wraps a distributed communicationException.
 * @exception RuntimeOperationsException a {@link RuntimeException} occurred while getting the descriptor.
 * @see #setMBeanDescriptor
 */
public Descriptor getMBeanDescriptor() throws MBeanException, RuntimeOperationsException ;

Fixed version (ground truth):
/** 
 * <p>Returns the ModelMBean's descriptor which contains MBean wide policies.  This descriptor contains metadata about the MBean and default policies for persistence and caching.</p> <P id="descriptor"> The fields in the descriptor are defined, but not limited to, the following.  Note that when the Type in this table is Number, a String that is the decimal representation of a Long can also be used.</P> <table class="striped"> <caption style="display:none">ModelMBean Fields</caption> <tr><th>Name</th><th>Type</th><th>Meaning</th></tr> <tr><td>name</td><td>String</td> <td>MBean name.</td></tr> <tr><td>descriptorType</td><td>String</td> <td>Must be "mbean".</td></tr> <tr><td>displayName</td><td>String</td> <td>Name of MBean to be used in displays.</td></tr> <tr><td>persistPolicy</td><td>String</td> <td>One of: OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never. See the section "MBean Descriptor Fields" in the JMX specification document.</td></tr> <tr><td>persistLocation</td><td>String</td> <td>The fully qualified directory name where the MBean should be persisted (if appropriate).</td></tr> <tr><td>persistFile</td><td>String</td> <td>File name into which the MBean should be persisted.</td></tr> <tr><td>persistPeriod</td><td>Number</td> <td>Frequency of persist cycle in seconds, for OnTime and NoMoreOftenThan PersistPolicy</td></tr> <tr><td>currencyTimeLimit</td><td>Number</td> <td>How long cached value is valid: &lt;0 never, =0 always, &gt;0 seconds.</td></tr> <tr><td>log</td><td>String</td> <td>t: log all notifications, f: log no notifications.</td></tr> <tr><td>logfile</td><td>String</td> <td>Fully qualified filename to log events to.</td></tr> <tr><td>visibility</td><td>Number</td> <td>1-4 where 1: always visible 4: rarely visible.</td></tr> <tr><td>export</td><td>String</td> <td>Name to be used to export/expose this MBean so that it is findable by other JMX Agents.</td></tr> <tr><td>presentationString</td><td>String</td> <td>XML formatted string to allow presentation of data to be associated with the MBean.</td></tr> </table> <P> The default descriptor is: name=className,descriptorType="mbean", displayName=className, persistPolicy="never",log="F",visibility="1" If the descriptor does not contain all these fields, they will be added with these default values. <p><b>Note:</b> because of inconsistencies in previous versions of this specification, it is recommended not to use negative or zero values for <code>currencyTimeLimit</code>.  To indicate that a cached value is never valid, omit the <code>currencyTimeLimit</code> field.  To indicate that it is always valid, use a very large number for this field.</p>
 * @return the MBean descriptor.
 * @exception MBeanException Wraps a distributed communicationException.
 * @exception RuntimeOperationsException a {@link RuntimeException} occurred while getting the descriptor.
 * @see #setMBeanDescriptor
 */
public Descriptor getMBeanDescriptor() throws MBeanException, RuntimeOperationsException ;