src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequest.java

*** 59,76 ****
   * is reported.
   * </ul>
   * Filters can dramatically improve debugger performance by reducing the
   * amount of event traffic sent from the target VM to the debugger VM.
   * <p>
!  * Any method on <code>EventRequest</code> which
!  * takes <code>EventRequest</code> as an parameter may throw
   * {@link com.sun.jdi.VMDisconnectedException} if the target VM is
   * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is
   * available to be read from the {@link com.sun.jdi.event.EventQueue}.
   * <p>
!  * Any method on <code>EventRequest</code> which
!  * takes <code>EventRequest</code> as an parameter may throw
   * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory.
   *
   * @see com.sun.jdi.event.BreakpointEvent
   * @see com.sun.jdi.event.EventQueue
   * @see EventRequestManager
--- 59,76 ----
   * is reported.
   * </ul>
   * Filters can dramatically improve debugger performance by reducing the
   * amount of event traffic sent from the target VM to the debugger VM.
   * <p>
!  * Any method on {@code EventRequest} which
!  * takes {@code EventRequest} as an parameter may throw
   * {@link com.sun.jdi.VMDisconnectedException} if the target VM is
   * disconnected and the {@link com.sun.jdi.event.VMDisconnectEvent} has been or is
   * available to be read from the {@link com.sun.jdi.event.EventQueue}.
   * <p>
!  * Any method on {@code EventRequest} which
!  * takes {@code EventRequest} as an parameter may throw
   * {@link com.sun.jdi.VMOutOfMemoryException} if the target VM has run out of memory.
   *
   * @see com.sun.jdi.event.BreakpointEvent
   * @see com.sun.jdi.event.EventQueue
   * @see EventRequestManager
*** 82,93 ****
  public interface EventRequest extends Mirror {
  
      /**
       * Determines if this event request is currently enabled.
       *
!      * @return <code>true</code> if enabled;
!      * <code>false</code> otherwise.
       */
      boolean isEnabled();
  
      /**
       * Enables or disables this event request. While this event request is
--- 82,93 ----
  public interface EventRequest extends Mirror {
  
      /**
       * Determines if this event request is currently enabled.
       *
!      * @return {@code true} if enabled;
!      * {@code false} otherwise.
       */
      boolean isEnabled();
  
      /**
       * Enables or disables this event request. While this event request is
*** 95,134 ****
       * will not be stopped if any of its threads reaches the
       * event request.  Disabled event requests still exist,
       * and are included in event request lists such as
       * {@link EventRequestManager#breakpointRequests()}.
       *
!      * @param val <code>true</code> if the event request is to be enabled;
!      * <code>false</code> otherwise.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       * @throws IllegalThreadStateException if this is a StepRequest,
!      * <code>val</code> is <code>true</code>, and the
       * thread named in the request has died or is not yet started.
       */
      void setEnabled(boolean val);
  
      /**
!      * Same as {@link #setEnabled <CODE>setEnabled(true)</CODE>}.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       * @throws IllegalThreadStateException if this is a StepRequest
       * and the thread named in the request has died or is not yet started.
       */
      void enable();
  
      /**
!      * Same as {@link #setEnabled <CODE>setEnabled(false)</CODE>}.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       */
      void disable();
  
      /**
       * Limit the requested event to be reported at most once after a
       * given number of occurrences.  The event is not reported
!      * the first <code>count - 1</code> times this filter is reached.
       * To request a one-off event, call this method with a count of 1.
       * <p>
       * Once the count reaches 0, any subsequent filters in this request
       * are applied. If none of those filters cause the event to be
       * suppressed, the event is reported. Otherwise, the event is not
--- 95,134 ----
       * will not be stopped if any of its threads reaches the
       * event request.  Disabled event requests still exist,
       * and are included in event request lists such as
       * {@link EventRequestManager#breakpointRequests()}.
       *
!      * @param val {@code true} if the event request is to be enabled;
!      * {@code false} otherwise.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       * @throws IllegalThreadStateException if this is a StepRequest,
!      * {@code val} is {@code true}, and the
       * thread named in the request has died or is not yet started.
       */
      void setEnabled(boolean val);
  
      /**
!      * Same as {@link #setEnabled setEnabled(true)}.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       * @throws IllegalThreadStateException if this is a StepRequest
       * and the thread named in the request has died or is not yet started.
       */
      void enable();
  
      /**
!      * Same as {@link #setEnabled setEnabled(false)}.
       * @throws InvalidRequestStateException if this request
       * has been deleted.
       */
      void disable();
  
      /**
       * Limit the requested event to be reported at most once after a
       * given number of occurrences.  The event is not reported
!      * the first {@code count - 1} times this filter is reached.
       * To request a one-off event, call this method with a count of 1.
       * <p>
       * Once the count reaches 0, any subsequent filters in this request
       * are applied. If none of those filters cause the event to be
       * suppressed, the event is reported. Otherwise, the event is not
*** 137,147 ****
       *
       * @param count the number of ocurrences before generating an event.
       * @throws InvalidRequestStateException if this request is currently
       * enabled or has been deleted.
       * Filters may be added only to disabled requests.
!      * @throws IllegalArgumentException if <CODE>count</CODE>
       * is less than one.
       */
      void addCountFilter(int count);
  
      /** Suspend no threads when the event occurs */
--- 137,147 ----
       *
       * @param count the number of ocurrences before generating an event.
       * @throws InvalidRequestStateException if this request is currently
       * enabled or has been deleted.
       * Filters may be added only to disabled requests.
!      * @throws IllegalArgumentException if {@code count}
       * is less than one.
       */
      void addCountFilter(int count);
  
      /** Suspend no threads when the event occurs */
*** 187,197 ****
       * The property can be used by a client of the JDI to
       * associate application information with the request;
       * These client-set properties are not used internally
       * by the JDI.
       * <p>
!      * The <code>get/putProperty</code> methods provide access to
       * a small per-instance map. This is <b>not</b> to be confused
       * with {@link java.util.Properties}.
       * <p>
       * If value is null this method will remove the property.
       *
--- 187,197 ----
       * The property can be used by a client of the JDI to
       * associate application information with the request;
       * These client-set properties are not used internally
       * by the JDI.
       * <p>
!      * The {@code get/putProperty} methods provide access to
       * a small per-instance map. This is <b>not</b> to be confused
       * with {@link java.util.Properties}.
       * <p>
       * If value is null this method will remove the property.
       *