From fbe30a73b98ebc73ecda1ead2053b289781927f0 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Thu, 24 Dec 2020 17:25:11 -0800
Subject: [PATCH] ;doc: mention version in all manual formats

---
 Shake.hs                      | 10 ++++++----
 hledger-ui/hledger-ui.m4.md   |  3 ++-
 hledger-web/hledger-web.m4.md |  3 ++-
 hledger/hledger.m4.md         |  5 +++--
 4 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/Shake.hs b/Shake.hs
index b39dcd855..2b6c814d0 100755
--- a/Shake.hs
+++ b/Shake.hs
@@ -440,12 +440,13 @@ main = do
             commandsm4 = "hledger/Hledger/Cli/Commands/commands.m4"
             dir       = takeDirectory out
             packagemanversionm4 = dir </> ".version.m4"
+            packagemandatem4 = dir </> ".date.m4"
         -- assume any other .m4.md files in dir are included by this one XXX not true in hledger-lib
         subfiles <- liftIO $ filter (/= src) . filter (".m4.md" `isSuffixOf`) . map (dir </>) <$> S.getDirectoryContents dir
-        need $ [src, commonm4, commandsm4, packagemanversionm4] ++ subfiles
+        need $ [src, commonm4, commandsm4, packagemanversionm4, packagemandatem4] ++ subfiles
         when (dir=="hledger") $ need commandmds
         cmd Shell
-          m4 "-DINFO -I" dir commonm4 commandsm4 packagemanversionm4 src "|"
+          m4 "-DINFO -I" dir commonm4 commandsm4 packagemanversionm4 packagemandatem4 src "|"
           -- sed "-e 's/^#(#+)/\\1/'" "|"
           pandoc fromsrcmd
           "--lua-filter tools/pandoc-drop-html-blocks.lua"
@@ -472,13 +473,14 @@ main = do
             commonm4  = "doc/common.m4"
             commandsm4 = "hledger/Hledger/Cli/Commands/commands.m4"
             packageversionm4 = dir </> ".version.m4"
+            packagemandatem4 = dir </> ".date.m4"
             heading   = let h = manual
                         in if "hledger_" `isPrefixOf` h
                            then drop 8 h ++ " format"
                            else h
         -- assume any other .m4.md files in dir are included by this one XXX not true in hledger-lib
         subfiles <- liftIO $ filter (/= src) . filter (".m4.md" `isSuffixOf`) . map (dir </>) <$> S.getDirectoryContents dir
-        let deps = [src, commonm4, commandsm4, packageversionm4] ++ subfiles
+        let deps = [src, commonm4, commandsm4, packageversionm4, packagemandatem4] ++ subfiles
         need deps
         when (manual=="hledger") $ need commandmds
         -- add the web page's heading.
@@ -492,7 +494,7 @@ main = do
           ,""
           ]
         cmd Shell
-          m4 "-DWEB -I" dir commonm4 commandsm4 packageversionm4 src "|"
+          m4 "-DWEB -I" dir commonm4 commandsm4 packageversionm4 packagemandatem4 src "|"
           pandoc fromsrcmd towebmd
           "--lua-filter tools/pandoc-demote-headers.lua"
           ">>" out
diff --git a/hledger-ui/hledger-ui.m4.md b/hledger-ui/hledger-ui.m4.md
index 4233a44e6..b7d69644e 100644
--- a/hledger-ui/hledger-ui.m4.md
+++ b/hledger-ui/hledger-ui.m4.md
@@ -6,7 +6,8 @@ _man_({{
 # NAME
 }})
 
-A terminal interface (TUI) for the hledger accounting tool.
+hledger-ui is a terminal interface (TUI) for the hledger accounting tool.
+This manual is for hledger-ui _version_.
 
 _man_({{
 # SYNOPSIS
diff --git a/hledger-web/hledger-web.m4.md b/hledger-web/hledger-web.m4.md
index 4a8de90cb..fa4328549 100644
--- a/hledger-web/hledger-web.m4.md
+++ b/hledger-web/hledger-web.m4.md
@@ -6,7 +6,8 @@ _man_({{
 # NAME
 }})
 
-A web interface (WUI) for the hledger accounting tool.
+hledger-web is a web interface (WUI) for the hledger accounting tool.
+This manual is for hledger-web _version_.
 
 _man_({{
 # SYNOPSIS
diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md
index 38ebad5b1..898dceaee 100644
--- a/hledger/hledger.m4.md
+++ b/hledger/hledger.m4.md
@@ -12,12 +12,13 @@ m4_dnl  In Emacs:
 m4_dnl   markdown-mode S-TAB cycles visibility, TAB toggles one section.
 m4_dnl   C-x n s on a heading narrows to that section (C-x n w to widen again).
 
-m4_dnl Show these first headings only in man pages:
 _man_({{
 # NAME
 }})
 
-A command-line accounting tool for both power users and folks new to accounting.
+
+hledger is a command-line accounting tool for both power users and folks new to accounting.
+This manual is for hledger _version_.
 
 _man_({{
 # SYNOPSIS