diff --git a/hledger-ui/hledger-ui.m4.md b/hledger-ui/hledger-ui.m4.md
index 4898f8ec1..c37ff83e1 100644
--- a/hledger-ui/hledger-ui.m4.md
+++ b/hledger-ui/hledger-ui.m4.md
@@ -12,8 +12,8 @@ _notinfo_({{
 # SYNOPSIS
 }})
 
-`hledger-ui [OPTIONS] [QUERYARGS]`\
-`hledger ui -- [OPTIONS] [QUERYARGS]`
+`hledger-ui    [OPTS] [QUERYARGS]    # run directly`\
+`hledger ui -- [OPTS] [QUERYARGS]    # run from hledger`\
 
 _notinfo_({{
 # DESCRIPTION
diff --git a/hledger-web/hledger-web.m4.md b/hledger-web/hledger-web.m4.md
index 23a3a2e25..cc82773b9 100644
--- a/hledger-web/hledger-web.m4.md
+++ b/hledger-web/hledger-web.m4.md
@@ -12,10 +12,10 @@ _notinfo_({{
 # SYNOPSIS
 }})
 
-`hledger-web [OPTIONS]                  # run temporarily & browse`\
-`hledger-web --serve [OPTIONS]          # run without stopping`\
-`hledger-web --serve-api [OPTIONS]      # run JSON server only`\
-`hledger web -- [OPTIONS] [QUERYARGS]`  # start from hledger
+`hledger-web             [OPTS] [ARGS]    # run temporarily & open browser`\
+`hledger-web --serve     [OPTS] [ARGS]    # run without stopping`\
+`hledger-web --serve-api [OPTS] [ARGS]    # run HTTP JSON server only`\
+`hledger web --          [OPTS] [ARGS]    # run from hledger`\
 
 _notinfo_({{
 # DESCRIPTION
diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md
index f44ac4a9a..a250d01b0 100644
--- a/hledger/hledger.m4.md
+++ b/hledger/hledger.m4.md
@@ -29,12 +29,12 @@ _notinfo_({{
 # SYNOPSIS
 }})
 
-`hledger`\
-`hledger [-f FILE] COMMAND [OPTS] [ARGS]`\
-`hledger [-f FILE] ADDONCMD -- [OPTS] [ARGS]`
+`hledger                              # show commmands list`\
+`hledger COMMAND     [OPTS] [ARGS]    # run built-in command`\
+`hledger ADDONCMD -- [OPTS] [ARGS]    # run add-on command from PATH`\
 
 _notinfo_({{
-# INTRODUCTION
+# DESCRIPTION
 }})
 
 _hledgerdescription_