[DOC-PR#1539] Revised documentation

I've made changes to alleviate ambiguity around "commands" and "subcommands" in the context of aliases
remkop · Jan 3, 2022 · 2043891 · 2043891
1 parent 77a3d43
commit 2043891
Show file tree

Hide file tree

Showing 3 changed files with 3 additions and 3 deletions.
diff --git a/docs/index.adoc b/docs/index.adoc
@@ -8060,7 +8060,7 @@ class ListFiles : Runnable {
 ----
 
 === Subcommand Aliases
-Commands may optionally define an `aliases` attribute to provide alternate names for subcommands that will be recognized by the parser. Aliases are displayed in the default help output. For example:
+Commands may optionally define an `aliases` attribute to provide alternate names that will be recognized by the parser. Aliases are displayed in the default help output. For example:
 
 .Java
 [source,java,role="primary"]

diff --git a/docs/index.html b/docs/index.html
@@ -12344,7 +12344,7 @@ <h3 id="parentcommand-annotation"><a class="anchor" href="#parentcommand-annotat
 <div class="sect2">
 <h3 id="_subcommand_aliases"><a class="anchor" href="#_subcommand_aliases"></a>17.8. Subcommand Aliases</h3>
 <div class="paragraph">
-<p>Commands may optionally define an <code>aliases</code> attribute to provide alternate names for subcommands that will be recognized by the parser. Aliases are displayed in the default help output. For example:</p>
+<p>Commands may optionally define an <code>aliases</code> attribute to provide alternate names that will be recognized by the parser. Aliases are displayed in the default help output. For example:</p>
 </div>
 <div class="listingblock primary">
 <div class="title">Java</div>

diff --git a/docs/man/3.x/index.html b/docs/man/3.x/index.html
@@ -3815,7 +3815,7 @@ <h3 id="_registering_subcommands_declaratively">13.2. Registering Subcommands De
 <div class="sect2">
 <h3 id="_subcommand_aliases">13.3. Subcommand Aliases</h3>
 <div class="paragraph">
-<p>Commands may optionally define an <code>aliases</code> attribute to provide alternate names for subcommands that will be recognized by the parser. Aliases are displayed in the default help output. For example:</p>
+<p>Commands may optionally define an <code>aliases</code> attribute to provide alternate names that will be recognized by the parser. Aliases are displayed in the default help output. For example:</p>
 </div>
 <div class="listingblock">
 <div class="content">