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

;doc: update manuals

Browse Source
This commit is contained in:
Simon Michael 2021-12-09 14:03:58 -10:00
parent 43d935efda
commit e532b7be49
9 changed files with 1819 additions and 1620 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
hledger-ui/hledger-ui.1
View File

@ -521,19 +521,29 @@ Default: the full terminal width.
.PP .PP
\f[B]LEDGER_FILE\f[R] The journal file path when not specified with \f[B]LEDGER_FILE\f[R] The journal file path when not specified with
\f[C]-f\f[R]. \f[C]-f\f[R].
Default: \f[C]\[ti]/.hledger.journal\f[R] (on windows, perhaps
\f[C]C:/Users/USER/.hledger.journal\f[R]).
.PP .PP
A typical value is \f[C]\[ti]/DIR/YYYY.journal\f[R], where DIR is a On unix computers, the default value is:
\f[C]\[ti]/.hledger.journal\f[R].
.PP
A more typical value is something like
\f[C]\[ti]/finance/YYYY.journal\f[R], where \f[C]\[ti]/finance\f[R] is a
version-controlled finance directory and YYYY is the current year. version-controlled finance directory and YYYY is the current year.
Or \f[C]\[ti]/DIR/current.journal\f[R], where current.journal is a Or, \f[C]\[ti]/finance/current.journal\f[R], where current.journal is a
symbolic link to YYYY.journal. symbolic link to YYYY.journal.
.PP .PP
On Mac computers, you can set this and other environment variables in a The usual way to set this permanently is to add a command to one of your
more thorough way that also affects applications started from the GUI shell\[aq]s startup files (eg \f[C]\[ti]/.profile\f[R]):
(say, an Emacs dock icon). .IP
Eg on MacOS Catalina I have a \f[C]\[ti]/.MacOSX/environment.plist\f[R] .nf
file containing \f[C]
export LEDGER_FILE=\[ti]/finance/current.journal\[ga]
\f[R]
.fi
.PP
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In
\f[C]\[ti]/.MacOSX/environment.plist\f[R], add an entry like:
.IP .IP
.nf .nf
\f[C] \f[C]
@ -543,7 +553,22 @@ file containing
\f[R] \f[R]
.fi .fi
.PP .PP
To see the effect you may need to \f[C]killall Dock\f[R], or reboot. For this to take effect you might need to \f[C]killall Dock\f[R], or
reboot.
.PP
On Windows computers, the default value is probably
\f[C]C:\[rs]Users\[rs]MyUserName\[rs].hledger.journal\f[R].
You can change this by running a command like this in a powershell
window:
.IP
.nf
\f[C]
> setx LEDGER_FILE \[dq]C:\[rs]Users\[rs]MyUserName\[rs]finance\[rs]2021.journal\[dq]
\f[R]
.fi
.PP
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
.SH FILES .SH FILES
.PP .PP
Reads data from one or more files in hledger journal, timeclock, Reads data from one or more files in hledger journal, timeclock,

44
hledger-ui/hledger-ui.info
View File

@ -564,24 +564,38 @@ File: hledger-ui.info, Node: ENVIRONMENT, Next: FILES, Prev: TIPS, Up: Top
*COLUMNS* The screen width to use. Default: the full terminal width. *COLUMNS* The screen width to use. Default: the full terminal width.
*LEDGER_FILE* The journal file path when not specified with '-f'. *LEDGER_FILE* The journal file path when not specified with '-f'.
Default: '~/.hledger.journal' (on windows, perhaps
'C:/Users/USER/.hledger.journal').
A typical value is '~/DIR/YYYY.journal', where DIR is a On unix computers, the default value is: '~/.hledger.journal'.
version-controlled finance directory and YYYY is the current year. Or
'~/DIR/current.journal', where current.journal is a symbolic link to
YYYY.journal.
On Mac computers, you can set this and other environment variables in A more typical value is something like '~/finance/YYYY.journal',
a more thorough way that also affects applications started from the GUI where '~/finance' is a version-controlled finance directory and YYYY is
(say, an Emacs dock icon). Eg on MacOS Catalina I have a the current year. Or, '~/finance/current.journal', where
'~/.MacOSX/environment.plist' file containing current.journal is a symbolic link to YYYY.journal.
The usual way to set this permanently is to add a command to one of
your shell's startup files (eg '~/.profile'):
export LEDGER_FILE=~/finance/current.journal`
On some Mac computers, there is a more thorough way to set
environment variables, that will also affect applications started from
the GUI (eg, Emacs started from a dock icon): In
'~/.MacOSX/environment.plist', add an entry like:
{ {
"LEDGER_FILE" : "~/finance/current.journal" "LEDGER_FILE" : "~/finance/current.journal"
} }
To see the effect you may need to 'killall Dock', or reboot. For this to take effect you might need to 'killall Dock', or reboot.
On Windows computers, the default value is probably
'C:\Users\MyUserName\.hledger.journal'. You can change this by running
a command like this in a powershell window:
> setx LEDGER_FILE "C:\Users\MyUserName\finance\2021.journal"
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
 
File: hledger-ui.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top File: hledger-ui.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top
@ -649,10 +663,10 @@ Node: Watch mode limitations18399
Ref: #watch-mode-limitations18540 Ref: #watch-mode-limitations18540
Node: ENVIRONMENT19676 Node: ENVIRONMENT19676
Ref: #environment19787 Ref: #environment19787
Node: FILES20594 Node: FILES21095
Ref: #files20693 Ref: #files21194
Node: BUGS20906 Node: BUGS21407
Ref: #bugs20983 Ref: #bugs21484
 
End Tag Table End Tag Table

37
hledger-ui/hledger-ui.txt
View File

@ -464,24 +464,39 @@ TIPS
ENVIRONMENT ENVIRONMENT
COLUMNS The screen width to use. Default: the full terminal width. COLUMNS The screen width to use. Default: the full terminal width.
LEDGER_FILE The journal file path when not specified with -f. Default: LEDGER_FILE The journal file path when not specified with -f.
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
nal).
A typical value is ~/DIR/YYYY.journal, where DIR is a version-con- On unix computers, the default value is: ~/.hledger.journal.
trolled finance directory and YYYY is the current year. Or ~/DIR/cur-
rent.journal, where current.journal is a symbolic link to YYYY.journal.
On Mac computers, you can set this and other environment variables in a A more typical value is something like ~/finance/YYYY.journal, where
more thorough way that also affects applications started from the GUI ~/finance is a version-controlled finance directory and YYYY is the
(say, an Emacs dock icon). Eg on MacOS Catalina I have a current year. Or, ~/finance/current.journal, where current.journal is
~/.MacOSX/environment.plist file containing a symbolic link to YYYY.journal.
The usual way to set this permanently is to add a command to one of
your shell's startup files (eg ~/.profile):
export LEDGER_FILE=~/finance/current.journal`
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In ~/.MacOSX/environment.plist, add an
entry like:
{ {
"LEDGER_FILE" : "~/finance/current.journal" "LEDGER_FILE" : "~/finance/current.journal"
} }
To see the effect you may need to killall Dock, or reboot. For this to take effect you might need to killall Dock, or reboot.
On Windows computers, the default value is probably C:\Users\MyUser-
Name\.hledger.journal. You can change this by running a command like
this in a powershell window:
> setx LEDGER_FILE "C:\Users\MyUserName\finance\2021.journal"
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
FILES FILES
Reads data from one or more files in hledger journal, timeclock, time- Reads data from one or more files in hledger journal, timeclock, time-

45
hledger-web/hledger-web.1
View File

@ -579,19 +579,29 @@ $ curl http://127.0.0.1:5000/add -X PUT -H \[aq]Content-Type: application/json\[
.PP .PP
\f[B]LEDGER_FILE\f[R] The journal file path when not specified with \f[B]LEDGER_FILE\f[R] The journal file path when not specified with
\f[C]-f\f[R]. \f[C]-f\f[R].
Default: \f[C]\[ti]/.hledger.journal\f[R] (on windows, perhaps
\f[C]C:/Users/USER/.hledger.journal\f[R]).
.PP .PP
A typical value is \f[C]\[ti]/DIR/YYYY.journal\f[R], where DIR is a On unix computers, the default value is:
\f[C]\[ti]/.hledger.journal\f[R].
.PP
A more typical value is something like
\f[C]\[ti]/finance/YYYY.journal\f[R], where \f[C]\[ti]/finance\f[R] is a
version-controlled finance directory and YYYY is the current year. version-controlled finance directory and YYYY is the current year.
Or \f[C]\[ti]/DIR/current.journal\f[R], where current.journal is a Or, \f[C]\[ti]/finance/current.journal\f[R], where current.journal is a
symbolic link to YYYY.journal. symbolic link to YYYY.journal.
.PP .PP
On Mac computers, you can set this and other environment variables in a The usual way to set this permanently is to add a command to one of your
more thorough way that also affects applications started from the GUI shell\[aq]s startup files (eg \f[C]\[ti]/.profile\f[R]):
(say, an Emacs dock icon). .IP
Eg on MacOS Catalina I have a \f[C]\[ti]/.MacOSX/environment.plist\f[R] .nf
file containing \f[C]
export LEDGER_FILE=\[ti]/finance/current.journal\[ga]
\f[R]
.fi
.PP
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In
\f[C]\[ti]/.MacOSX/environment.plist\f[R], add an entry like:
.IP .IP
.nf .nf
\f[C] \f[C]
@ -601,7 +611,22 @@ file containing
\f[R] \f[R]
.fi .fi
.PP .PP
To see the effect you may need to \f[C]killall Dock\f[R], or reboot. For this to take effect you might need to \f[C]killall Dock\f[R], or
reboot.
.PP
On Windows computers, the default value is probably
\f[C]C:\[rs]Users\[rs]MyUserName\[rs].hledger.journal\f[R].
You can change this by running a command like this in a powershell
window:
.IP
.nf
\f[C]
> setx LEDGER_FILE \[dq]C:\[rs]Users\[rs]MyUserName\[rs]finance\[rs]2021.journal\[dq]
\f[R]
.fi
.PP
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
.SH FILES .SH FILES
.PP .PP
Reads data from one or more files in hledger journal, timeclock, Reads data from one or more files in hledger journal, timeclock,

44
hledger-web/hledger-web.info
View File

@ -567,24 +567,38 @@ File: hledger-web.info, Node: ENVIRONMENT, Next: FILES, Prev: JSON API, Up:
************* *************
*LEDGER_FILE* The journal file path when not specified with '-f'. *LEDGER_FILE* The journal file path when not specified with '-f'.
Default: '~/.hledger.journal' (on windows, perhaps
'C:/Users/USER/.hledger.journal').
A typical value is '~/DIR/YYYY.journal', where DIR is a On unix computers, the default value is: '~/.hledger.journal'.
version-controlled finance directory and YYYY is the current year. Or
'~/DIR/current.journal', where current.journal is a symbolic link to
YYYY.journal.
On Mac computers, you can set this and other environment variables in A more typical value is something like '~/finance/YYYY.journal',
a more thorough way that also affects applications started from the GUI where '~/finance' is a version-controlled finance directory and YYYY is
(say, an Emacs dock icon). Eg on MacOS Catalina I have a the current year. Or, '~/finance/current.journal', where
'~/.MacOSX/environment.plist' file containing current.journal is a symbolic link to YYYY.journal.
The usual way to set this permanently is to add a command to one of
your shell's startup files (eg '~/.profile'):
export LEDGER_FILE=~/finance/current.journal`
On some Mac computers, there is a more thorough way to set
environment variables, that will also affect applications started from
the GUI (eg, Emacs started from a dock icon): In
'~/.MacOSX/environment.plist', add an entry like:
{ {
"LEDGER_FILE" : "~/finance/current.journal" "LEDGER_FILE" : "~/finance/current.journal"
} }
To see the effect you may need to 'killall Dock', or reboot. For this to take effect you might need to 'killall Dock', or reboot.
On Windows computers, the default value is probably
'C:\Users\MyUserName\.hledger.journal'. You can change this by running
a command like this in a powershell window:
> setx LEDGER_FILE "C:\Users\MyUserName\finance\2021.journal"
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
 
File: hledger-web.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top File: hledger-web.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top
@ -629,10 +643,10 @@ Node: JSON API12838
Ref: #json-api12952 Ref: #json-api12952
Node: ENVIRONMENT18442 Node: ENVIRONMENT18442
Ref: #environment18558 Ref: #environment18558
Node: FILES19291 Node: FILES19792
Ref: #files19391 Ref: #files19892
Node: BUGS19604 Node: BUGS20105
Ref: #bugs19682 Ref: #bugs20183
 
End Tag Table End Tag Table

37
hledger-web/hledger-web.txt
View File

@ -512,24 +512,39 @@ JSON API
$ curl http://127.0.0.1:5000/add -X PUT -H 'Content-Type: application/json' --data-binary @txn.json $ curl http://127.0.0.1:5000/add -X PUT -H 'Content-Type: application/json' --data-binary @txn.json
ENVIRONMENT ENVIRONMENT
LEDGER_FILE The journal file path when not specified with -f. Default: LEDGER_FILE The journal file path when not specified with -f.
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
nal).
A typical value is ~/DIR/YYYY.journal, where DIR is a version-con- On unix computers, the default value is: ~/.hledger.journal.
trolled finance directory and YYYY is the current year. Or ~/DIR/cur-
rent.journal, where current.journal is a symbolic link to YYYY.journal.
On Mac computers, you can set this and other environment variables in a A more typical value is something like ~/finance/YYYY.journal, where
more thorough way that also affects applications started from the GUI ~/finance is a version-controlled finance directory and YYYY is the
(say, an Emacs dock icon). Eg on MacOS Catalina I have a current year. Or, ~/finance/current.journal, where current.journal is
~/.MacOSX/environment.plist file containing a symbolic link to YYYY.journal.
The usual way to set this permanently is to add a command to one of
your shell's startup files (eg ~/.profile):
export LEDGER_FILE=~/finance/current.journal`
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In ~/.MacOSX/environment.plist, add an
entry like:
{ {
"LEDGER_FILE" : "~/finance/current.journal" "LEDGER_FILE" : "~/finance/current.journal"
} }
To see the effect you may need to killall Dock, or reboot. For this to take effect you might need to killall Dock, or reboot.
On Windows computers, the default value is probably C:\Users\MyUser-
Name\.hledger.journal. You can change this by running a command like
this in a powershell window:
> setx LEDGER_FILE "C:\Users\MyUserName\finance\2021.journal"
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
FILES FILES
Reads data from one or more files in hledger journal, timeclock, time- Reads data from one or more files in hledger journal, timeclock, time-

61
hledger/hledger.1
View File

@ -507,19 +507,29 @@ See Special characters.
.PP .PP
\f[B]LEDGER_FILE\f[R] The journal file path when not specified with \f[B]LEDGER_FILE\f[R] The journal file path when not specified with
\f[C]-f\f[R]. \f[C]-f\f[R].
Default: \f[C]\[ti]/.hledger.journal\f[R] (on windows, perhaps
\f[C]C:/Users/USER/.hledger.journal\f[R]).
.PP .PP
A typical value is \f[C]\[ti]/DIR/YYYY.journal\f[R], where DIR is a On unix computers, the default value is:
\f[C]\[ti]/.hledger.journal\f[R].
.PP
A more typical value is something like
\f[C]\[ti]/finance/YYYY.journal\f[R], where \f[C]\[ti]/finance\f[R] is a
version-controlled finance directory and YYYY is the current year. version-controlled finance directory and YYYY is the current year.
Or \f[C]\[ti]/DIR/current.journal\f[R], where current.journal is a Or, \f[C]\[ti]/finance/current.journal\f[R], where current.journal is a
symbolic link to YYYY.journal. symbolic link to YYYY.journal.
.PP .PP
On Mac computers, you can set this and other environment variables in a The usual way to set this permanently is to add a command to one of your
more thorough way that also affects applications started from the GUI shell\[aq]s startup files (eg \f[C]\[ti]/.profile\f[R]):
(say, an Emacs dock icon). .IP
Eg on MacOS Catalina I have a \f[C]\[ti]/.MacOSX/environment.plist\f[R] .nf
file containing \f[C]
export LEDGER_FILE=\[ti]/finance/current.journal\[ga]
\f[R]
.fi
.PP
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In
\f[C]\[ti]/.MacOSX/environment.plist\f[R], add an entry like:
.IP .IP
.nf .nf
\f[C] \f[C]
@ -529,7 +539,22 @@ file containing
\f[R] \f[R]
.fi .fi
.PP .PP
To see the effect you may need to \f[C]killall Dock\f[R], or reboot. For this to take effect you might need to \f[C]killall Dock\f[R], or
reboot.
.PP
On Windows computers, the default value is probably
\f[C]C:\[rs]Users\[rs]MyUserName\[rs].hledger.journal\f[R].
You can change this by running a command like this in a powershell
window:
.IP
.nf
\f[C]
> setx LEDGER_FILE \[dq]C:\[rs]Users\[rs]MyUserName\[rs]finance\[rs]2021.journal\[dq]
\f[R]
.fi
.PP
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
.PP .PP
\f[B]COLUMNS\f[R] The screen width used by the register command. \f[B]COLUMNS\f[R] The screen width used by the register command.
Default: the full terminal width. Default: the full terminal width.
@ -2520,6 +2545,10 @@ the file extension, if needed:
$ hledger balancesheet -o foo.txt -O csv # write CSV to foo.txt $ hledger balancesheet -o foo.txt -O csv # write CSV to foo.txt
\f[R] \f[R]
.fi .fi
.SS CSV output
.IP \[bu] 2
In CSV output, digit group marks (such as thousands separators) are
disabled automatically.
.SS HTML output .SS HTML output
.IP \[bu] 2 .IP \[bu] 2
HTML output can be styled by an optional \f[C]hledger.css\f[R] file in HTML output can be styled by an optional \f[C]hledger.css\f[R] file in
@ -8706,6 +8735,9 @@ comma).
Field names may not contain spaces. Field names may not contain spaces.
Spaces before/after field names are optional. Spaces before/after field names are optional.
.IP \[bu] 2 .IP \[bu] 2
Field names may contain \f[C]_\f[R] (underscore) or \f[C]-\f[R]
(hyphen).
.IP \[bu] 2
If the CSV contains column headings, it\[aq]s a good idea to use these, If the CSV contains column headings, it\[aq]s a good idea to use these,
suitably modified, as the basis for your field names (eg lower-cased, suitably modified, as the basis for your field names (eg lower-cased,
with underscores instead of spaces). with underscores instead of spaces).
@ -8782,10 +8814,13 @@ Assigning to \f[C]date\f[R] sets the transaction date.
\f[C]commentN\f[R], where N is a number, sets the Nth posting\[aq]s \f[C]commentN\f[R], where N is a number, sets the Nth posting\[aq]s
comment. comment.
.PP .PP
Tips: - You can assign multi-line comments by writing literal Tips:
\f[C]\[rs]n\f[R] in the code. .IP \[bu] 2
You can assign multi-line comments by writing literal \f[C]\[rs]n\f[R]
in the code.
A comment starting with \f[C]\[rs]n\f[R] will begin on a new line. A comment starting with \f[C]\[rs]n\f[R] will begin on a new line.
- Comments can contain tags, as usual. .IP \[bu] 2
Comments can contain tags, as usual.
.SS account field .SS account field
.PP .PP
Assigning to \f[C]accountN\f[R], where N is 1 to 99, sets the account Assigning to \f[C]accountN\f[R], where N is 1 to 99, sets the account

1053
hledger/hledger.info
View File

File diff suppressed because it is too large Load Diff

71
hledger/hledger.txt
View File

@ -404,24 +404,39 @@ OPTIONS
cial characters. cial characters.
ENVIRONMENT ENVIRONMENT
LEDGER_FILE The journal file path when not specified with -f. Default: LEDGER_FILE The journal file path when not specified with -f.
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
nal).
A typical value is ~/DIR/YYYY.journal, where DIR is a version-con- On unix computers, the default value is: ~/.hledger.journal.
trolled finance directory and YYYY is the current year. Or ~/DIR/cur-
rent.journal, where current.journal is a symbolic link to YYYY.journal.
On Mac computers, you can set this and other environment variables in a A more typical value is something like ~/finance/YYYY.journal, where
more thorough way that also affects applications started from the GUI ~/finance is a version-controlled finance directory and YYYY is the
(say, an Emacs dock icon). Eg on MacOS Catalina I have a current year. Or, ~/finance/current.journal, where current.journal is
~/.MacOSX/environment.plist file containing a symbolic link to YYYY.journal.
The usual way to set this permanently is to add a command to one of
your shell's startup files (eg ~/.profile):
export LEDGER_FILE=~/finance/current.journal`
On some Mac computers, there is a more thorough way to set environment
variables, that will also affect applications started from the GUI (eg,
Emacs started from a dock icon): In ~/.MacOSX/environment.plist, add an
entry like:
{ {
"LEDGER_FILE" : "~/finance/current.journal" "LEDGER_FILE" : "~/finance/current.journal"
} }
To see the effect you may need to killall Dock, or reboot. For this to take effect you might need to killall Dock, or reboot.
On Windows computers, the default value is probably C:\Users\MyUser-
Name\.hledger.journal. You can change this by running a command like
this in a powershell window:
> setx LEDGER_FILE "C:\Users\MyUserName\finance\2021.journal"
(Let us know if you need to be an Administrator, and if this persists
across a reboot.)
COLUMNS The screen width used by the register command. Default: the COLUMNS The screen width used by the register command. Default: the
full terminal width. full terminal width.
@ -462,6 +477,8 @@ DATA FILES
clock ging clock ging
timedot timedot files, for approximate time .timedot timedot timedot files, for approximate time .timedot
logging logging
csv comma/semicolon/tab/other-separated .csv .ssv .tsv csv comma/semicolon/tab/other-separated .csv .ssv .tsv
values, for data import values, for data import
@ -599,6 +616,7 @@ TIME PERIODS
-p thismonth all transactions in the current month -p thismonth all transactions in the current month
date:2016/3/17.. the above written as queries instead (.. can also be date:2016/3/17.. the above written as queries instead (.. can also be
replaced with -) replaced with -)
date:..12/1 date:..12/1
date:thismonth.. date:thismonth..
date:thismonth date:thismonth
@ -685,7 +703,6 @@ TIME PERIODS
earliest or latest transaction in your journal: earliest or latest transaction in your journal:
-p "from 2009/1/1" everything after january -p "from 2009/1/1" everything after january
1, 2009 1, 2009
-p "from 2009/1" the same -p "from 2009/1" the same
@ -736,6 +753,8 @@ TIME PERIODS
-p "weekly from 2009/1/1 starts on 2008/12/29, closest preceding Mon- -p "weekly from 2009/1/1 starts on 2008/12/29, closest preceding Mon-
to 2009/4/1" day to 2009/4/1" day
-p "monthly in starts on 2018/11/01 -p "monthly in starts on 2018/11/01
2008/11/25" 2008/11/25"
-p "quarterly from starts on 2009/04/01, ends on 2009/06/30, -p "quarterly from starts on 2009/04/01, ends on 2009/06/30,
@ -804,6 +823,7 @@ TIME PERIODS
month month
-p "every 2nd Monday" period boundaries will be on second Monday of -p "every 2nd Monday" period boundaries will be on second Monday of
each month each month
-p "every 11/05" yearly periods with boundaries on 5th of -p "every 11/05" yearly periods with boundaries on 5th of
November November
-p "every 5th November" same -p "every 5th November" same
@ -1358,6 +1378,9 @@ VALUATION
starting bal- cost value at valued at day value at value at starting bal- cost value at valued at day value at value at
ance (-H) report or each historical report or DATE/today ance (-H) report or each historical report or DATE/today
journal end posting was made journal end journal end posting was made journal end
starting bal- cost value at day valued at day value at day value at starting bal- cost value at day valued at day value at day value at
ance (-H) before each historical before DATE/today ance (-H) before each historical before DATE/today
with report report or posting was made report or with report report or posting was made report or
@ -1392,11 +1415,6 @@ VALUATION
bse, cf, is) bse, cf, is)
with report with report
interval interval
starting bal- sums of value at sums of values of value at sums of post- starting bal- sums of value at sums of values of value at sums of post-
ances (-H) costs of report start postings before report start ings before ances (-H) costs of report start postings before report start ings before
postings of sums of report start at of sums of report start postings of sums of report start at of sums of report start
@ -1588,6 +1606,10 @@ OUTPUT
$ hledger balancesheet -o foo.txt -O csv # write CSV to foo.txt $ hledger balancesheet -o foo.txt -O csv # write CSV to foo.txt
CSV output
o In CSV output, digit group marks (such as thousands separators) are
disabled automatically.
HTML output HTML output
o HTML output can be styled by an optional hledger.css file in the same o HTML output can be styled by an optional hledger.css file in the same
directory. directory.
@ -2220,12 +2242,12 @@ COMMANDS
formats: formats:
- txt csv html json sql - txt csv html json sql
------------------------------------- -------------------------------------
wide Y Y Y wide Y Y Y
tall Y Y Y tall Y Y Y
bare Y Y Y bare Y Y Y
tidy Y tidy Y
Examples: Examples:
@ -4984,6 +5006,7 @@ JOURNAL FORMAT
And here are all the directives and their precise effects: And here are all the directives and their precise effects:
direc- effects ends direc- effects ends
tive at tive at
file file
@ -5882,7 +5905,6 @@ CSV FORMAT
records records
fields list name CSV fields, assign them to hledger fields list name CSV fields, assign them to hledger
fields fields
field assignment assign a value to one hledger field, with field assignment assign a value to one hledger field, with
interpolation interpolation
Field names hledger field names, used in the fields list Field names hledger field names, used in the fields list
@ -6228,6 +6250,8 @@ CSV FORMAT
o Field names may not contain spaces. Spaces before/after field names o Field names may not contain spaces. Spaces before/after field names
are optional. are optional.
o Field names may contain _ (underscore) or - (hyphen).
o If the CSV contains column headings, it's a good idea to use these, o If the CSV contains column headings, it's a good idea to use these,
suitably modified, as the basis for your field names (eg lower-cased, suitably modified, as the basis for your field names (eg lower-cased,
with underscores instead of spaces). with underscores instead of spaces).
@ -6294,9 +6318,12 @@ CSV FORMAT
commentN, where N is a number, sets the Nth posting's comment. commentN, where N is a number, sets the Nth posting's comment.
Tips: - You can assign multi-line comments by writing literal \n in the Tips:
code. A comment starting with \n will begin on a new line. - Comments
can contain tags, as usual. o You can assign multi-line comments by writing literal \n in the code.
A comment starting with \n will begin on a new line.
o Comments can contain tags, as usual.
account field account field
Assigning to accountN, where N is 1 to 99, sets the account name of the Assigning to accountN, where N is 1 to 99, sets the account name of the