Update Javadoc

Make it more clear that no output will be produced by default in low level APIs
This commit is contained in:
topjohnwu 2019-02-15 13:00:00 -05:00
parent dba1f2ef76
commit 548c4e4e11

View File

@ -376,7 +376,11 @@ public abstract class Shell implements Closeable {
public abstract void execTask(@NonNull Task task) throws IOException;
/**
* Construct a new {@link Job} that will use the shell.
* Construct a new {@link Job} that will use the shell for execution.
* <p>
* Be aware that unlike {@code Shell.su(...)/Shell.sh(...)}, <strong>NO</strong> output will
* be produced if the developer did not set the output destination with {@link Job#to(List)}
* or {@link Job#to(List, List)}.
* @return a job that the developer can execute or submit later.
*/
public abstract Job newJob();