slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

;fix:close:doc:customisation: edit [#2492]

Browse Source
This commit is contained in:
Simon Michael 2025-11-01 10:37:41 -10:00
parent a50d02ca04
commit de822ae813
1 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
hledger/Hledger/Cli/Commands/Close.md
View File

@ -37,8 +37,15 @@ Flags:
(can unbalance transactions) (can unbalance transactions)
``` ```
`close` has six modes, selected by choosing one of the mode flags (`--close` is the default). `close` has six modes, selected by choosing one of the mode flags:
They all do much the same operation, but with different defaults, useful in different situations. `--clopen`, `--close` (default), `--open`, `--assert`, `--assign`, or `--retain`.
They are all doing the same kind of operation, but with different defaults for different situations.
The journal entries generated by `close` will have a `clopen:` tag, which is helpful when you want to exclude them from reports.
If the main journal file name contains a number, the tag's value will be that base file name with the number incremented.
Eg if the journal file is 2025.journal, the tag will be `clopen:2026`.
Or you can set the tag value by providing an argument to the mode flag.
Eg `--close=foo` or `--clopen=2025-main`.
### close --clopen ### close --clopen
@ -73,11 +80,6 @@ but not the RX accounts (Revenue, Expense).
Assertions will be added indicating and checking the new balances of the closed/opened accounts. Assertions will be added indicating and checking the new balances of the closed/opened accounts.
The generated transactions will have a `clopen:` tag.
If the main journal's base file name contains a number (eg a year number),
the tag's value will be that base file name with the number incremented.
Or you can choose the tag value yourself, by using `--clopen=TAGVAL`.
### close --close ### close --close
This prints just the closing balances transaction of `--clopen`. This prints just the closing balances transaction of `--clopen`.
@ -130,8 +132,7 @@ In all modes, the following things can be overridden:
- the closing/opening dates, with `-e OPENDATE` - the closing/opening dates, with `-e OPENDATE`
- the balancing account, with `--close-acct=ACCT` and/or `--open-acct=ACCT` - the balancing account, with `--close-acct=ACCT` and/or `--open-acct=ACCT`
- the transaction descriptions, with `--close-desc=DESC` and `--open-desc=DESC` - the transaction descriptions, with `--close-desc=DESC` and `--open-desc=DESC`
- the value of the transaction's `clopen` tag, with an argument for the mode flag.\ - the transactions' `clopen` tag value, with a `TAGVAL` argument for the mode flag (see above).
(Eg: `--close=foo` or `--clopen=2025-main`)
By default, the closing date is yesterday, or the journal's end date, whichever is later; By default, the closing date is yesterday, or the journal's end date, whichever is later;
and the opening date is always one day after the closing date. and the opening date is always one day after the closing date.