hledger-*: update pages (#12860)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

pages/common/hledger-accounts.md

@@ -23,9 +23,9 @@
 
 `hledger accounts asset --types`
 
-- Show accounts of the Asset type:
+- Show accounts of the `Asset` type:
 
-`hledger accounts type:a`
+`hledger accounts type:A`
 
 - Show the first two levels of the accounts hierarchy:
 

pages/common/hledger-aregister.md

@@ -1,6 +1,6 @@
 # hledger aregister
 
-> Show the transactions and running balances in one account.
+> Show the transactions and running balances in one account, with each transaction on one line.
 > More information: <https://hledger.org/hledger.html#aregister>.
 
 - Show transactions and running balance in the `assets:bank:checking` account:

pages/common/hledger-balance.md

@@ -16,7 +16,7 @@
 
 `hledger balance {{expenses}} --monthly --row-total --average --sort-amount --budget`
 
-- Similar to the above, shorter form, matching accounts by Expense type and summarising to two levels, without compression:
+- Similar to the above, shorter form, matching accounts by `Expense` type, as a two level tree without squashing boring accounts:
 
 `hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide`
 
@@ -28,10 +28,10 @@
 
 `hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}`
 
-- Show investment assets' market value in home currency at the end of each quarter:
+- Show investment assets' market value in base currency at the end of each quarter:
 
 `hledger bal -HVQ {{assets:investments}}`
 
-- Show unrealised capital gain/loss from market price changes each quarter, in non-cryptocurrency investment assets:
+- Show unrealised capital gains/losses from market price changes in each quarter, for non-cryptocurrency investment assets:
 
 `hledger bal --gain -Q {{assets:investments}} not:{{cryptocurrency}}`

pages/common/hledger-balancesheet.md

@@ -1,15 +1,16 @@
 # hledger balancesheet
 
 > Show the end balances in asset and liability accounts.
+> Amounts are shown with normal positive sign, as in conventional financial statements.
 > More information: <https://hledger.org/hledger.html#balancesheet>.
 
-- Show the current balances in Asset and Liability accounts, excluding zeros:
+- Show the current balances in `Asset` and `Liability` accounts, excluding zeros:
 
 `hledger balancesheet`
 
-- Show just the liquid assets (Cash account type):
+- Show just the liquid assets (`Cash` account type):
 
-`hledger balancesheet type:c`
+`hledger balancesheet type:C`
 
 - Include accounts with zero balances, and show the account hierarchy:
 

pages/common/hledger-incomestatement.md

@@ -1,9 +1,10 @@
 # hledger incomestatement
 
 > Show revenue inflows and expense outflows during the report period.
+> Amounts are shown with normal positive sign, as in conventional financial statements.
 > More information: <https://hledger.org/hledger.html#incomestatement>.
 
-- Show revenues and expenses (changes in Revenue and Expense accounts):
+- Show revenues and expenses (changes in `Revenue` and `Expense` accounts):
 
 `hledger incomestatement`
 

pages/common/hledger-ui.md

@@ -1,7 +1,6 @@
 # hledger-ui
 
-> Terminal UI (TUI) to `hledger`.
+> A terminal interface (TUI) for `hledger`, a robust, friendly plain text accounting app.
-> A robust, friendly plain text accounting app.
 > More information: <https://hledger.org/hledger-ui.html>.
 
 - Start in the main menu screen, reading from the default journal file:

pages/common/hledger-web.md

@@ -1,7 +1,6 @@
 # hledger-web
 
-> Web interface and API to `hledger`.
+> A web interface and API for `hledger`, a robust, friendly plain text accounting app.
-> A robust, friendly plain text accounting app.
 > More information: <https://hledger.org/hledger-web.html>.
 
 - Start the web app, and a browser if possible, for local viewing and adding only: