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

;doc: officially deprecate secondary dates, harder

Browse Source
This commit is contained in:
Simon Michael 2024-06-01 09:31:33 -10:00
parent 6376f459f5
commit 76882319a7
1 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
hledger/hledger.m4.md
View File

@ -2734,16 +2734,19 @@ assumed. When running reports, the primary (left) date is used by
default, but with the `--date2` flag (`--aux-date` or`--effective` also work, for Ledger users), default, but with the `--date2` flag (`--aux-date` or`--effective` also work, for Ledger users),
the secondary (right) date will be used instead. the secondary (right) date will be used instead.
The meaning of secondary dates is up to you, but it's best to follow a The meaning of secondary dates is up to you.
consistent rule. Eg "primary = the bank's clearing date, secondary = Eg it could be "primary = the bank's clearing date, secondary = date the transaction was initiated, if different".
date the transaction was initiated, if different".
In fact this feature usually adds confusion. In fact this feature usually adds confusion:
It splits your reporting into two modes, and you have to remember which mode is appropriate for a given report. - You have to remember the primary and secondary dates' meaning, and follow that consistently.
Usually only one mode will work with your balance assertions. - It splits your bookkeeping into two modes, and you have to remember which mode is appropriate for a given report.
It makes your financial data more complicated, less portable, and less clear in an audit. - Usually your balance assertions will work with only one of these modes.
You should consider it deprecated in hledger, - It makes your financial data more complicated, less portable, and less clear in an audit.
and use [posting dates](#posting-dates) instead; they are simpler and better. - It interacts with every feature, creating an ongoing cost for implementors.
- It distracts new users and supporters.
- [Posting dates](#posting-dates) are simpler and work better.
So as of 2024, secondary dates are officially deprecated in hledger; consider using posting dates instead.
### Star comments ### Star comments