diff --git a/hledger/Hledger/Cli/Commands/commands.m4 b/hledger/Hledger/Cli/Commands/commands.m4 index 90105c4dd..fce27fdbd 100644 --- a/hledger/Hledger/Cli/Commands/commands.m4 +++ b/hledger/Hledger/Cli/Commands/commands.m4 @@ -1,37 +1,69 @@ m4_dnl _commands_ m4_dnl Used in the hledger manual to include all command docs. -m4_dnl Keep synced with Hledger.Cli.Commands.commandsList, hledger.m4.md +m4_dnl Keep synced with Hledger.Cli.Commands.commandsList, hledger.m4.md. +m4_dnl The spaced colons avoid anchor/link collisions with similarly-named sections. m4_define({{_commands_}}, {{ -_command_({{Accounts}}) -_command_({{Activity}}) +## HELP : + +_command_({{Help}}) +_command_({{Demo}}) + +## USER INTERFACES : + +Alternate user interfaces like +[hledger-ui](hledger-ui.md) and +[hledger-web](hledger-web.md) +appear in this section of the : list when installed. + +## ENTERING DATA : + _command_({{Add}}) -_command_({{Aregister}}) -_command_({{Balance}}) -_command_({{Balancesheet}}) -_command_({{Balancesheetequity}}) -_command_({{Cashflow}}) -_command_({{Check}}) -_command_({{Close}}) +_command_({{Import}}) + +## BASIC REPORTS : + +_command_({{Accounts}}) _command_({{Codes}}) _command_({{Commodities}}) -_command_({{Demo}}) _command_({{Descriptions}}) -_command_({{Diff}}) _command_({{Files}}) -_command_({{Help}}) -_command_({{Import}}) -_command_({{Incomestatement}}) _command_({{Notes}}) _command_({{Payees}}) _command_({{Prices}}) -_command_({{Print}}) -_command_({{Register}}) -_command_({{Rewrite}}) -_command_({{Roi}}) _command_({{Stats}}) _command_({{Tags}}) + +## STANDARD REPORTS : + +_command_({{Print}}) +_command_({{Aregister}}) +_command_({{Register}}) +_command_({{Balancesheet}}) +_command_({{Balancesheetequity}}) +_command_({{Cashflow}}) +_command_({{Incomestatement}}) + +## ADVANCED REPORTS : + +_command_({{Balance}}) +_command_({{Roi}}) + +## CHARTS : + +_command_({{Activity}}) + +## GENERATING DATA : + +_command_({{Close}}) +_command_({{Rewrite}}) + +## MAINTENANCE : + +_command_({{Check}}) +_command_({{Diff}}) _command_({{Test}}) + }})m4_dnl m4_dnl m4_dnl _command_(MDFILE) diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md index 1b8768d3d..0af0897cc 100644 --- a/hledger/hledger.m4.md +++ b/hledger/hledger.m4.md @@ -6012,47 +6012,33 @@ First, a quick glossary: # PART 4: COMMANDS -## Commands overview -Here are the built-in [commands](#commands): + + + +Here are the standard [commands](#commands), which you can list by running `hledger`. +If you have installed more [add-on commands](../scripts.md), they also will be listed. + -### DATA ENTRY +**[HELP](#help-)** + +- [help](#help) - show the hledger manual with info/man/pager +- [demo](#demo) - show small hledger demos in the terminal + +**[USER INTERFACES](#user-interfaces-)** + +- [ui](hledger-ui.html) - (if installed) run hledger's terminal UI +- [web](hledger-web.html) - (if installed) run hledger's web UI + +**[ENTERING DATA](#entering-data-)** -These data entry commands are the only ones which can modify your journal file. - - [add](#add) - add transactions using terminal prompts - [import](#import) - add new transactions from other files, eg CSV files -### DATA CREATION - -- [close](#close) - generate balance-zeroing/restoring transactions -- [rewrite](#rewrite) - generate auto postings, like print --auto - -### DATA MANAGEMENT - -- [check](#check) - check for various kinds of error in the data -- [diff](#diff) - compare account transactions in two journal files - -### REPORTS, FINANCIAL - -- [aregister](#aregister) (areg) - show transactions in a particular account -- [balancesheet](#balancesheet) (bs) - show assets, liabilities and net worth -- [balancesheetequity](#balancesheetequity) (bse) - show assets, liabilities and equity -- [cashflow](#cashflow) (cf) - show changes in liquid assets -- [incomestatement](#incomestatement) (is) - show revenues and expenses - -### REPORTS, VERSATILE - -- [balance](#balance) (bal) - show balance changes, end balances, budgets, gains.. -- [print](#print) - show transactions or export journal data -- [register](#register) (reg) - show postings in one or more accounts & running total -- [roi](#roi) - show return on investments - -### REPORTS, BASIC +**[BASIC REPORTS](#basic-reports-)** - [accounts](#accounts) - show account names -- [activity](#activity) - show bar charts of posting counts per period - [codes](#codes) - show transaction codes - [commodities](#commodity-directive) - show commodity/currency symbols - [descriptions](#descriptions) - show transaction descriptions @@ -6062,28 +6048,37 @@ These data entry commands are the only ones which can modify your journal file. - [prices](#prices) - show market prices - [stats](#stats) - show journal statistics - [tags](#tags-1) - show tag names + +**[STANDARD REPORTS](#standard-reports-)** + +- [print](#print) - show transactions or export journal data +- [aregister](#aregister) (areg) - show transactions in a particular account +- [register](#register) (reg) - show postings in one or more accounts & running total +- [balancesheet](#balancesheet) (bs) - show assets, liabilities and net worth +- [balancesheetequity](#balancesheetequity) (bse) - show assets, liabilities and equity +- [cashflow](#cashflow) (cf) - show changes in liquid assets +- [incomestatement](#incomestatement) (is) - show revenues and expenses + +**[ADVANCED REPORTS](#advanced-reports-)** + +- [balance](#balance) (bal) - show balance changes, end balances, budgets, gains.. +- [roi](#roi) - show return on investments + +**[CHARTS](#charts-)** + +- [activity](#activity) - show bar charts of posting counts per period + +**[GENERATING DATA](#generating-data-)** + +- [close](#close) - generate balance-zeroing/restoring transactions +- [rewrite](#rewrite) - generate auto postings, like print --auto + +**[MAINTENANCE](#maintenance-)** + +- [check](#check) - check for various kinds of error in the data +- [diff](#diff) - compare account transactions in two journal files - [test](#test) - run self tests -### HELP - -- [help](#help) - show the hledger manual with info/man/pager -- [demo](#demo) - show small hledger demos in the terminal - - - - -### ADD-ONS - -And here are some typical [add-on commands](#add-on-commands). -Some of these are installed by the [hledger-install script](https://hledger.org/install.html#build-methods). -If installed, they will appear in hledger's commands list: - -- [ui](hledger-ui.html) - run hledger's terminal UI -- [web](hledger-web.html) - run hledger's web UI -- [iadd](https://hackage.haskell.org/package/hledger-iadd) - add transactions using a TUI (currently hard to build) -- [interest](https://hackage.haskell.org/package/hledger-interest) - generate interest transactions -- [stockquotes](https://hackage.haskell.org/package/hledger-stockquotes) - download market prices from AlphaVantage -- [Scripts and add-ons](https://hledger.org/scripts.html) - check-fancyassertions, edit, fifo, git, move, pijul, plot, and more.. m4_dnl XXX maybe later m4_dnl _man_({{ @@ -6092,7 +6087,7 @@ m4_dnl or the info or web format of this manual. m4_dnl }}) m4_dnl _notman_({{ -Next, each command is described in detail, in alphabetical order. +Next, these commands are described in detail. m4_dnl Include the command docs. Each starts with a level 2 heading. m4_dnl (To change that, see Hledger/Cli/Commands/{*.md,commands.m4})