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

manual: give default year directive its own section

Browse Source
This commit is contained in:
Simon Michael 2015-04-28 13:49:27 -07:00
parent a110c84712
commit 4d4a6b1660
1 changed files with 25 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
doc/manual.md
View File

@ -152,23 +152,14 @@ The posting amounts within a transaction must always balance, ie add up to
##### Simple dates ##### Simple dates
Within a journal file, transaction dates always follow a year/month/day Within a journal (or timelog) file, dates are written as YYYY/MM/DD (year/month/day).
format, although several different separator characters are accepted. Some Hyphen (-) and period (.) are also allowed as separators.
examples: `2010/01/31`, `2010/1/31`, `2010-1-31`, `2010.1.31`. Leading zeroes are optional.
The year may be omitted, in which case it defaults to the current
year, or you can set the default year with a
[default year directive](#default-year).
Writing the year is optional if you set a default year with a Y directive. Some examples: `2010/01/31`, `1/31`, `2010-01-31`, `2010.1.31`.
This is a line containing `Y` and the year; it affects subsequent
transactions, like so:
Y2009
12/15 ; equivalent to 2009/12/15
...
Y2010
1/31 ; equivalent to 2010/1/31
...
##### Secondary dates ##### Secondary dates
@ -579,6 +570,24 @@ Included files are also affected, eg:
include personal.journal include personal.journal
end end
##### Default year
You can set a default year, to be used for all subsequent
[simple dates](#simple-dates) which don't specify a year.
This is a line beginning with `Y` followed by the year, like so:
Y2009
12/15 ; equivalent to 2009/12/15
...
Y2010
1/31 ; equivalent to 2010/1/31
...
This directive can also be used in [timelog files](#timelog).
##### Including other files ##### Including other files
You can pull in the content of additional journal files, by writing lines like this: You can pull in the content of additional journal files, by writing lines like this: