Add note about swift-doc vs. swift doc usage

Resolves #85
SwiftDocOrg · Apr 20, 2020 · d4eb762 · d4eb762
1 parent 5da4946
commit d4eb762
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -57,6 +57,12 @@ $ make install
                               files
       diagram                 Generates diagram of Swift symbol relationships
 
+> **Note**:
+> The `swift` driver provides extensibility through subcommands.
+> If you type an unknown subcommand like `swift foo`,
+> the system looks for a command called `swift-foo` in your `PATH`.
+> This mechanism allows `swift-doc` to be run either directly or as `swift doc`.
+
 #### swift-doc generate
 
     OVERVIEW: Generates Swift documentation