docs: actual/effective, just can't leave it alone
This commit is contained in:
parent
69fb3ab9e2
commit
bd17d37dee
20
MANUAL.md
20
MANUAL.md
@ -287,18 +287,12 @@ charged to your bank account on monday. Or you write a cheque to someone
|
|||||||
and they deposit it weeks later.
|
and they deposit it weeks later.
|
||||||
|
|
||||||
When you don't care about this, just pick one date for your journal
|
When you don't care about this, just pick one date for your journal
|
||||||
transaction; either will do. This means your hledger reports can be
|
transaction; either will do. But when you want to model reality more
|
||||||
slightly out of step with reality (eg your daily bank balance.)
|
accurately (eg: to match your daily bank balance), write both dates,
|
||||||
|
separated by an equals sign. Following ledger's convention, the *actual
|
||||||
When you need to model reality more accurately, you can write both dates,
|
date* (or "bank date") goes on the left, and is used by default, the
|
||||||
separated by an equals sign. By default, the first date is used in
|
*effective date* (or "your date") goes on the right, and is used when the
|
||||||
reports; to use the second one instead, run hledger with the `--effective`
|
`--effective` flag is provided. Here are some mnemonics to prevent confusion:
|
||||||
flag.
|
|
||||||
|
|
||||||
About the terminology: we follow c++ ledger's usage, calling these the
|
|
||||||
*actual date* (on the left) and the *effective date* (on the right).
|
|
||||||
hledger doesn't actually care what these terms mean, but here are some
|
|
||||||
mnemonics to keep our usage consistent and prevent confusion:
|
|
||||||
|
|
||||||
- ACTUAL=EFFECTIVE. The actual date is (by definition) the one on the left. A before E.
|
- ACTUAL=EFFECTIVE. The actual date is (by definition) the one on the left. A before E.
|
||||||
- BANKDATE=MYDATE. You can usually think "actual is bank's, effective is mine".
|
- BANKDATE=MYDATE. You can usually think "actual is bank's, effective is mine".
|
||||||
@ -308,7 +302,7 @@ mnemonics to keep our usage consistent and prevent confusion:
|
|||||||
Example:
|
Example:
|
||||||
|
|
||||||
; ACTUAL=EFFECTIVE
|
; ACTUAL=EFFECTIVE
|
||||||
; The latter's year can be omitted, it will be taken from the former
|
; The effective date's year is optional, defaulting to the actual date's
|
||||||
2010/2/23=2/19 movie ticket
|
2010/2/23=2/19 movie ticket
|
||||||
expenses:cinema $10
|
expenses:cinema $10
|
||||||
assets:checking
|
assets:checking
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user