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-
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-
- csr for
-
JDK-8207403 Clarify the documentation of ProcessBuilder.startPipeline
-
- Closed
-