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

Too much documentation of ProcessBuilder.start copied to ProcessBuilder.startPipeline

    Details

    • Subcomponent:
    • Resolved In Build:
      b03
    • CPU:
      x86_64
    • OS:
      generic
    • Verification:
      Not verified

      Description

      A DESCRIPTION OF THE PROBLEM :
      Most of the documentation of ProcessBuilder.startPipeline() is copied literally from ProcessBuilder.start(), but some parts need rewording to make sense for the new method.

      "The new process will invoke the command and arguments given by command(), in a working directory as given by directory(), with a process environment as given by environment()."

      "This method checks that the command is a valid operating system command."

      (etc)

      There is no single command, the documentation should reflect more clearly that this logic is applied to each process. (or simply refer to the documentation of start() without repeating its documentation)

      "If there is a security manager, its checkExec method is called with the first component of this object's command array as its argument. This may result in a SecurityException being thrown."

      "Subsequent modifications to this process builder will not affect the returned Process."

      startPipeline() is a static method, there can be no reference to "this".


      URL OF FAULTY DOCUMENTATION :
      https://docs.oracle.com/javase/9/docs/api/java/lang/ProcessBuilder.html#startPipeline-java.util.List-

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                rriggs Roger Riggs
                Reporter:
                webbuggrp Webbug Group
              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: