mirror of
https://github.com/simonmichael/hledger.git
synced 2024-11-07 21:15:19 +03:00
;doc: reorganise the commands list in manual to match cli, improve links
This commit is contained in:
Simon Michael
parent
9fb210da8c
commit
b7219f8935
@ -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)
|
||||
|
||||
@ -6012,47 +6012,33 @@ First, a quick glossary:
|
||||
|
||||
# PART 4: COMMANDS
|
||||
|
||||
## Commands overview
|
||||
|
||||
Here are the built-in [commands](#commands):
|
||||
<a name="commands-overview">
|
||||
<a name="addons"></a><a name="add-ons"></a> <!-- see also #add-on-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.
|
||||
|
||||
<!-- keep commands & descriptions synced with Hledger.Cli.Commands.commandsList, commands.m4 -->
|
||||
|
||||
### 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
|
||||
|
||||
<a name="addons"></a>
|
||||
<!-- #addons: the short explanation and list of common add-on commands. See also #add-on-commands. -->
|
||||
|
||||
### 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})
|
||||
|
||||
Loading…
Reference in New Issue
Block a user