Reference CommandRunner from addCommand docs (#139)
Closes #134
The `addCommand` API is a little confusing, it doesn't impact the usage
string the way you might expect.
In the future we might consider hiding this API, for now call out the
confusing aspect and point to the API that most folks should use.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6543f24..cf18c3f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,9 @@
-## 1.5.3-dev
+## 1.5.4-dev
+
+* Point towards `CommandRunner` in the docs for `ArgParser.addCommand` since it
+ is what most authors will want to use instead.
+
+## 1.5.3
* Improve arg parsing performance: use queues instead of lists internally to
get linear instead of quadratic performance, which is important for large
diff --git a/lib/src/arg_parser.dart b/lib/src/arg_parser.dart
index 2ec5f62..aae89d6 100644
--- a/lib/src/arg_parser.dart
+++ b/lib/src/arg_parser.dart
@@ -82,6 +82,9 @@
/// A command is a named argument which may in turn define its own options and
/// subcommands using the given parser. If [parser] is omitted, implicitly
/// creates a new one. Returns the parser for the command.
+ ///
+ /// Note that adding commands this way will not impact the [usage] string. To
+ /// add commands which are included in the usage string see `CommandRunner`.
ArgParser addCommand(String name, [ArgParser parser]) {
// Make sure the name isn't in use.
if (_commands.containsKey(name)) {
diff --git a/pubspec.yaml b/pubspec.yaml
index 3d71214..6ebe018 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,5 +1,5 @@
name: args
-version: 1.5.3
+version: 1.5.4-dev
homepage: https://github.com/dart-lang/args
description: >-
Library for defining parsers for parsing raw command-line arguments into a set
