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