This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-shared-utils.git
The following commit(s) were added to refs/heads/master by this push:
new a14561a Clean up and correct Javadoc (#150)
a14561a is described below
commit a14561aa98f3ac3aa8883153090fea72dc162854
Author: Elliotte Rusty Harold <[email protected]>
AuthorDate: Fri Jun 2 07:24:23 2023 -0400
Clean up and correct Javadoc (#150)
---
.../org/apache/maven/shared/utils/cli/Commandline.java | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
b/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
index 619f5a1..51eae4c 100644
--- a/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
+++ b/src/main/java/org/apache/maven/shared/utils/cli/Commandline.java
@@ -182,9 +182,9 @@ public class Commandline implements Cloneable {
}
/**
- * Add system environment variables.
+ * No-op.
*
- * @deprecated please use {@link #setShellEnvironmentInherited(boolean)}
+ * @deprecated use {@link #setShellEnvironmentInherited(boolean)}
*/
@Deprecated
public void addSystemEnvironment() {}
@@ -246,7 +246,7 @@ public class Commandline implements Cloneable {
}
/**
- * @param mask flag to mask any arguments (having his {@code mask} field
to {@code true})
+ * @param mask replace any arguments whose {@code mask} field is {@code
true} with asterisks
* @return the shell, executable and all defined arguments with masking
some arguments if
* {@code mask} parameter is on
*/
@@ -268,7 +268,7 @@ public class Commandline implements Cloneable {
* Returns all arguments defined by <code>addLine</code>,
* <code>addValue</code>, or the argument object.
*
- * @param mask flag to mask any arguments (having his {@code mask} field
to {@code true})
+ * @param mask replace any arguments whose {@code mask} field is {@code
true} with asterisks
* @return an array of arguments
*/
public String[] getArguments(boolean mask) {
@@ -300,13 +300,13 @@ public class Commandline implements Cloneable {
return StringUtils.join(getShellCommandline(true), " ");
}
- /** {@inheritDoc}
+ /**
+ * Do not call. Always throws an UnsupportedOperationException.
+ *
+ * @throws UnsupportedOperationException
*/
public Object clone() {
- throw new RuntimeException("Do we ever clone a commandline?");
- /* Commandline c = new Commandline( (Shell) shell.clone() );
- c.addArguments( getArguments() );
- return c;*/
+ throw new UnsupportedOperationException("Do we ever clone a
commandline?");
}
/**
