src/share/classes/javax/sound/midi/ShortMessage.java

*** 1,7 ****
  /*
!  * Copyright (c) 1998, 2005, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 281,291 ****
  
  
      /**
       * Sets the parameters for a MIDI message that takes no data bytes.
       * @param status    the MIDI status byte
!      * @throws  <code>InvalidMidiDataException</code> if <code>status</code> does not
       * specify a valid MIDI status byte for a message that requires no data bytes.
       * @see #setMessage(int, int, int)
       * @see #setMessage(int, int, int, int)
       */
      public void setMessage(int status) throws InvalidMidiDataException {
--- 281,291 ----
  
  
      /**
       * Sets the parameters for a MIDI message that takes no data bytes.
       * @param status    the MIDI status byte
!      * @throws  InvalidMidiDataException if <code>status</code> does not
       * specify a valid MIDI status byte for a message that requires no data bytes.
       * @see #setMessage(int, int, int)
       * @see #setMessage(int, int, int, int)
       */
      public void setMessage(int status) throws InvalidMidiDataException {
*** 305,315 ****
       * data bytes are ignored.
       *
       * @param status    the MIDI status byte
       * @param data1             the first data byte
       * @param data2             the second data byte
!      * @throws  <code>InvalidMidiDataException</code> if the
       * the status byte, or all data bytes belonging to the message, do
       * not specify a valid MIDI message.
       * @see #setMessage(int, int, int, int)
       * @see #setMessage(int)
       */
--- 305,315 ----
       * data bytes are ignored.
       *
       * @param status    the MIDI status byte
       * @param data1             the first data byte
       * @param data2             the second data byte
!      * @throws  InvalidMidiDataException if the
       * the status byte, or all data bytes belonging to the message, do
       * not specify a valid MIDI message.
       * @see #setMessage(int, int, int, int)
       * @see #setMessage(int)
       */
*** 355,365 ****
       *
       * @param command   the MIDI command represented by this message
       * @param channel   the channel associated with the message
       * @param data1             the first data byte
       * @param data2             the second data byte
!      * @throws          <code>InvalidMidiDataException</code> if the
       * status byte or all data bytes belonging to the message, do
       * not specify a valid MIDI message
       *
       * @see #setMessage(int, int, int)
       * @see #setMessage(int)
--- 355,365 ----
       *
       * @param command   the MIDI command represented by this message
       * @param channel   the channel associated with the message
       * @param data1             the first data byte
       * @param data2             the second data byte
!      * @throws          InvalidMidiDataException if the
       * status byte or all data bytes belonging to the message, do
       * not specify a valid MIDI message
       *
       * @see #setMessage(int, int, int)
       * @see #setMessage(int)
*** 395,404 ****
--- 395,405 ----
  
      /**
       * Obtains the MIDI command associated with this event.  This method
       * assumes that the event is a MIDI channel message; if not, the return
       * value will not be meaningful.
+      * @return the MIDI command associated with this event
       * @see #setMessage(int, int, int, int)
       */
      public int getCommand() {
          // this returns 0 if an invalid message is set
          return (getStatus() & 0xF0);
*** 448,458 ****
      /**
       * Retrieves the number of data bytes associated with a particular
       * status byte value.
       * @param status status byte value, which must represent a short MIDI message
       * @return data length in bytes (0, 1, or 2)
!      * @throws <code>InvalidMidiDataException</code> if the
       * <code>status</code> argument does not represent the status byte for any
       * short message
       */
      protected final int getDataLength(int status) throws InvalidMidiDataException {
          // system common and system real-time messages
--- 449,459 ----
      /**
       * Retrieves the number of data bytes associated with a particular
       * status byte value.
       * @param status status byte value, which must represent a short MIDI message
       * @return data length in bytes (0, 1, or 2)
!      * @throws InvalidMidiDataException if the
       * <code>status</code> argument does not represent the status byte for any
       * short message
       */
      protected final int getDataLength(int status) throws InvalidMidiDataException {
          // system common and system real-time messages