;doc: edit

This commit is contained in:
Simon Michael 2024-06-01 09:46:14 -10:00
parent 84d788b2df
commit 6716e3a503

View File

@ -2728,16 +2728,16 @@ A missing Y directive makes reports dependent on today's date.
### Secondary dates ### Secondary dates
A secondary date is written after the primary date, following an A secondary date is written after the primary date, following an equals sign: `DATE1=DATE2`.
equals sign. If the year is omitted, the primary date's year is If the year is omitted, the primary date's year is assumed.
assumed. When running reports, the primary (left) date is used by When running reports, the primary (left side) date is used by default,
default, but with the `--date2` flag (`--aux-date` or`--effective` also work, for Ledger users), 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 side) date will be used instead.
The meaning of secondary dates is up to you. The meaning of secondary dates is up to you. Eg it could be
Eg it could be "primary = the bank's clearing date, secondary = date the transaction was initiated, if different". "primary is the bank's clearing date, secondary is the date the transaction was initiated, if different".
In fact this feature usually adds confusion: In practice, this feature usually adds confusion:
- You have to remember the primary and secondary dates' meaning, and follow that consistently. - You have to remember the primary and secondary dates' meaning, and follow that consistently.
- It splits your bookkeeping into two modes, and you have to remember which mode is appropriate for a given report. - It splits your bookkeeping into two modes, and you have to remember which mode is appropriate for a given report.
@ -2748,7 +2748,7 @@ In fact this feature usually adds confusion:
- [Posting dates](#posting-dates) are simpler and work better. - [Posting dates](#posting-dates) are simpler and work better.
So secondary dates are officially deprecated in hledger, So secondary dates are officially deprecated in hledger,
remaining only as a Ledger compatibility feature; remaining only as a Ledger compatibility aid;
we recommend using posting dates instead. we recommend using posting dates instead.
### Star comments ### Star comments