mirror of
https://github.com/simonmichael/hledger.git
synced 2024-11-08 07:09:28 +03:00
;doc: update manuals
This commit is contained in:
Simon Michael
parent
30076e8ecc
commit
14aa047e08
@ -47,7 +47,7 @@ before options as shown above.
|
||||
Any QUERYARGS are interpreted as a hledger search query which filters
|
||||
the data.
|
||||
.TP
|
||||
\f[B]\f[CB]--watch\f[B]\f[R]
|
||||
\f[B]\f[CB]-w --watch\f[B]\f[R]
|
||||
watch for data and date changes and reload automatically
|
||||
.TP
|
||||
\f[B]\f[CB]--theme=default|terminal|greenterm\f[B]\f[R]
|
||||
@ -258,7 +258,7 @@ the transactions to be shown (by default, all are shown).
|
||||
report period durations: year, quarter, month, week, day.
|
||||
Then, \f[C]SHIFT-LEFT/RIGHT\f[R] moves to the previous/next period.
|
||||
\f[C]T\f[R] sets the report period to today.
|
||||
With the \f[C]--watch\f[R] option, when viewing a \[dq]current\[dq]
|
||||
With the \f[C]-w/--watch\f[R] option, when viewing a \[dq]current\[dq]
|
||||
period (the current day, week, month, quarter, or year), the period will
|
||||
move automatically to track the current date.
|
||||
To set a non-standard period, you can use \f[C]/\f[R] and a
|
||||
@ -464,7 +464,7 @@ normal operation.
|
||||
.SS Watch mode
|
||||
.PP
|
||||
One of hledger-ui\[aq]s best features is the auto-reloading
|
||||
\f[C]--watch\f[R] mode.
|
||||
\f[C]-w/--watch\f[R] mode.
|
||||
With this flag, it will update the display automatically whenever
|
||||
changes are saved to the data files.
|
||||
.PP
|
||||
@ -571,7 +571,8 @@ subsiding, and possibly a small but persistent build-up of CPU usage
|
||||
until the program is restarted.
|
||||
.PP
|
||||
Also, if you are viewing files mounted from another machine,
|
||||
\f[C]--watch\f[R] requires that both machine clocks are roughly in step.
|
||||
\f[C]-w/--watch\f[R] requires that both machine clocks are roughly in
|
||||
step.
|
||||
|
||||
|
||||
.SH "REPORTING BUGS"
|
||||
|
||||
@ -1,5 +1,4 @@
|
||||
This is hledger-ui/hledger-ui.info, produced by makeinfo version 4.8
|
||||
from stdin.
|
||||
This is hledger-ui.info, produced by makeinfo version 6.8 from stdin.
|
||||
|
||||
INFO-DIR-SECTION User Applications
|
||||
START-INFO-DIR-ENTRY
|
||||
@ -7,36 +6,36 @@ START-INFO-DIR-ENTRY
|
||||
END-INFO-DIR-ENTRY
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: Top, Up: (dir)
|
||||
File: hledger-ui.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||
|
||||
hledger-ui(1)
|
||||
*************
|
||||
|
||||
hledger-ui is a terminal interface (TUI) for the hledger accounting
|
||||
tool. This manual is for hledger-ui 1.23.99.
|
||||
tool. This manual is for hledger-ui 1.23.99.
|
||||
|
||||
`hledger-ui [OPTIONS] [QUERYARGS]'
|
||||
`hledger ui -- [OPTIONS] [QUERYARGS]'
|
||||
'hledger-ui [OPTIONS] [QUERYARGS]'
|
||||
'hledger ui -- [OPTIONS] [QUERYARGS]'
|
||||
|
||||
hledger is a reliable, cross-platform set of programs for tracking
|
||||
money, time, or any other commodity, using double-entry accounting and a
|
||||
simple, editable file format. hledger is inspired by and largely
|
||||
simple, editable file format. hledger is inspired by and largely
|
||||
compatible with ledger(1).
|
||||
|
||||
hledger-ui is hledger's terminal interface, providing an efficient
|
||||
full-window text UI for viewing accounts and transactions, and some
|
||||
limited data entry capability. It is easier than hledger's command-line
|
||||
limited data entry capability. It is easier than hledger's command-line
|
||||
interface, and sometimes quicker and more convenient than the web
|
||||
interface.
|
||||
|
||||
Like hledger, it reads data from one or more files in hledger
|
||||
journal, timeclock, timedot, or CSV format specified with `-f', or
|
||||
`$LEDGER_FILE', or `$HOME/.hledger.journal' (on windows, perhaps
|
||||
`C:/Users/USER/.hledger.journal'). For more about this see hledger(1),
|
||||
journal, timeclock, timedot, or CSV format specified with '-f', or
|
||||
'$LEDGER_FILE', or '$HOME/.hledger.journal' (on windows, perhaps
|
||||
'C:/Users/USER/.hledger.journal'). For more about this see hledger(1),
|
||||
hledger_journal(5) etc.
|
||||
|
||||
Unlike hledger, hledger-ui hides all future-dated transactions by
|
||||
default. They can be revealed, along with any rule-generated periodic
|
||||
default. They can be revealed, along with any rule-generated periodic
|
||||
transactions, by pressing the F key (or starting with -forecast) to
|
||||
enable "forecast mode".
|
||||
|
||||
@ -57,155 +56,158 @@ File: hledger-ui.info, Node: OPTIONS, Next: MOUSE, Prev: Top, Up: Top
|
||||
1 OPTIONS
|
||||
*********
|
||||
|
||||
Note: if invoking hledger-ui as a hledger subcommand, write `--' before
|
||||
Note: if invoking hledger-ui as a hledger subcommand, write '--' before
|
||||
options as shown above.
|
||||
|
||||
Any QUERYARGS are interpreted as a hledger search query which filters
|
||||
the data.
|
||||
|
||||
`--watch'
|
||||
'-w --watch'
|
||||
|
||||
watch for data and date changes and reload automatically
|
||||
'--theme=default|terminal|greenterm'
|
||||
|
||||
`--theme=default|terminal|greenterm'
|
||||
use this custom display theme
|
||||
'--register=ACCTREGEX'
|
||||
|
||||
`--register=ACCTREGEX'
|
||||
start in the (first) matched account's register screen
|
||||
'--change'
|
||||
|
||||
`--change'
|
||||
show period balances (changes) at startup instead of historical
|
||||
balances
|
||||
'-l --flat'
|
||||
|
||||
`-l --flat'
|
||||
show accounts as a flat list (default)
|
||||
'-t --tree'
|
||||
|
||||
`-t --tree'
|
||||
show accounts as a tree
|
||||
|
||||
hledger input options:
|
||||
|
||||
`-f FILE --file=FILE'
|
||||
use a different input file. For stdin, use - (default:
|
||||
`$LEDGER_FILE' or `$HOME/.hledger.journal')
|
||||
'-f FILE --file=FILE'
|
||||
|
||||
use a different input file. For stdin, use - (default:
|
||||
'$LEDGER_FILE' or '$HOME/.hledger.journal')
|
||||
'--rules-file=RULESFILE'
|
||||
|
||||
`--rules-file=RULESFILE'
|
||||
Conversion rules file to use when reading CSV (default: FILE.rules)
|
||||
'--separator=CHAR'
|
||||
|
||||
`--separator=CHAR'
|
||||
Field separator to expect when reading CSV (default: ',')
|
||||
'--alias=OLD=NEW'
|
||||
|
||||
`--alias=OLD=NEW'
|
||||
rename accounts named OLD to NEW
|
||||
'--anon'
|
||||
|
||||
`--anon'
|
||||
anonymize accounts and payees
|
||||
'--pivot FIELDNAME'
|
||||
|
||||
`--pivot FIELDNAME'
|
||||
use some other field or tag for the account name
|
||||
'-I --ignore-assertions'
|
||||
|
||||
`-I --ignore-assertions'
|
||||
disable balance assertion checks (note: does not disable balance
|
||||
assignments)
|
||||
'-s --strict'
|
||||
|
||||
`-s --strict'
|
||||
do extra error checking (check that all posted accounts are
|
||||
declared)
|
||||
|
||||
hledger reporting options:
|
||||
|
||||
`-b --begin=DATE'
|
||||
'-b --begin=DATE'
|
||||
|
||||
include postings/txns on or after this date (will be adjusted to
|
||||
preceding subperiod start when using a report interval)
|
||||
'-e --end=DATE'
|
||||
|
||||
`-e --end=DATE'
|
||||
include postings/txns before this date (will be adjusted to
|
||||
following subperiod end when using a report interval)
|
||||
'-D --daily'
|
||||
|
||||
`-D --daily'
|
||||
multiperiod/multicolumn report by day
|
||||
'-W --weekly'
|
||||
|
||||
`-W --weekly'
|
||||
multiperiod/multicolumn report by week
|
||||
'-M --monthly'
|
||||
|
||||
`-M --monthly'
|
||||
multiperiod/multicolumn report by month
|
||||
'-Q --quarterly'
|
||||
|
||||
`-Q --quarterly'
|
||||
multiperiod/multicolumn report by quarter
|
||||
'-Y --yearly'
|
||||
|
||||
`-Y --yearly'
|
||||
multiperiod/multicolumn report by year
|
||||
'-p --period=PERIODEXP'
|
||||
|
||||
`-p --period=PERIODEXP'
|
||||
set start date, end date, and/or reporting interval all at once
|
||||
using period expressions syntax
|
||||
'--date2'
|
||||
|
||||
`--date2'
|
||||
match the secondary date instead (see command help for other
|
||||
effects)
|
||||
'--today=DATE'
|
||||
|
||||
`--today=DATE'
|
||||
override today's date (affects relative smart dates, for
|
||||
tests/examples)
|
||||
'-U --unmarked'
|
||||
|
||||
`-U --unmarked'
|
||||
include only unmarked postings/txns (can combine with -P or -C)
|
||||
'-P --pending'
|
||||
|
||||
`-P --pending'
|
||||
include only pending postings/txns
|
||||
'-C --cleared'
|
||||
|
||||
`-C --cleared'
|
||||
include only cleared postings/txns
|
||||
'-R --real'
|
||||
|
||||
`-R --real'
|
||||
include only non-virtual postings
|
||||
'-NUM --depth=NUM'
|
||||
|
||||
`-NUM --depth=NUM'
|
||||
hide/aggregate accounts or postings more than NUM levels deep
|
||||
'-E --empty'
|
||||
|
||||
`-E --empty'
|
||||
show items with zero amount, normally hidden (and vice-versa in
|
||||
hledger-ui/hledger-web)
|
||||
'-B --cost'
|
||||
|
||||
`-B --cost'
|
||||
convert amounts to their cost/selling amount at transaction time
|
||||
'-V --market'
|
||||
|
||||
`-V --market'
|
||||
convert amounts to their market value in default valuation
|
||||
commodities
|
||||
'-X --exchange=COMM'
|
||||
|
||||
`-X --exchange=COMM'
|
||||
convert amounts to their market value in commodity COMM
|
||||
'--value'
|
||||
|
||||
`--value'
|
||||
convert amounts to cost or market value, more flexibly than
|
||||
-B/-V/-X
|
||||
'--infer-market-prices'
|
||||
|
||||
`--infer-market-prices'
|
||||
use transaction prices (recorded with @ or @@) as additional market
|
||||
prices, as if they were P directives
|
||||
'--auto'
|
||||
|
||||
`--auto'
|
||||
apply automated posting rules to modify transactions.
|
||||
'--forecast'
|
||||
|
||||
`--forecast'
|
||||
generate future transactions from periodic transaction rules, for
|
||||
the next 6 months or till report end date. In hledger-ui, also
|
||||
the next 6 months or till report end date. In hledger-ui, also
|
||||
make ordinary future transactions visible.
|
||||
'--commodity-style'
|
||||
|
||||
`--commodity-style'
|
||||
Override the commodity style in the output for the specified
|
||||
commodity. For example 'EUR1.000,00'.
|
||||
'--color=WHEN (or --colour=WHEN)'
|
||||
|
||||
`--color=WHEN (or --colour=WHEN)'
|
||||
Should color-supporting commands use ANSI color codes in text
|
||||
output. 'auto' (default): whenever stdout seems to be a
|
||||
color-supporting terminal. 'always' or 'yes': always, useful eg
|
||||
when piping output into 'less -R'. 'never' or 'no': never. A
|
||||
when piping output into 'less -R'. 'never' or 'no': never. A
|
||||
NO_COLOR environment variable overrides this.
|
||||
'--pretty[=WHEN]'
|
||||
|
||||
`--pretty[=WHEN]'
|
||||
Show prettier output, e.g. using unicode box-drawing characters.
|
||||
Show prettier output, e.g. using unicode box-drawing characters.
|
||||
Accepts 'yes' (the default) or 'no' ('y', 'n', 'always', 'never'
|
||||
also work). If you provide an argument you must use '=', e.g.
|
||||
'-pretty=yes'.
|
||||
@ -217,24 +219,25 @@ the last one takes precedence.
|
||||
|
||||
hledger help options:
|
||||
|
||||
`-h --help'
|
||||
'-h --help'
|
||||
|
||||
show general or COMMAND help
|
||||
'--man'
|
||||
|
||||
`--man'
|
||||
show general or COMMAND user manual with man
|
||||
'--info'
|
||||
|
||||
`--info'
|
||||
show general or COMMAND user manual with info
|
||||
'--version'
|
||||
|
||||
`--version'
|
||||
show general or ADDONCMD version
|
||||
'--debug[=N]'
|
||||
|
||||
`--debug[=N]'
|
||||
show debug output (levels 1-9, default: 1)
|
||||
|
||||
A @FILE argument will be expanded to the contents of FILE, which
|
||||
should contain one command line option/argument per line. (To prevent
|
||||
this, insert a `--' argument before.)
|
||||
should contain one command line option/argument per line. (To prevent
|
||||
this, insert a '--' argument before.)
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: MOUSE, Next: KEYS, Prev: OPTIONS, Up: Top
|
||||
@ -246,9 +249,7 @@ In most modern terminals, you can navigate through the screens with a
|
||||
mouse or touchpad:
|
||||
|
||||
* Use mouse wheel or trackpad to scroll up and down
|
||||
|
||||
* Click on list items to go deeper
|
||||
|
||||
* Click on the left margin (column 0), or the blank area at bottom of
|
||||
screen, to go back.
|
||||
|
||||
@ -260,88 +261,88 @@ File: hledger-ui.info, Node: KEYS, Next: SCREENS, Prev: MOUSE, Up: Top
|
||||
|
||||
Keyboard gives more control.
|
||||
|
||||
`?' shows a help dialog listing all keys. (Some of these also appear
|
||||
in the quick help at the bottom of each screen.) Press `?' again (or
|
||||
`ESCAPE', or `LEFT', or `q') to close it. The following keys work on
|
||||
'?' shows a help dialog listing all keys. (Some of these also appear
|
||||
in the quick help at the bottom of each screen.) Press '?' again (or
|
||||
'ESCAPE', or 'LEFT', or 'q') to close it. The following keys work on
|
||||
most screens:
|
||||
|
||||
The cursor keys navigate: `RIGHT' goes deeper, `LEFT' returns to the
|
||||
previous screen, `UP'/`DOWN'/`PGUP'/`PGDN'/`HOME'/`END' move up and
|
||||
down through lists. Emacs-style (`CTRL-p'/`CTRL-n'/`CTRL-f'/`CTRL-b')
|
||||
The cursor keys navigate: 'RIGHT' goes deeper, 'LEFT' returns to the
|
||||
previous screen, 'UP'/'DOWN'/'PGUP'/'PGDN'/'HOME'/'END' move up and down
|
||||
through lists. Emacs-style ('CTRL-p'/'CTRL-n'/'CTRL-f'/'CTRL-b')
|
||||
movement keys are also supported (but not vi-style keys, since
|
||||
hledger-1.19, sorry!). A tip: movement speed is limited by your
|
||||
keyboard repeat rate, to move faster you may want to adjust it. (If
|
||||
keyboard repeat rate, to move faster you may want to adjust it. (If
|
||||
you're on a mac, the karabiner app is one way to do that.)
|
||||
|
||||
With shift pressed, the cursor keys adjust the report period,
|
||||
limiting the transactions to be shown (by default, all are shown).
|
||||
`SHIFT-DOWN/UP' steps downward and upward through these standard report
|
||||
period durations: year, quarter, month, week, day. Then,
|
||||
`SHIFT-LEFT/RIGHT' moves to the previous/next period. `T' sets the
|
||||
report period to today. With the `--watch' option, when viewing a
|
||||
'SHIFT-DOWN/UP' steps downward and upward through these standard report
|
||||
period durations: year, quarter, month, week, day. Then,
|
||||
'SHIFT-LEFT/RIGHT' moves to the previous/next period. 'T' sets the
|
||||
report period to today. With the '-w/--watch' option, when viewing a
|
||||
"current" period (the current day, week, month, quarter, or year), the
|
||||
period will move automatically to track the current date. To set a
|
||||
non-standard period, you can use `/' and a `date:' query.
|
||||
period will move automatically to track the current date. To set a
|
||||
non-standard period, you can use '/' and a 'date:' query.
|
||||
|
||||
`/' lets you set a general filter query limiting the data shown,
|
||||
using the same query terms as in hledger and hledger-web. While editing
|
||||
the query, you can use CTRL-a/e/d/k, BS, cursor keys; press `ENTER' to
|
||||
set it, or `ESCAPE'to cancel. There are also keys for quickly adjusting
|
||||
'/' lets you set a general filter query limiting the data shown,
|
||||
using the same query terms as in hledger and hledger-web. While editing
|
||||
the query, you can use CTRL-a/e/d/k, BS, cursor keys; press 'ENTER' to
|
||||
set it, or 'ESCAPE'to cancel. There are also keys for quickly adjusting
|
||||
some common filters like account depth and transaction status (see
|
||||
below). `BACKSPACE' or `DELETE' removes all filters, showing all
|
||||
below). 'BACKSPACE' or 'DELETE' removes all filters, showing all
|
||||
transactions.
|
||||
|
||||
As mentioned above, by default hledger-ui hides future transactions -
|
||||
both ordinary transactions recorded in the journal, and periodic
|
||||
transactions generated by rule. `F' toggles forecast mode, in which
|
||||
transactions generated by rule. 'F' toggles forecast mode, in which
|
||||
future/forecasted transactions are shown.
|
||||
|
||||
`ESCAPE' resets the UI state and jumps back to the top screen,
|
||||
restoring the app's initial state at startup. Or, it cancels minibuffer
|
||||
'ESCAPE' resets the UI state and jumps back to the top screen,
|
||||
restoring the app's initial state at startup. Or, it cancels minibuffer
|
||||
data entry or the help dialog.
|
||||
|
||||
`CTRL-l' redraws the screen and centers the selection if possible
|
||||
'CTRL-l' redraws the screen and centers the selection if possible
|
||||
(selections near the top won't be centered, since we don't scroll above
|
||||
the top).
|
||||
|
||||
`g' reloads from the data file(s) and updates the current screen and
|
||||
any previous screens. (With large files, this could cause a noticeable
|
||||
'g' reloads from the data file(s) and updates the current screen and
|
||||
any previous screens. (With large files, this could cause a noticeable
|
||||
pause.)
|
||||
|
||||
`I' toggles balance assertion checking. Disabling balance assertions
|
||||
'I' toggles balance assertion checking. Disabling balance assertions
|
||||
temporarily can be useful for troubleshooting.
|
||||
|
||||
`a' runs command-line hledger's add command, and reloads the updated
|
||||
file. This allows some basic data entry.
|
||||
'a' runs command-line hledger's add command, and reloads the updated
|
||||
file. This allows some basic data entry.
|
||||
|
||||
`A' is like `a', but runs the hledger-iadd tool, which provides a
|
||||
terminal interface. This key will be available if `hledger-iadd' is
|
||||
'A' is like 'a', but runs the hledger-iadd tool, which provides a
|
||||
terminal interface. This key will be available if 'hledger-iadd' is
|
||||
installed in $path.
|
||||
|
||||
`E' runs $HLEDGER_UI_EDITOR, or $EDITOR, or a default (`emacsclient
|
||||
-a "" -nw') on the journal file. With some editors (emacs, vi), the
|
||||
'E' runs $HLEDGER_UI_EDITOR, or $EDITOR, or a default ('emacsclient
|
||||
-a "" -nw') on the journal file. With some editors (emacs, vi), the
|
||||
cursor will be positioned at the current transaction when invoked from
|
||||
the register and transaction screens, and at the error location (if
|
||||
possible) when invoked from the error screen.
|
||||
|
||||
`B' toggles cost mode, showing amounts in their transaction price's
|
||||
commodity (like toggling the `-B/--cost' flag).
|
||||
'B' toggles cost mode, showing amounts in their transaction price's
|
||||
commodity (like toggling the '-B/--cost' flag).
|
||||
|
||||
`V' toggles value mode, showing amounts' current market value in
|
||||
their default valuation commodity (like toggling the `-V/--market'
|
||||
flag). Note, "current market value" means the value on the report end
|
||||
date if specified, otherwise today. To see the value on another date,
|
||||
you can temporarily set that as the report end date. Eg: to see a
|
||||
'V' toggles value mode, showing amounts' current market value in
|
||||
their default valuation commodity (like toggling the '-V/--market'
|
||||
flag). Note, "current market value" means the value on the report end
|
||||
date if specified, otherwise today. To see the value on another date,
|
||||
you can temporarily set that as the report end date. Eg: to see a
|
||||
transaction as it was valued on july 30, go to the accounts or register
|
||||
screen, press `/', and add `date:-7/30' to the query.
|
||||
screen, press '/', and add 'date:-7/30' to the query.
|
||||
|
||||
At most one of cost or value mode can be active at once.
|
||||
|
||||
There's not yet any visual reminder when cost or value mode is
|
||||
active; for now pressing `b' `b' `v' should reliably reset to normal
|
||||
active; for now pressing 'b' 'b' 'v' should reliably reset to normal
|
||||
mode.
|
||||
|
||||
`q' quits the application.
|
||||
'q' quits the application.
|
||||
|
||||
Additional screen-specific keys are described below.
|
||||
|
||||
@ -364,47 +365,48 @@ File: hledger-ui.info, Node: Accounts screen, Next: Register screen, Up: SCRE
|
||||
4.1 Accounts screen
|
||||
===================
|
||||
|
||||
This is normally the first screen displayed. It lists accounts and their
|
||||
balances, like hledger's balance command. By default, it shows all
|
||||
accounts and their latest ending balances (including the balances of
|
||||
subaccounts). If you specify a query on the command line, it shows just
|
||||
This is normally the first screen displayed. It lists accounts and
|
||||
their balances, like hledger's balance command. By default, it shows
|
||||
all accounts and their latest ending balances (including the balances of
|
||||
subaccounts). If you specify a query on the command line, it shows just
|
||||
the matched accounts and the balances from matched transactions.
|
||||
|
||||
Account names are shown as a flat list by default; press `t' to
|
||||
toggle tree mode. In list mode, account balances are exclusive of
|
||||
Account names are shown as a flat list by default; press 't' to
|
||||
toggle tree mode. In list mode, account balances are exclusive of
|
||||
subaccounts, except where subaccounts are hidden by a depth limit (see
|
||||
below). In tree mode, all account balances are inclusive of subaccounts.
|
||||
below). In tree mode, all account balances are inclusive of
|
||||
subaccounts.
|
||||
|
||||
To see less detail, press a number key, `1' to `9', to set a depth
|
||||
limit. Or use `-' to decrease and `+'/`=' to increase the depth limit.
|
||||
`0' shows even less detail, collapsing all accounts to a single total.
|
||||
To remove the depth limit, set it higher than the maximum account
|
||||
depth, or press `ESCAPE'.
|
||||
To see less detail, press a number key, '1' to '9', to set a depth
|
||||
limit. Or use '-' to decrease and '+'/'=' to increase the depth limit.
|
||||
'0' shows even less detail, collapsing all accounts to a single total.
|
||||
To remove the depth limit, set it higher than the maximum account depth,
|
||||
or press 'ESCAPE'.
|
||||
|
||||
`H' toggles between showing historical balances or period balances.
|
||||
'H' toggles between showing historical balances or period balances.
|
||||
Historical balances (the default) are ending balances at the end of the
|
||||
report period, taking into account all transactions before that date
|
||||
(filtered by the filter query if any), including transactions before the
|
||||
start of the report period. In other words, historical balances are what
|
||||
you would see on a bank statement for that account (unless disturbed by
|
||||
a filter query). Period balances ignore transactions before the report
|
||||
start date, so they show the change in balance during the report period.
|
||||
They are more useful eg when viewing a time log.
|
||||
start of the report period. In other words, historical balances are
|
||||
what you would see on a bank statement for that account (unless
|
||||
disturbed by a filter query). Period balances ignore transactions
|
||||
before the report start date, so they show the change in balance during
|
||||
the report period. They are more useful eg when viewing a time log.
|
||||
|
||||
`U' toggles filtering by unmarked status, including or excluding
|
||||
unmarked postings in the balances. Similarly, `P' toggles pending
|
||||
postings, and `C' toggles cleared postings. (By default, balances
|
||||
'U' toggles filtering by unmarked status, including or excluding
|
||||
unmarked postings in the balances. Similarly, 'P' toggles pending
|
||||
postings, and 'C' toggles cleared postings. (By default, balances
|
||||
include all postings; if you activate one or two status filters, only
|
||||
those postings are included; and if you activate all three, the filter
|
||||
is removed.)
|
||||
|
||||
`R' toggles real mode, in which virtual postings are ignored.
|
||||
'R' toggles real mode, in which virtual postings are ignored.
|
||||
|
||||
`Z' toggles nonzero mode, in which only accounts with nonzero
|
||||
'Z' toggles nonzero mode, in which only accounts with nonzero
|
||||
balances are shown (hledger-ui shows zero items by default, unlike
|
||||
command-line hledger).
|
||||
|
||||
Press `RIGHT' to view an account's transactions register.
|
||||
Press 'RIGHT' to view an account's transactions register.
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: Register screen, Next: Transaction screen, Prev: Accounts screen, Up: SCREENS
|
||||
@ -413,46 +415,44 @@ File: hledger-ui.info, Node: Register screen, Next: Transaction screen, Prev:
|
||||
===================
|
||||
|
||||
This screen shows the transactions affecting a particular account, like
|
||||
a check register. Each line represents one transaction and shows:
|
||||
a check register. Each line represents one transaction and shows:
|
||||
|
||||
* the other account(s) involved, in abbreviated form. (If there are
|
||||
both real and virtual postings, it shows only the accounts
|
||||
affected by real postings.)
|
||||
* the other account(s) involved, in abbreviated form. (If there are
|
||||
both real and virtual postings, it shows only the accounts affected
|
||||
by real postings.)
|
||||
|
||||
* the overall change to the current account's balance; positive for
|
||||
an inflow to this account, negative for an outflow.
|
||||
|
||||
* the running historical total or period total for the current
|
||||
account, after the transaction. This can be toggled with `H'.
|
||||
Similar to the accounts screen, the historical total is affected
|
||||
by transactions (filtered by the filter query) before the report
|
||||
start date, while the period total is not. If the historical total
|
||||
is not disturbed by a filter query, it will be the running
|
||||
historical balance you would see on a bank register for the
|
||||
current account.
|
||||
|
||||
account, after the transaction. This can be toggled with 'H'.
|
||||
Similar to the accounts screen, the historical total is affected by
|
||||
transactions (filtered by the filter query) before the report start
|
||||
date, while the period total is not. If the historical total is
|
||||
not disturbed by a filter query, it will be the running historical
|
||||
balance you would see on a bank register for the current account.
|
||||
|
||||
Transactions affecting this account's subaccounts will be included in
|
||||
the register if the accounts screen is in tree mode, or if it's in list
|
||||
mode but this account has subaccounts which are not shown due to a depth
|
||||
limit. In other words, the register always shows the transactions
|
||||
contributing to the balance shown on the accounts screen. Tree mode/list
|
||||
mode can be toggled with `t' here also.
|
||||
limit. In other words, the register always shows the transactions
|
||||
contributing to the balance shown on the accounts screen. Tree
|
||||
mode/list mode can be toggled with 't' here also.
|
||||
|
||||
`U' toggles filtering by unmarked status, showing or hiding unmarked
|
||||
transactions. Similarly, `P' toggles pending transactions, and `C'
|
||||
toggles cleared transactions. (By default, transactions with all
|
||||
'U' toggles filtering by unmarked status, showing or hiding unmarked
|
||||
transactions. Similarly, 'P' toggles pending transactions, and 'C'
|
||||
toggles cleared transactions. (By default, transactions with all
|
||||
statuses are shown; if you activate one or two status filters, only
|
||||
those transactions are shown; and if you activate all three, the filter
|
||||
is removed.)
|
||||
|
||||
`R' toggles real mode, in which virtual postings are ignored.
|
||||
'R' toggles real mode, in which virtual postings are ignored.
|
||||
|
||||
`Z' toggles nonzero mode, in which only transactions posting a
|
||||
'Z' toggles nonzero mode, in which only transactions posting a
|
||||
nonzero change are shown (hledger-ui shows zero items by default, unlike
|
||||
command-line hledger).
|
||||
|
||||
Press `RIGHT' to view the selected transaction in detail.
|
||||
Press 'RIGHT' to view the selected transaction in detail.
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: Transaction screen, Next: Error screen, Prev: Register screen, Up: SCREENS
|
||||
@ -469,11 +469,11 @@ description, comments, along with all of its account postings are shown.
|
||||
Simple transactions have two postings, but there can be more (or in
|
||||
certain cases, fewer).
|
||||
|
||||
`UP' and `DOWN' will step through all transactions listed in the
|
||||
previous account register screen. In the title bar, the numbers in
|
||||
parentheses show your position within that account register. They will
|
||||
'UP' and 'DOWN' will step through all transactions listed in the
|
||||
previous account register screen. In the title bar, the numbers in
|
||||
parentheses show your position within that account register. They will
|
||||
vary depending on which account register you came from (remember most
|
||||
transactions appear in multiple account registers). The #N number
|
||||
transactions appear in multiple account registers). The #N number
|
||||
preceding them is the transaction's position within the complete
|
||||
unfiltered journal, which is a more stable id (at least until the next
|
||||
reload).
|
||||
@ -485,8 +485,8 @@ File: hledger-ui.info, Node: Error screen, Prev: Transaction screen, Up: SCRE
|
||||
================
|
||||
|
||||
This screen will appear if there is a problem, such as a parse error,
|
||||
when you press g to reload. Once you have fixed the problem, press g
|
||||
again to reload and resume normal operation. (Or, you can press escape
|
||||
when you press g to reload. Once you have fixed the problem, press g
|
||||
again to reload and resume normal operation. (Or, you can press escape
|
||||
to cancel the reload attempt.)
|
||||
|
||||
|
||||
@ -506,21 +506,20 @@ File: hledger-ui.info, Node: Watch mode, Next: Watch mode limitations, Up: TI
|
||||
5.1 Watch mode
|
||||
==============
|
||||
|
||||
One of hledger-ui's best features is the auto-reloading `--watch' mode.
|
||||
With this flag, it will update the display automatically whenever
|
||||
One of hledger-ui's best features is the auto-reloading '-w/--watch'
|
||||
mode. With this flag, it will update the display automatically whenever
|
||||
changes are saved to the data files.
|
||||
|
||||
This is very useful when reconciling. A good workflow is to have your
|
||||
bank's online register open in a browser window, for reference; the
|
||||
This is very useful when reconciling. A good workflow is to have
|
||||
your bank's online register open in a browser window, for reference; the
|
||||
journal file open in an editor window; and hledger-ui in watch mode in a
|
||||
terminal window, eg:
|
||||
|
||||
|
||||
$ hledger-ui --watch --register checking -C
|
||||
|
||||
As you mark things cleared in the editor, you can see the effect
|
||||
immediately without having to context switch. This leaves more mental
|
||||
bandwidth for your accounting. Of course you can still interact with
|
||||
immediately without having to context switch. This leaves more mental
|
||||
bandwidth for your accounting. Of course you can still interact with
|
||||
hledger-ui when needed, eg to toggle cleared mode, or to explore the
|
||||
history.
|
||||
|
||||
@ -531,29 +530,28 @@ File: hledger-ui.info, Node: Watch mode limitations, Prev: Watch mode, Up: TI
|
||||
==========================
|
||||
|
||||
There are situations in which it won't work, ie the display will not
|
||||
update when you save a change (because the underlying `inotify' library
|
||||
does not support it). Here are some that we know of:
|
||||
update when you save a change (because the underlying 'inotify' library
|
||||
does not support it). Here are some that we know of:
|
||||
|
||||
* Certain editors: saving with `gedit', and perhaps any Gnome
|
||||
application, won't be detected (#1617). Jetbrains IDEs, such as
|
||||
* Certain editors: saving with 'gedit', and perhaps any Gnome
|
||||
application, won't be detected (#1617). Jetbrains IDEs, such as
|
||||
IDEA, also may not work (#911).
|
||||
|
||||
* Certain unusual filesystems might not be supported. (All the usual
|
||||
* Certain unusual filesystems might not be supported. (All the usual
|
||||
ones on unix, mac and windows are supported.)
|
||||
|
||||
|
||||
In such cases, the workaround is to switch to the hledger-ui window
|
||||
and press `g' each time you want it to reload. (Actually, see #1617 for
|
||||
and press 'g' each time you want it to reload. (Actually, see #1617 for
|
||||
another workaround, and let us know if it works for you.)
|
||||
|
||||
If you leave `hledger-ui --watch' running for days, on certain
|
||||
If you leave 'hledger-ui --watch' running for days, on certain
|
||||
platforms (?), perhaps with many transactions in your journal (?),
|
||||
perhaps with large numbers of other files present (?), you may see it
|
||||
gradually using more and more memory and CPU over time, as seen in
|
||||
`top' or Activity Monitor or Task Manager.
|
||||
gradually using more and more memory and CPU over time, as seen in 'top'
|
||||
or Activity Monitor or Task Manager.
|
||||
|
||||
A workaround is to `q'uit and restart it, or to suspend it
|
||||
(`CTRL-z') and restart it (`fg') if your shell supports that.
|
||||
A workaround is to 'q'uit and restart it, or to suspend it ('CTRL-z')
|
||||
and restart it ('fg') if your shell supports that.
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: ENVIRONMENT, Next: FILES, Prev: TIPS, Up: Top
|
||||
@ -561,28 +559,27 @@ File: hledger-ui.info, Node: ENVIRONMENT, Next: FILES, Prev: TIPS, Up: Top
|
||||
6 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: `~/.hledger.journal' (on windows, perhaps
|
||||
`C:/Users/USER/.hledger.journal').
|
||||
*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
|
||||
version-controlled finance directory and YYYY is the current year. Or
|
||||
`~/DIR/current.journal', where current.journal is a symbolic link to
|
||||
A typical value is '~/DIR/YYYY.journal', where DIR is a
|
||||
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 thorough way that also affects applications started from the
|
||||
GUI (say, an Emacs dock icon). Eg on MacOS Catalina I have a
|
||||
`~/.MacOSX/environment.plist' file containing
|
||||
|
||||
On Mac computers, you can set this and other environment variables in
|
||||
a more thorough way that also affects applications started from the GUI
|
||||
(say, an Emacs dock icon). Eg on MacOS Catalina I have a
|
||||
'~/.MacOSX/environment.plist' file containing
|
||||
|
||||
{
|
||||
"LEDGER_FILE" : "~/finance/current.journal"
|
||||
}
|
||||
|
||||
To see the effect you may need to `killall Dock', or reboot.
|
||||
To see the effect you may need to 'killall Dock', or reboot.
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top
|
||||
@ -591,9 +588,9 @@ File: hledger-ui.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top
|
||||
*******
|
||||
|
||||
Reads data from one or more files in hledger journal, timeclock,
|
||||
timedot, or CSV format specified with `-f', or `$LEDGER_FILE', or
|
||||
`$HOME/.hledger.journal' (on windows, perhaps
|
||||
`C:/Users/USER/.hledger.journal').
|
||||
timedot, or CSV format specified with '-f', or '$LEDGER_FILE', or
|
||||
'$HOME/.hledger.journal' (on windows, perhaps
|
||||
'C:/Users/USER/.hledger.journal').
|
||||
|
||||
|
||||
File: hledger-ui.info, Node: BUGS, Prev: FILES, Up: Top
|
||||
@ -601,18 +598,18 @@ File: hledger-ui.info, Node: BUGS, Prev: FILES, Up: Top
|
||||
8 BUGS
|
||||
******
|
||||
|
||||
The need to precede options with `--' when invoked from hledger is
|
||||
The need to precede options with '--' when invoked from hledger is
|
||||
awkward.
|
||||
|
||||
`-f-' doesn't work (hledger-ui can't read from stdin).
|
||||
'-f-' doesn't work (hledger-ui can't read from stdin).
|
||||
|
||||
`-V' affects only the accounts screen.
|
||||
'-V' affects only the accounts screen.
|
||||
|
||||
When you press `g', the current and all previous screens are
|
||||
regenerated, which may cause a noticeable pause with large files. Also
|
||||
When you press 'g', the current and all previous screens are
|
||||
regenerated, which may cause a noticeable pause with large files. Also
|
||||
there is no visual indication that this is in progress.
|
||||
|
||||
`--watch' is not yet fully robust. It works well for normal usage,
|
||||
'--watch' is not yet fully robust. It works well for normal usage,
|
||||
but many file changes in a short time (eg saving the file thousands of
|
||||
times with an editor macro) can cause problems at least on OSX. Symptoms
|
||||
include: unresponsive UI, periodic resetting of the cursor position,
|
||||
@ -621,39 +618,43 @@ and possibly a small but persistent build-up of CPU usage until the
|
||||
program is restarted.
|
||||
|
||||
Also, if you are viewing files mounted from another machine,
|
||||
`--watch' requires that both machine clocks are roughly in step.
|
||||
|
||||
'-w/--watch' requires that both machine clocks are roughly in step.
|
||||
|
||||
|
||||
Tag Table:
|
||||
Node: Top232
|
||||
Node: OPTIONS1647
|
||||
Ref: #options1745
|
||||
Node: MOUSE6617
|
||||
Ref: #mouse6712
|
||||
Node: KEYS6996
|
||||
Ref: #keys7089
|
||||
Node: SCREENS11150
|
||||
Ref: #screens11248
|
||||
Node: Accounts screen11338
|
||||
Ref: #accounts-screen11466
|
||||
Node: Register screen13659
|
||||
Ref: #register-screen13814
|
||||
Node: Transaction screen15796
|
||||
Ref: #transaction-screen15954
|
||||
Node: Error screen16821
|
||||
Ref: #error-screen16943
|
||||
Node: TIPS17185
|
||||
Ref: #tips17284
|
||||
Node: Watch mode17336
|
||||
Ref: #watch-mode17453
|
||||
Node: Watch mode limitations18197
|
||||
Ref: #watch-mode-limitations18338
|
||||
Node: ENVIRONMENT19471
|
||||
Ref: #environment19582
|
||||
Node: FILES20387
|
||||
Ref: #files20486
|
||||
Node: BUGS20699
|
||||
Ref: #bugs20776
|
||||
Node: Top221
|
||||
Node: OPTIONS1657
|
||||
Ref: #options1755
|
||||
Node: MOUSE6637
|
||||
Ref: #mouse6732
|
||||
Node: KEYS7014
|
||||
Ref: #keys7107
|
||||
Node: SCREENS11193
|
||||
Ref: #screens11291
|
||||
Node: Accounts screen11381
|
||||
Ref: #accounts-screen11509
|
||||
Node: Register screen13713
|
||||
Ref: #register-screen13868
|
||||
Node: Transaction screen15852
|
||||
Ref: #transaction-screen16010
|
||||
Node: Error screen16880
|
||||
Ref: #error-screen17002
|
||||
Node: TIPS17246
|
||||
Ref: #tips17345
|
||||
Node: Watch mode17397
|
||||
Ref: #watch-mode17514
|
||||
Node: Watch mode limitations18264
|
||||
Ref: #watch-mode-limitations18405
|
||||
Node: ENVIRONMENT19541
|
||||
Ref: #environment19652
|
||||
Node: FILES20459
|
||||
Ref: #files20558
|
||||
Node: BUGS20771
|
||||
Ref: #bugs20848
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
Local Variables:
|
||||
coding: utf-8
|
||||
End:
|
||||
|
||||
@ -41,7 +41,7 @@ OPTIONS
|
||||
Any QUERYARGS are interpreted as a hledger search query which filters
|
||||
the data.
|
||||
|
||||
--watch
|
||||
-w --watch
|
||||
watch for data and date changes and reload automatically
|
||||
|
||||
--theme=default|terminal|greenterm
|
||||
@ -242,10 +242,10 @@ KEYS
|
||||
DOWN/UP steps downward and upward through these standard report period
|
||||
durations: year, quarter, month, week, day. Then, SHIFT-LEFT/RIGHT
|
||||
moves to the previous/next period. T sets the report period to today.
|
||||
With the --watch option, when viewing a "current" period (the current
|
||||
day, week, month, quarter, or year), the period will move automatically
|
||||
to track the current date. To set a non-standard period, you can use /
|
||||
and a date: query.
|
||||
With the -w/--watch option, when viewing a "current" period (the cur-
|
||||
rent day, week, month, quarter, or year), the period will move automat-
|
||||
ically to track the current date. To set a non-standard period, you
|
||||
can use / and a date: query.
|
||||
|
||||
/ lets you set a general filter query limiting the data shown, using
|
||||
the same query terms as in hledger and hledger-web. While editing the
|
||||
@ -417,9 +417,9 @@ SCREENS
|
||||
|
||||
TIPS
|
||||
Watch mode
|
||||
One of hledger-ui's best features is the auto-reloading --watch mode.
|
||||
With this flag, it will update the display automatically whenever
|
||||
changes are saved to the data files.
|
||||
One of hledger-ui's best features is the auto-reloading -w/--watch
|
||||
mode. With this flag, it will update the display automatically when-
|
||||
ever changes are saved to the data files.
|
||||
|
||||
This is very useful when reconciling. A good workflow is to have your
|
||||
bank's online register open in a browser window, for reference; the
|
||||
@ -507,7 +507,7 @@ BUGS
|
||||
siding, and possibly a small but persistent build-up of CPU usage until
|
||||
the program is restarted.
|
||||
|
||||
Also, if you are viewing files mounted from another machine, --watch
|
||||
Also, if you are viewing files mounted from another machine, -w/--watch
|
||||
requires that both machine clocks are roughly in step.
|
||||
|
||||
|
||||
|
||||
@ -6817,7 +6817,7 @@ And here is an overview of which directives are useful for what:
|
||||
.PP
|
||||
.TS
|
||||
tab(@);
|
||||
lw(33.4n) lw(19.4n) lw(17.3n).
|
||||
lw(31.0n) lw(21.8n) lw(17.2n).
|
||||
T{
|
||||
purpose
|
||||
T}@T{
|
||||
@ -6894,6 +6894,10 @@ T}@T{
|
||||
T}@T{
|
||||
\f[C]-c/--commodity-style\f[R]
|
||||
T}
|
||||
T{
|
||||
T}@T{
|
||||
T}@T{
|
||||
T}
|
||||
.TE
|
||||
.SS Directives and multiple files
|
||||
.PP
|
||||
|
||||
@ -5861,31 +5861,30 @@ account'*following entries until end of current file or 'end apply
|
||||
|
||||
And here is an overview of which directives are useful for what:
|
||||
|
||||
purpose directives command line
|
||||
options with
|
||||
similar effect
|
||||
----------------------------------------------------------------------------
|
||||
purpose directives command line
|
||||
options with
|
||||
similar effect
|
||||
---------------------------------------------------------------------------
|
||||
*READING/GENERATING DATA:*
|
||||
Declaring a commodity's or file's 'commodity', 'D',
|
||||
decimal mark to help parse 'decimal-mark'
|
||||
amounts accurately
|
||||
Applying changes to the data 'alias', 'apply '--alias'
|
||||
while parsing account',
|
||||
'comment', 'D',
|
||||
'Y'
|
||||
Inlining or concatenating extra 'include' multiple
|
||||
data files '-f/--file''s
|
||||
Generating extra transactions or '~'
|
||||
budget goals
|
||||
Generating extra postings '='
|
||||
Declaring a commodity's or 'commodity', 'D',
|
||||
file's decimal mark to help 'decimal-mark'
|
||||
parse amounts accurately
|
||||
Applying changes to the data 'alias', 'apply '--alias'
|
||||
while parsing account', 'comment',
|
||||
'D', 'Y'
|
||||
Inlining or concatenating 'include' multiple
|
||||
extra data files '-f/--file''s
|
||||
Generating extra transactions '~'
|
||||
or budget goals
|
||||
Generating extra postings '='
|
||||
*CHECKING FOR ERRORS:*
|
||||
Defining valid entities to allow 'account',
|
||||
stricter error checking 'commodity',
|
||||
'payee'
|
||||
Defining valid entities to 'account',
|
||||
allow stricter error checking 'commodity', 'payee'
|
||||
*DISPLAYING REPORTS:*
|
||||
Defining accounts' display order 'account'
|
||||
and accounting type
|
||||
Defining commodity display styles 'commodity', 'D' '-c/--commodity-style'
|
||||
Defining accounts' display 'account'
|
||||
order and accounting type
|
||||
Defining commodity display 'commodity', 'D' '-c/--commodity-style'
|
||||
styles
|
||||
|
||||
|
||||
File: hledger.info, Node: Directives and multiple files, Next: Comment blocks, Prev: Directives, Up: JOURNAL FORMAT
|
||||
@ -9337,196 +9336,196 @@ Node: Balance assignments and prices211022
|
||||
Ref: #balance-assignments-and-prices211188
|
||||
Node: Directives211412
|
||||
Ref: #directives211575
|
||||
Node: Directives and multiple files216097
|
||||
Ref: #directives-and-multiple-files216293
|
||||
Node: Comment blocks216985
|
||||
Ref: #comment-blocks217162
|
||||
Node: Including other files217338
|
||||
Ref: #including-other-files217512
|
||||
Node: Default year218436
|
||||
Ref: #default-year218594
|
||||
Node: Declaring payees219001
|
||||
Ref: #declaring-payees219172
|
||||
Node: Declaring the decimal mark219418
|
||||
Ref: #declaring-the-decimal-mark219618
|
||||
Node: Declaring commodities220015
|
||||
Ref: #declaring-commodities220206
|
||||
Node: Commodity error checking222724
|
||||
Ref: #commodity-error-checking222874
|
||||
Node: Default commodity223131
|
||||
Ref: #default-commodity223311
|
||||
Node: Declaring market prices224427
|
||||
Ref: #declaring-market-prices224616
|
||||
Node: Declaring accounts225429
|
||||
Ref: #declaring-accounts225609
|
||||
Node: Account error checking226811
|
||||
Ref: #account-error-checking226977
|
||||
Node: Account comments228156
|
||||
Ref: #account-comments228340
|
||||
Node: Account subdirectives228764
|
||||
Ref: #account-subdirectives228949
|
||||
Node: Account types229262
|
||||
Ref: #account-types229436
|
||||
Node: Declaring account types230094
|
||||
Ref: #declaring-account-types230273
|
||||
Node: Auto-detected account types231327
|
||||
Ref: #auto-detected-account-types231514
|
||||
Node: Account display order233532
|
||||
Ref: #account-display-order233692
|
||||
Node: Rewriting accounts234843
|
||||
Ref: #rewriting-accounts235022
|
||||
Node: Basic aliases235779
|
||||
Ref: #basic-aliases235915
|
||||
Node: Regex aliases236659
|
||||
Ref: #regex-aliases236821
|
||||
Node: Combining aliases237540
|
||||
Ref: #combining-aliases237723
|
||||
Node: Aliases and multiple files238999
|
||||
Ref: #aliases-and-multiple-files239198
|
||||
Node: end aliases239777
|
||||
Ref: #end-aliases239924
|
||||
Node: Default parent account240073
|
||||
Ref: #default-parent-account240263
|
||||
Node: Periodic transactions241147
|
||||
Ref: #periodic-transactions241330
|
||||
Node: Periodic rule syntax243247
|
||||
Ref: #periodic-rule-syntax243447
|
||||
Node: Two spaces between period expression and description!244151
|
||||
Ref: #two-spaces-between-period-expression-and-description244464
|
||||
Node: Forecasting with periodic transactions245148
|
||||
Ref: #forecasting-with-periodic-transactions245447
|
||||
Node: Budgeting with periodic transactions248218
|
||||
Ref: #budgeting-with-periodic-transactions248451
|
||||
Node: Auto postings248860
|
||||
Ref: #auto-postings248996
|
||||
Node: Auto postings and multiple files251175
|
||||
Ref: #auto-postings-and-multiple-files251373
|
||||
Node: Auto postings and dates251582
|
||||
Ref: #auto-postings-and-dates251850
|
||||
Node: Auto postings and transaction balancing / inferred amounts / balance assertions252025
|
||||
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions252370
|
||||
Node: Auto posting tags252873
|
||||
Ref: #auto-posting-tags253082
|
||||
Node: CSV FORMAT253718
|
||||
Ref: #csv-format253846
|
||||
Node: Examples256475
|
||||
Ref: #examples256578
|
||||
Node: Basic256786
|
||||
Ref: #basic256888
|
||||
Node: Bank of Ireland257430
|
||||
Ref: #bank-of-ireland257567
|
||||
Node: Amazon259029
|
||||
Ref: #amazon259149
|
||||
Node: Paypal260868
|
||||
Ref: #paypal260964
|
||||
Node: CSV rules268608
|
||||
Ref: #csv-rules268726
|
||||
Node: skip269059
|
||||
Ref: #skip269159
|
||||
Node: fields list269534
|
||||
Ref: #fields-list269673
|
||||
Node: field assignment271176
|
||||
Ref: #field-assignment271328
|
||||
Node: Field names272363
|
||||
Ref: #field-names272503
|
||||
Node: date field272883
|
||||
Ref: #date-field273003
|
||||
Node: date2 field273051
|
||||
Ref: #date2-field273194
|
||||
Node: status field273250
|
||||
Ref: #status-field273395
|
||||
Node: code field273444
|
||||
Ref: #code-field273591
|
||||
Node: description field273636
|
||||
Ref: #description-field273798
|
||||
Node: comment field273857
|
||||
Ref: #comment-field274014
|
||||
Node: account field274314
|
||||
Ref: #account-field274466
|
||||
Node: amount field275041
|
||||
Ref: #amount-field275192
|
||||
Node: currency field276437
|
||||
Ref: #currency-field276592
|
||||
Node: balance field276849
|
||||
Ref: #balance-field276983
|
||||
Node: separator277355
|
||||
Ref: #separator277487
|
||||
Node: if block278027
|
||||
Ref: #if-block278154
|
||||
Node: Matching the whole record278555
|
||||
Ref: #matching-the-whole-record278732
|
||||
Node: Matching individual fields279535
|
||||
Ref: #matching-individual-fields279741
|
||||
Node: Combining matchers279965
|
||||
Ref: #combining-matchers280163
|
||||
Node: Rules applied on successful match280476
|
||||
Ref: #rules-applied-on-successful-match280669
|
||||
Node: if table281323
|
||||
Ref: #if-table281444
|
||||
Node: end283182
|
||||
Ref: #end283296
|
||||
Node: date-format283520
|
||||
Ref: #date-format283654
|
||||
Node: decimal-mark284650
|
||||
Ref: #decimal-mark284797
|
||||
Node: newest-first285136
|
||||
Ref: #newest-first285279
|
||||
Node: include285962
|
||||
Ref: #include286095
|
||||
Node: balance-type286539
|
||||
Ref: #balance-type286661
|
||||
Node: Tips287361
|
||||
Ref: #tips287452
|
||||
Node: Rapid feedback287751
|
||||
Ref: #rapid-feedback287870
|
||||
Node: Valid CSV288322
|
||||
Ref: #valid-csv288454
|
||||
Node: File Extension288646
|
||||
Ref: #file-extension288800
|
||||
Node: Reading multiple CSV files289229
|
||||
Ref: #reading-multiple-csv-files289416
|
||||
Node: Valid transactions289657
|
||||
Ref: #valid-transactions289837
|
||||
Node: Deduplicating importing290465
|
||||
Ref: #deduplicating-importing290646
|
||||
Node: Setting amounts291679
|
||||
Ref: #setting-amounts291836
|
||||
Node: Amount signs294277
|
||||
Ref: #amount-signs294431
|
||||
Node: Setting currency/commodity295118
|
||||
Ref: #setting-currencycommodity295306
|
||||
Node: Amount decimal places296480
|
||||
Ref: #amount-decimal-places296672
|
||||
Node: Referencing other fields296984
|
||||
Ref: #referencing-other-fields297183
|
||||
Node: How CSV rules are evaluated298080
|
||||
Ref: #how-csv-rules-are-evaluated298255
|
||||
Node: TIMECLOCK FORMAT299706
|
||||
Ref: #timeclock-format299846
|
||||
Node: TIMEDOT FORMAT301907
|
||||
Ref: #timedot-format302045
|
||||
Node: COMMON TASKS306607
|
||||
Ref: #common-tasks306736
|
||||
Node: Getting help307143
|
||||
Ref: #getting-help307277
|
||||
Node: Constructing command lines307830
|
||||
Ref: #constructing-command-lines308024
|
||||
Node: Starting a journal file308721
|
||||
Ref: #starting-a-journal-file308921
|
||||
Node: Setting opening balances310109
|
||||
Ref: #setting-opening-balances310307
|
||||
Node: Recording transactions313448
|
||||
Ref: #recording-transactions313630
|
||||
Node: Reconciling314186
|
||||
Ref: #reconciling314331
|
||||
Node: Reporting316588
|
||||
Ref: #reporting316730
|
||||
Node: Migrating to a new file320729
|
||||
Ref: #migrating-to-a-new-file320879
|
||||
Node: LIMITATIONS321178
|
||||
Ref: #limitations321306
|
||||
Node: TROUBLESHOOTING322049
|
||||
Ref: #troubleshooting322164
|
||||
Node: Directives and multiple files216012
|
||||
Ref: #directives-and-multiple-files216208
|
||||
Node: Comment blocks216900
|
||||
Ref: #comment-blocks217077
|
||||
Node: Including other files217253
|
||||
Ref: #including-other-files217427
|
||||
Node: Default year218351
|
||||
Ref: #default-year218509
|
||||
Node: Declaring payees218916
|
||||
Ref: #declaring-payees219087
|
||||
Node: Declaring the decimal mark219333
|
||||
Ref: #declaring-the-decimal-mark219533
|
||||
Node: Declaring commodities219930
|
||||
Ref: #declaring-commodities220121
|
||||
Node: Commodity error checking222639
|
||||
Ref: #commodity-error-checking222789
|
||||
Node: Default commodity223046
|
||||
Ref: #default-commodity223226
|
||||
Node: Declaring market prices224342
|
||||
Ref: #declaring-market-prices224531
|
||||
Node: Declaring accounts225344
|
||||
Ref: #declaring-accounts225524
|
||||
Node: Account error checking226726
|
||||
Ref: #account-error-checking226892
|
||||
Node: Account comments228071
|
||||
Ref: #account-comments228255
|
||||
Node: Account subdirectives228679
|
||||
Ref: #account-subdirectives228864
|
||||
Node: Account types229177
|
||||
Ref: #account-types229351
|
||||
Node: Declaring account types230009
|
||||
Ref: #declaring-account-types230188
|
||||
Node: Auto-detected account types231242
|
||||
Ref: #auto-detected-account-types231429
|
||||
Node: Account display order233447
|
||||
Ref: #account-display-order233607
|
||||
Node: Rewriting accounts234758
|
||||
Ref: #rewriting-accounts234937
|
||||
Node: Basic aliases235694
|
||||
Ref: #basic-aliases235830
|
||||
Node: Regex aliases236574
|
||||
Ref: #regex-aliases236736
|
||||
Node: Combining aliases237455
|
||||
Ref: #combining-aliases237638
|
||||
Node: Aliases and multiple files238914
|
||||
Ref: #aliases-and-multiple-files239113
|
||||
Node: end aliases239692
|
||||
Ref: #end-aliases239839
|
||||
Node: Default parent account239988
|
||||
Ref: #default-parent-account240178
|
||||
Node: Periodic transactions241062
|
||||
Ref: #periodic-transactions241245
|
||||
Node: Periodic rule syntax243162
|
||||
Ref: #periodic-rule-syntax243362
|
||||
Node: Two spaces between period expression and description!244066
|
||||
Ref: #two-spaces-between-period-expression-and-description244379
|
||||
Node: Forecasting with periodic transactions245063
|
||||
Ref: #forecasting-with-periodic-transactions245362
|
||||
Node: Budgeting with periodic transactions248133
|
||||
Ref: #budgeting-with-periodic-transactions248366
|
||||
Node: Auto postings248775
|
||||
Ref: #auto-postings248911
|
||||
Node: Auto postings and multiple files251090
|
||||
Ref: #auto-postings-and-multiple-files251288
|
||||
Node: Auto postings and dates251497
|
||||
Ref: #auto-postings-and-dates251765
|
||||
Node: Auto postings and transaction balancing / inferred amounts / balance assertions251940
|
||||
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions252285
|
||||
Node: Auto posting tags252788
|
||||
Ref: #auto-posting-tags252997
|
||||
Node: CSV FORMAT253633
|
||||
Ref: #csv-format253761
|
||||
Node: Examples256390
|
||||
Ref: #examples256493
|
||||
Node: Basic256701
|
||||
Ref: #basic256803
|
||||
Node: Bank of Ireland257345
|
||||
Ref: #bank-of-ireland257482
|
||||
Node: Amazon258944
|
||||
Ref: #amazon259064
|
||||
Node: Paypal260783
|
||||
Ref: #paypal260879
|
||||
Node: CSV rules268523
|
||||
Ref: #csv-rules268641
|
||||
Node: skip268974
|
||||
Ref: #skip269074
|
||||
Node: fields list269449
|
||||
Ref: #fields-list269588
|
||||
Node: field assignment271091
|
||||
Ref: #field-assignment271243
|
||||
Node: Field names272278
|
||||
Ref: #field-names272418
|
||||
Node: date field272798
|
||||
Ref: #date-field272918
|
||||
Node: date2 field272966
|
||||
Ref: #date2-field273109
|
||||
Node: status field273165
|
||||
Ref: #status-field273310
|
||||
Node: code field273359
|
||||
Ref: #code-field273506
|
||||
Node: description field273551
|
||||
Ref: #description-field273713
|
||||
Node: comment field273772
|
||||
Ref: #comment-field273929
|
||||
Node: account field274229
|
||||
Ref: #account-field274381
|
||||
Node: amount field274956
|
||||
Ref: #amount-field275107
|
||||
Node: currency field276352
|
||||
Ref: #currency-field276507
|
||||
Node: balance field276764
|
||||
Ref: #balance-field276898
|
||||
Node: separator277270
|
||||
Ref: #separator277402
|
||||
Node: if block277942
|
||||
Ref: #if-block278069
|
||||
Node: Matching the whole record278470
|
||||
Ref: #matching-the-whole-record278647
|
||||
Node: Matching individual fields279450
|
||||
Ref: #matching-individual-fields279656
|
||||
Node: Combining matchers279880
|
||||
Ref: #combining-matchers280078
|
||||
Node: Rules applied on successful match280391
|
||||
Ref: #rules-applied-on-successful-match280584
|
||||
Node: if table281238
|
||||
Ref: #if-table281359
|
||||
Node: end283097
|
||||
Ref: #end283211
|
||||
Node: date-format283435
|
||||
Ref: #date-format283569
|
||||
Node: decimal-mark284565
|
||||
Ref: #decimal-mark284712
|
||||
Node: newest-first285051
|
||||
Ref: #newest-first285194
|
||||
Node: include285877
|
||||
Ref: #include286010
|
||||
Node: balance-type286454
|
||||
Ref: #balance-type286576
|
||||
Node: Tips287276
|
||||
Ref: #tips287367
|
||||
Node: Rapid feedback287666
|
||||
Ref: #rapid-feedback287785
|
||||
Node: Valid CSV288237
|
||||
Ref: #valid-csv288369
|
||||
Node: File Extension288561
|
||||
Ref: #file-extension288715
|
||||
Node: Reading multiple CSV files289144
|
||||
Ref: #reading-multiple-csv-files289331
|
||||
Node: Valid transactions289572
|
||||
Ref: #valid-transactions289752
|
||||
Node: Deduplicating importing290380
|
||||
Ref: #deduplicating-importing290561
|
||||
Node: Setting amounts291594
|
||||
Ref: #setting-amounts291751
|
||||
Node: Amount signs294192
|
||||
Ref: #amount-signs294346
|
||||
Node: Setting currency/commodity295033
|
||||
Ref: #setting-currencycommodity295221
|
||||
Node: Amount decimal places296395
|
||||
Ref: #amount-decimal-places296587
|
||||
Node: Referencing other fields296899
|
||||
Ref: #referencing-other-fields297098
|
||||
Node: How CSV rules are evaluated297995
|
||||
Ref: #how-csv-rules-are-evaluated298170
|
||||
Node: TIMECLOCK FORMAT299621
|
||||
Ref: #timeclock-format299761
|
||||
Node: TIMEDOT FORMAT301822
|
||||
Ref: #timedot-format301960
|
||||
Node: COMMON TASKS306522
|
||||
Ref: #common-tasks306651
|
||||
Node: Getting help307058
|
||||
Ref: #getting-help307192
|
||||
Node: Constructing command lines307745
|
||||
Ref: #constructing-command-lines307939
|
||||
Node: Starting a journal file308636
|
||||
Ref: #starting-a-journal-file308836
|
||||
Node: Setting opening balances310024
|
||||
Ref: #setting-opening-balances310222
|
||||
Node: Recording transactions313363
|
||||
Ref: #recording-transactions313545
|
||||
Node: Reconciling314101
|
||||
Ref: #reconciling314246
|
||||
Node: Reporting316503
|
||||
Ref: #reporting316645
|
||||
Node: Migrating to a new file320644
|
||||
Ref: #migrating-to-a-new-file320794
|
||||
Node: LIMITATIONS321093
|
||||
Ref: #limitations321221
|
||||
Node: TROUBLESHOOTING321964
|
||||
Ref: #troubleshooting322079
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user