Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-6206031

(process spec) minor Process spec improvements

    Details

    • Type: Bug
    • Status: Closed
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 5.0
    • Fix Version/s: 7
    • Component/s: core-libs
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      b17
    • CPU:
      x86
    • OS:
      linux
    • Verification:
      Not verified

      Description

      A DESCRIPTION OF THE PROBLEM :
      Some of the description for Process.getErrorStream() is copyed from Process.getInputStream().

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      Gets the error stream of the subprocess. The stream obtains data piped from the error output stream of the process represented by this Process object.

      Implementation note: It is a good idea for the error stream not to be buffered.
      (or maybe the above line should be removed)
      ACTUAL -
      Gets the error stream of the subprocess. The stream obtains data piped from the error output stream of the process represented by this Process object.

      Implementation note: It is a good idea for the input stream to be buffered.

      URL OF FAULTY DOCUMENTATION :
      http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Process.html#getErrorStream()
      ###@###.### 2004-12-08 22:26:04 GMT

        Activity

        Hide
        martin Martin Buchholz added a comment -
        BT2:EVALUATION

        The documentation is, strictly speaking, correct.
        The point is that the stream returned by getErrorStream is
        of type InputStream, and so we are referring to it as "input stream".

        Now, for the particular case of getErrorStream, the implementation
        note should likely be deleted, since the error stream should preferentially
        be less buffered than the standard out from the process, but that is
        a different tiny bug.

        I intend to close this as Not a Bug.

        ###@###.### 2004-12-09 00:23:55 GMT
        Show
        martin Martin Buchholz added a comment - BT2:EVALUATION The documentation is, strictly speaking, correct. The point is that the stream returned by getErrorStream is of type InputStream, and so we are referring to it as "input stream". Now, for the particular case of getErrorStream, the implementation note should likely be deleted, since the error stream should preferentially be less buffered than the standard out from the process, but that is a different tiny bug. I intend to close this as Not a Bug. ###@###.### 2004-12-09 00:23:55 GMT
        Hide
        martin Martin Buchholz added a comment -
        BT2:EVALUATION

        On second thought, some rewording to clarify which is input and
        which is output is worth doing. Process javadoc could use some modernization
        as well.

        I don't think that replacing "the input stream" with "an input stream"
        is good because getInputStream et al return the same object on each call,
        so the "the" is quite meaningful.
        Show
        martin Martin Buchholz added a comment - BT2:EVALUATION On second thought, some rewording to clarify which is input and which is output is worth doing. Process javadoc could use some modernization as well. I don't think that replacing "the input stream" with "an input stream" is good because getInputStream et al return the same object on each call, so the "the" is quite meaningful.

          People

          • Assignee:
            martin Martin Buchholz
            Reporter:
            rmandalasunw Ranjith Mandala (Inactive)
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:
              Imported:
              Indexed: