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

Reviewed-by: bpb, lancea
This commit is contained in:
Roger Riggs 2018-07-18 09:46:03 -04:00
parent 85f79b0dab
commit 7d4da87a14

View file

@ -1157,12 +1157,12 @@ public final class ProcessBuilder
* are forcibly destroyed. * are forcibly destroyed.
* <p> * <p>
* The {@code startPipeline} method performs the same checks on * The {@code startPipeline} method performs the same checks on
* each ProcessBuilder as does the {@link #start} method. The new process * each ProcessBuilder as does the {@link #start} method. Each new process
* will invoke the command and arguments given by {@link #command()}, * invokes the command and arguments given by the respective process builder's
* in a working directory as given by {@link #directory()}, * {@link #command()}, in a working directory as given by its {@link #directory()},
* with a process environment as given by {@link #environment()}. * with a process environment as given by its {@link #environment()}.
* <p> * <p>
* This method checks that the command is a valid operating * Each process builder's command is checked to be a valid operating
* system command. Which commands are valid is system-dependent, * system command. Which commands are valid is system-dependent,
* but at the very least the command must be a non-empty list of * but at the very least the command must be a non-empty list of
* non-null strings. * non-null strings.
@ -1174,7 +1174,7 @@ public final class ProcessBuilder
* <p> * <p>
* If there is a security manager, its * If there is a security manager, its
* {@link SecurityManager#checkExec checkExec} * {@link SecurityManager#checkExec checkExec}
* method is called with the first component of this object's * method is called with the first component of each process builder's
* {@code command} array as its argument. This may result in * {@code command} array as its argument. This may result in
* a {@link SecurityException} being thrown. * a {@link SecurityException} being thrown.
* <p> * <p>
@ -1194,8 +1194,8 @@ public final class ProcessBuilder
* If the operating system does not support the creation of * If the operating system does not support the creation of
* processes, an {@link UnsupportedOperationException} will be thrown. * processes, an {@link UnsupportedOperationException} will be thrown.
* <p> * <p>
* Subsequent modifications to this process builder will not * Subsequent modifications to any of the specified builders
* affect the returned {@link Process}. * will not affect the returned {@link Process}.
* @apiNote * @apiNote
* For example to count the unique imports for all the files in a file hierarchy * For example to count the unique imports for all the files in a file hierarchy
* on a Unix compatible platform: * on a Unix compatible platform: