python · hugovk · Aug 27, 2026 · Jul 24, 2026 · Jul 24, 2026 · Aug 25, 2026
diff --git a/README.md b/README.md
@@ -62,14 +62,6 @@ managers.
 
 
 
-### blurb help
-
-**blurb** is self-documenting through the `blurb help` subcommand.
-Run without any further arguments, it prints a list of all subcommands,
-with a one-line summary of the functionality of each.  Run with a
-third argument, it prints help on that subcommand (e.g. `blurb help release`).
-
-
 ### blurb add
 
 `blurb add` adds a new `Misc/NEWS` entry for you.
@@ -223,6 +215,12 @@ the right thing.  If `NEWS` entries were already written to the
 final version directory, you'd have to move those around as
 part of the cherry-picking process.
 
+## Getting help
+
+Run `blurb --help` for a list of subcommands,
+and `blurb <subcommand> --help` for help on a specific subcommand.
+
+
 ## Copyright
 
 **blurb** is Copyright 2015-2018 by Larry Hastings.

diff --git a/RELEASING.md b/RELEASING.md
@@ -25,5 +25,5 @@
 - [ ] Check installation:
 
   ```bash
-  python -m pip uninstall -y blurb && python -m pip install -U blurb && blurb help
+  python -m pip uninstall -y blurb && python -m pip install -U blurb && blurb --help
   ```
diff --git a/src/blurb/_add.py b/src/blurb/_add.py
@@ -24,15 +24,15 @@
 
 
 def add(*, issue: str | None = None, section: str | None = None):
-    """Add a blurb (a Misc/NEWS.d/next entry) to the current CPython repo.
+    """Add a blurb (a `Misc/NEWS.d/next` entry) to the current CPython repo.
 
-    Use -i/--issue to specify a GitHub issue number or link, e.g.:
+    Use `-i`/`--issue` to specify a GitHub issue number or link, e.g.:
 
         blurb add -i 12345
         # or
         blurb add -i https://github.com/python/cpython/issues/12345
 
-    Use -s/--section to specify the section name (case-insensitive), e.g.:
+    Use `-s`/`--section` to specify the section name (case-insensitive), e.g.:
 
         blurb add -s Library
         # or
@@ -73,7 +73,7 @@ def add(*, issue: str | None = None, section: str | None = None):
     print('Ready for commit.')
 
 
-add.__doc__ = add.__doc__.format(sections='\n'.join(f'* {s}' for s in sections))
+add.__doc__ = add.__doc__.format(sections='\n'.join(f'    * {s}' for s in sections))
 
 
 def _editor_args() -> list[str]: