mirror of
https://github.com/simonmichael/hledger.git
synced 2024-11-08 07:09:28 +03:00
doc: bump version to 1.3, update builtin manuals
This commit is contained in:
Simon Michael
parent
50efcfe359
commit
c4248072db
@ -8,7 +8,7 @@ m4_define({{_webcombined_}}, m4_ifdef({{WEB && COMBINED}},{{$1}}) )m4_dnl
|
||||
m4_dnl
|
||||
m4_define({{_author_}}, {{}})m4_dnl
|
||||
m4_define({{_monthyear_}}, {{June 2017}})m4_dnl
|
||||
m4_define({{_version_}}, {{1.2.98}})m4_dnl
|
||||
m4_define({{_version_}}, {{1.3}})m4_dnl
|
||||
m4_dnl
|
||||
m4_dnl Links to dev and recent release versions of a manual.
|
||||
m4_dnl $1 is the manual's web slug: hledger, hledger-ui, journal, csv etc.
|
||||
@ -20,6 +20,7 @@ This doc is for version **_version_**.
|
||||
m4_dnl Too painful for static generation, insert from site.js instead
|
||||
m4_dnl Available versions:
|
||||
m4_dnl <a href="/$1.html">dev</a>
|
||||
m4_dnl | <a href="/doc/1.3/$1.html">1.3</a>
|
||||
m4_dnl | <a href="/doc/1.2/$1.html">1.2</a>
|
||||
m4_dnl | <a href="/doc/1.1/$1.html">1.1</a>
|
||||
m4_dnl | <a href="/doc/1.0/$1.html">1.0</a>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger\-api" "1" "June 2017" "hledger\-api 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger\-api" "1" "June 2017" "hledger\-api 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -3,8 +3,8 @@ This is hledger-api.1.info, produced by makeinfo version 6.0 from stdin.
|
||||
|
||||
File: hledger-api.1.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||
|
||||
hledger-api(1) hledger-api 1.2.98
|
||||
*********************************
|
||||
hledger-api(1) hledger-api 1.3
|
||||
******************************
|
||||
|
||||
hledger-api is a simple web API server, intended to support client-side
|
||||
web apps operating on hledger data. It comes with a series of simple
|
||||
@ -73,7 +73,7 @@ options as shown above.
|
||||
|
||||
Tag Table:
|
||||
Node: Top74
|
||||
Node: OPTIONS1226
|
||||
Ref: #options1313
|
||||
Node: OPTIONS1220
|
||||
Ref: #options1307
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -107,4 +107,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger-api 1.2.98 June 2017 hledger-api(1)
|
||||
hledger-api 1.3 June 2017 hledger-api(1)
|
||||
|
||||
@ -35,12 +35,12 @@ import Text.Printf
|
||||
import Hledger.Query
|
||||
import Hledger.Cli hiding (Reader, version)
|
||||
|
||||
hledgerApiVersion="1.2.98"
|
||||
hledgerApiVersion="1.3"
|
||||
|
||||
-- https://github.com/docopt/docopt.hs#readme
|
||||
doc :: Docopt
|
||||
doc = [docopt|
|
||||
hledger-api 1.2.98
|
||||
hledger-api 1.3
|
||||
|
||||
Serves hledger data and reports as a JSON web API.
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger_csv" "5" "June 2017" "hledger 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger_csv" "5" "June 2017" "hledger 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -3,8 +3,8 @@ This is hledger_csv.5.info, produced by makeinfo version 6.0 from stdin.
|
||||
|
||||
File: hledger_csv.5.info, Node: Top, Next: CSV RULES, Up: (dir)
|
||||
|
||||
hledger_csv(5) hledger 1.2.98
|
||||
*****************************
|
||||
hledger_csv(5) hledger 1.3
|
||||
**************************
|
||||
|
||||
hledger can read CSV files, converting each CSV record into a journal
|
||||
entry (transaction), if you provide some conversion hints in a "rules
|
||||
@ -201,21 +201,21 @@ order of same-day entries will be preserved, usually.
|
||||
|
||||
Tag Table:
|
||||
Node: Top74
|
||||
Node: CSV RULES816
|
||||
Ref: #csv-rules926
|
||||
Node: skip1169
|
||||
Ref: #skip1265
|
||||
Node: date-format1437
|
||||
Ref: #date-format1566
|
||||
Node: field list2072
|
||||
Ref: #field-list2211
|
||||
Node: field assignment2916
|
||||
Ref: #field-assignment3073
|
||||
Node: conditional block3577
|
||||
Ref: #conditional-block3733
|
||||
Node: include4629
|
||||
Ref: #include4740
|
||||
Node: CSV TIPS4971
|
||||
Ref: #csv-tips5067
|
||||
Node: CSV RULES810
|
||||
Ref: #csv-rules920
|
||||
Node: skip1163
|
||||
Ref: #skip1259
|
||||
Node: date-format1431
|
||||
Ref: #date-format1560
|
||||
Node: field list2066
|
||||
Ref: #field-list2205
|
||||
Node: field assignment2910
|
||||
Ref: #field-assignment3067
|
||||
Node: conditional block3571
|
||||
Ref: #conditional-block3727
|
||||
Node: include4623
|
||||
Ref: #include4734
|
||||
Node: CSV TIPS4965
|
||||
Ref: #csv-tips5061
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -171,4 +171,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger 1.2.98 June 2017 hledger_csv(5)
|
||||
hledger 1.3 June 2017 hledger_csv(5)
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
.\"t
|
||||
|
||||
.TH "hledger_journal" "5" "June 2017" "hledger 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger_journal" "5" "June 2017" "hledger 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
@ -69,8 +69,8 @@ This can be followed by any of the following, separated by spaces:
|
||||
.IP \[bu] 2
|
||||
(optional) a status character (empty, \f[C]!\f[], or \f[C]*\f[])
|
||||
.IP \[bu] 2
|
||||
(optional) a transaction code (any short number or text, eg a check
|
||||
number)
|
||||
(optional) a transaction code (any short number or text, enclosed in
|
||||
parentheses)
|
||||
.IP \[bu] 2
|
||||
(optional) a transaction description (any remaining text until end of
|
||||
line)
|
||||
|
||||
@ -4,8 +4,8 @@ stdin.
|
||||
|
||||
File: hledger_journal.5.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
||||
|
||||
hledger_journal(5) hledger 1.2.98
|
||||
*********************************
|
||||
hledger_journal(5) hledger 1.3
|
||||
******************************
|
||||
|
||||
hledger's usual data source is a plain text file containing journal
|
||||
entries in hledger journal format. This file represents a standard
|
||||
@ -89,8 +89,8 @@ with a simple date in column 0. This can be followed by any of the
|
||||
following, separated by spaces:
|
||||
|
||||
* (optional) a status character (empty, '!', or '*')
|
||||
* (optional) a transaction code (any short number or text, eg a check
|
||||
number)
|
||||
* (optional) a transaction code (any short number or text, enclosed
|
||||
in parentheses)
|
||||
* (optional) a transaction description (any remaining text until end
|
||||
of line)
|
||||
|
||||
@ -1047,10 +1047,10 @@ Text Wrangler https://github.com/ledger/ledger/wiki/Editing-Ledger-files-wit
|
||||
|
||||
Tag Table:
|
||||
Node: Top78
|
||||
Node: FILE FORMAT2298
|
||||
Ref: #file-format2424
|
||||
Node: Transactions2631
|
||||
Ref: #transactions2754
|
||||
Node: FILE FORMAT2292
|
||||
Ref: #file-format2418
|
||||
Node: Transactions2625
|
||||
Ref: #transactions2748
|
||||
Node: Postings3313
|
||||
Ref: #postings3442
|
||||
Node: Dates4437
|
||||
|
||||
@ -60,8 +60,8 @@ FILE FORMAT
|
||||
|
||||
o (optional) a status character (empty, !, or *)
|
||||
|
||||
o (optional) a transaction code (any short number or text, eg a check
|
||||
number)
|
||||
o (optional) a transaction code (any short number or text, enclosed in
|
||||
parentheses)
|
||||
|
||||
o (optional) a transaction description (any remaining text until end of
|
||||
line)
|
||||
@ -835,4 +835,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger 1.2.98 June 2017 hledger_journal(5)
|
||||
hledger 1.3 June 2017 hledger_journal(5)
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger_timeclock" "5" "June 2017" "hledger 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger_timeclock" "5" "June 2017" "hledger 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -4,8 +4,8 @@ stdin.
|
||||
|
||||
File: hledger_timeclock.5.info, Node: Top, Up: (dir)
|
||||
|
||||
hledger_timeclock(5) hledger 1.2.98
|
||||
***********************************
|
||||
hledger_timeclock(5) hledger 1.3
|
||||
********************************
|
||||
|
||||
hledger can read timeclock files. As with Ledger, these are (a subset
|
||||
of) timeclock.el's format, containing clock-in and clock-out entries as
|
||||
|
||||
@ -79,4 +79,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger 1.2.98 June 2017 hledger_timeclock(5)
|
||||
hledger 1.3 June 2017 hledger_timeclock(5)
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger_timedot" "5" "June 2017" "hledger 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger_timedot" "5" "June 2017" "hledger 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -4,8 +4,8 @@ stdin.
|
||||
|
||||
File: hledger_timedot.5.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
||||
|
||||
hledger_timedot(5) hledger 1.2.98
|
||||
*********************************
|
||||
hledger_timedot(5) hledger 1.3
|
||||
******************************
|
||||
|
||||
Timedot is a plain text format for logging dated, categorised quantities
|
||||
(eg time), supported by hledger. It is convenient for approximate and
|
||||
@ -106,7 +106,7 @@ $ hledger -f t.timedot --alias /\\./=: bal date:2016/2/4
|
||||
|
||||
Tag Table:
|
||||
Node: Top78
|
||||
Node: FILE FORMAT888
|
||||
Ref: #file-format991
|
||||
Node: FILE FORMAT882
|
||||
Ref: #file-format985
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -120,4 +120,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger 1.2.98 June 2017 hledger_timedot(5)
|
||||
hledger 1.3 June 2017 hledger_timedot(5)
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger\-ui" "1" "June 2017" "hledger\-ui 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger\-ui" "1" "June 2017" "hledger\-ui 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
@ -232,8 +232,9 @@ The cursor keys navigate: \f[C]right\f[] (or \f[C]enter\f[]) goes
|
||||
deeper, \f[C]left\f[] returns to the previous screen,
|
||||
\f[C]up\f[]/\f[C]down\f[]/\f[C]page\ up\f[]/\f[C]page\ down\f[]/\f[C]home\f[]/\f[C]end\f[]
|
||||
move up and down through lists.
|
||||
Vi\-style \f[C]h\f[]/\f[C]j\f[]/\f[C]k\f[]/\f[C]l\f[] movement keys are
|
||||
also supported.
|
||||
Vi\-style (\f[C]h\f[]/\f[C]j\f[]/\f[C]k\f[]/\f[C]l\f[]) and Emacs\-style
|
||||
(\f[C]CTRL\-p\f[]/\f[C]CTRL\-n\f[]/\f[C]CTRL\-f\f[]/\f[C]CTRL\-b\f[])
|
||||
movement keys are also supported.
|
||||
A tip: movement speed is limited by your keyboard repeat rate, to move
|
||||
faster you may want to adjust it.
|
||||
(If you\[aq]re on a mac, the Karabiner app is one way to do that.)
|
||||
@ -262,6 +263,10 @@ transactions.
|
||||
\f[C]ESCAPE\f[] removes all filters and jumps back to the top screen.
|
||||
Or, it cancels a minibuffer edit or help dialog in progress.
|
||||
.PP
|
||||
\f[C]CTRL\-l\f[] redraws the screen and centers the selection if
|
||||
possible (selections near the top won\[aq]t be centered, since we
|
||||
don\[aq]t scroll above the top).
|
||||
.PP
|
||||
\f[C]g\f[] reloads from the data file(s) and updates the current screen
|
||||
and any previous screens.
|
||||
(With large files, this could cause a noticeable pause.)
|
||||
|
||||
@ -3,8 +3,8 @@ This is hledger-ui.1.info, produced by makeinfo version 6.0 from stdin.
|
||||
|
||||
File: hledger-ui.1.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||
|
||||
hledger-ui(1) hledger-ui 1.2.98
|
||||
*******************************
|
||||
hledger-ui(1) hledger-ui 1.3
|
||||
****************************
|
||||
|
||||
hledger-ui is hledger's curses-style interface, providing an efficient
|
||||
full-window text UI for viewing accounts and transactions, and some
|
||||
@ -167,10 +167,10 @@ screens:
|
||||
The cursor keys navigate: 'right' (or 'enter') goes deeper, 'left'
|
||||
returns to the previous screen, 'up'/'down'/'page up'/'page
|
||||
down'/'home'/'end' move up and down through lists. Vi-style
|
||||
'h'/'j'/'k'/'l' movement keys are also supported. A tip: movement speed
|
||||
is limited by your 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.)
|
||||
('h'/'j'/'k'/'l') and Emacs-style ('CTRL-p'/'CTRL-n'/'CTRL-f'/'CTRL-b')
|
||||
movement keys are also supported. A tip: movement speed is limited by
|
||||
your 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).
|
||||
@ -193,6 +193,10 @@ transactions.
|
||||
'ESCAPE' removes all filters and jumps back to the top screen. Or,
|
||||
it cancels a minibuffer edit or help dialog in progress.
|
||||
|
||||
'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
|
||||
pause.)
|
||||
@ -361,19 +365,19 @@ to cancel the reload attempt.)
|
||||
|
||||
Tag Table:
|
||||
Node: Top73
|
||||
Node: OPTIONS831
|
||||
Ref: #options930
|
||||
Node: KEYS3671
|
||||
Ref: #keys3768
|
||||
Node: SCREENS6357
|
||||
Ref: #screens6444
|
||||
Node: Accounts screen6534
|
||||
Ref: #accounts-screen6664
|
||||
Node: Register screen8894
|
||||
Ref: #register-screen9051
|
||||
Node: Transaction screen11125
|
||||
Ref: #transaction-screen11285
|
||||
Node: Error screen12155
|
||||
Ref: #error-screen12279
|
||||
Node: OPTIONS825
|
||||
Ref: #options924
|
||||
Node: KEYS3665
|
||||
Ref: #keys3762
|
||||
Node: SCREENS6558
|
||||
Ref: #screens6645
|
||||
Node: Accounts screen6735
|
||||
Ref: #accounts-screen6865
|
||||
Node: Register screen9095
|
||||
Ref: #register-screen9252
|
||||
Node: Transaction screen11326
|
||||
Ref: #transaction-screen11486
|
||||
Node: Error screen12356
|
||||
Ref: #error-screen12480
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -151,45 +151,50 @@ KEYS
|
||||
|
||||
The cursor keys navigate: right (or enter) goes deeper, left returns to
|
||||
the previous screen, up/down/page up/page down/home/end move up and
|
||||
down through lists. Vi-style h/j/k/l movement keys are also supported.
|
||||
A tip: movement speed is limited by your 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.)
|
||||
down through lists. Vi-style (h/j/k/l) and Emacs-style
|
||||
(CTRL-p/CTRL-n/CTRL-f/CTRL-b) movement keys are also supported. A tip:
|
||||
movement speed is limited by your 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
|
||||
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 "current"
|
||||
period (the current day, week, month, quarter, or year), the period
|
||||
will move automatically to track the current date. To set a non-stan-
|
||||
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-stan-
|
||||
dard 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
|
||||
/ 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 ESCAPEto cancel. There are also keys for quickly adjusting some
|
||||
common filters like account depth and transaction status (see below).
|
||||
common filters like account depth and transaction status (see below).
|
||||
BACKSPACE or DELETE removes all filters, showing all transactions.
|
||||
|
||||
ESCAPE removes all filters and jumps back to the top screen. Or, it
|
||||
ESCAPE removes all filters and jumps back to the top screen. Or, it
|
||||
cancels a minibuffer edit or help dialog in progress.
|
||||
|
||||
g reloads from the data file(s) and updates the current screen and any
|
||||
previous screens. (With large files, this could cause a noticeable
|
||||
CTRL-l redraws the screen and centers the selection if possible (selec-
|
||||
tions 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
|
||||
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
|
||||
a runs command-line hledger's add command, and reloads the updated
|
||||
file. This allows some basic data entry.
|
||||
|
||||
E runs $HLEDGER_UI_EDITOR, or $EDITOR, or a default (emac-
|
||||
E runs $HLEDGER_UI_EDITOR, or $EDITOR, or a default (emac-
|
||||
sclient -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
|
||||
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.
|
||||
|
||||
q quits the application.
|
||||
@ -198,44 +203,44 @@ KEYS
|
||||
|
||||
SCREENS
|
||||
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
|
||||
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 normally indented to show the hierarchy (tree mode).
|
||||
Account names are normally indented to show the hierarchy (tree mode).
|
||||
To see less detail, set a depth limit by pressing a number key, 1 to 9.
|
||||
0 shows even less detail, collapsing all accounts to a single total. -
|
||||
and + (or =) decrease and increase the depth limit. To remove the
|
||||
depth limit, set it higher than the maximum account depth, or press
|
||||
and + (or =) decrease and increase the depth limit. To remove the
|
||||
depth limit, set it higher than the maximum account depth, or press
|
||||
ESCAPE.
|
||||
|
||||
F toggles flat mode, in which accounts are shown as a flat list, with
|
||||
their full names. In this mode, account balances exclude subaccounts,
|
||||
except for accounts at the depth limit (as with hledger's balance com-
|
||||
F toggles flat mode, in which accounts are shown as a flat list, with
|
||||
their full names. In this mode, account balances exclude subaccounts,
|
||||
except for accounts at the depth limit (as with hledger's balance com-
|
||||
mand).
|
||||
|
||||
H toggles between showing historical balances or period balances. His-
|
||||
torical 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
|
||||
torical 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.
|
||||
|
||||
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
|
||||
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.
|
||||
|
||||
Z toggles nonzero mode, in which only accounts with nonzero balances
|
||||
are shown (hledger-ui shows zero items by default, unlike command-line
|
||||
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 or enter to view an account's transactions register.
|
||||
@ -244,65 +249,65 @@ SCREENS
|
||||
This screen shows the transactions affecting a particular account, like
|
||||
a check register. Each line represents one transaction and shows:
|
||||
|
||||
o the other account(s) involved, in abbreviated form. (If there are
|
||||
both real and virtual postings, it shows only the accounts affected
|
||||
o 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.)
|
||||
|
||||
o the overall change to the current account's balance; positive for an
|
||||
o the overall change to the current account's balance; positive for an
|
||||
inflow to this account, negative for an outflow.
|
||||
|
||||
o 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
|
||||
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
|
||||
a filter query, it will be the running historical balance you would
|
||||
see on a bank register for the current account.
|
||||
|
||||
If the accounts screen was in tree mode, the register screen will
|
||||
If the accounts screen was in tree mode, the register screen will
|
||||
include transactions from both the current account and its subaccounts.
|
||||
If the accounts screen was in flat mode, and a non-depth-clipped
|
||||
account was selected, the register screen will exclude transactions
|
||||
If the accounts screen was in flat mode, and a non-depth-clipped
|
||||
account was selected, the register screen will exclude transactions
|
||||
from subaccounts. In other words, the register always shows the trans-
|
||||
actions responsible for the period balance shown on the accounts
|
||||
actions responsible for the period balance shown on the accounts
|
||||
screen. As on the accounts screen, this can be toggled with F.
|
||||
|
||||
U toggles filtering by unmarked status, showing or hiding unmarked
|
||||
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 transac-
|
||||
tions are shown; and if you activate all three, the filter is
|
||||
cleared transactions. (By default, transactions with all statuses are
|
||||
shown; if you activate one or two status filters, only those transac-
|
||||
tions are shown; and if you activate all three, the filter is
|
||||
removed.)q
|
||||
|
||||
R toggles real mode, in which virtual postings are ignored.
|
||||
|
||||
Z toggles nonzero mode, in which only transactions posting a nonzero
|
||||
change are shown (hledger-ui shows zero items by default, unlike com-
|
||||
Z toggles nonzero mode, in which only transactions posting a nonzero
|
||||
change are shown (hledger-ui shows zero items by default, unlike com-
|
||||
mand-line hledger).
|
||||
|
||||
Press right (or enter) to view the selected transaction in detail.
|
||||
|
||||
Transaction screen
|
||||
This screen shows a single transaction, as a general journal entry,
|
||||
similar to hledger's print command and journal format (hledger_jour-
|
||||
This screen shows a single transaction, as a general journal entry,
|
||||
similar to hledger's print command and journal format (hledger_jour-
|
||||
nal(5)).
|
||||
|
||||
The transaction's date(s) and any cleared flag, transaction code,
|
||||
description, comments, along with all of its account postings are
|
||||
shown. Simple transactions have two postings, but there can be more
|
||||
The transaction's date(s) and any cleared flag, transaction code,
|
||||
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 vary
|
||||
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 trans-
|
||||
actions appear in multiple account registers). The #N number preceding
|
||||
them is the transaction's position within the complete unfiltered jour-
|
||||
nal, which is a more stable id (at least until the next reload).
|
||||
|
||||
Error screen
|
||||
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
|
||||
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
|
||||
to cancel the reload attempt.)
|
||||
|
||||
@ -310,17 +315,17 @@ ENVIRONMENT
|
||||
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.jour-
|
||||
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
|
||||
nal).
|
||||
|
||||
FILES
|
||||
Reads data from one or more files in hledger journal, timeclock, time-
|
||||
dot, or CSV format specified with -f, or $LEDGER_FILE, or
|
||||
$HOME/.hledger.journal (on windows, perhaps
|
||||
Reads data from one or more files in hledger journal, timeclock, time-
|
||||
dot, or CSV format specified with -f, or $LEDGER_FILE, or
|
||||
$HOME/.hledger.journal (on windows, perhaps
|
||||
C:/Users/USER/.hledger.journal).
|
||||
|
||||
BUGS
|
||||
The need to precede options with -- when invoked from hledger is awk-
|
||||
The need to precede options with -- when invoked from hledger is awk-
|
||||
ward.
|
||||
|
||||
-f- doesn't work (hledger-ui can't read from stdin).
|
||||
@ -328,13 +333,13 @@ BUGS
|
||||
-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 there is no
|
||||
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, 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. Symp-
|
||||
toms include: unresponsive UI, periodic resetting of the cursor posi-
|
||||
--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. Symp-
|
||||
toms include: unresponsive UI, periodic resetting of the cursor posi-
|
||||
tion, momentary display of parse errors, high CPU usage eventually sub-
|
||||
siding, and possibly a small but persistent build-up of CPU usage until
|
||||
the program is restarted.
|
||||
@ -342,7 +347,7 @@ BUGS
|
||||
|
||||
|
||||
REPORTING BUGS
|
||||
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
||||
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
||||
or hledger mail list)
|
||||
|
||||
|
||||
@ -356,7 +361,7 @@ COPYRIGHT
|
||||
|
||||
|
||||
SEE ALSO
|
||||
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
||||
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
||||
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
|
||||
dot(5), ledger(1)
|
||||
|
||||
@ -364,4 +369,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger-ui 1.2.98 June 2017 hledger-ui(1)
|
||||
hledger-ui 1.3 June 2017 hledger-ui(1)
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
|
||||
.TH "hledger\-web" "1" "June 2017" "hledger\-web 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger\-web" "1" "June 2017" "hledger\-web 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -3,8 +3,8 @@ This is hledger-web.1.info, produced by makeinfo version 6.0 from stdin.
|
||||
|
||||
File: hledger-web.1.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||
|
||||
hledger-web(1) hledger-web 1.2.98
|
||||
*********************************
|
||||
hledger-web(1) hledger-web 1.3
|
||||
******************************
|
||||
|
||||
hledger-web is hledger's web interface. It starts a simple web
|
||||
application for browsing and adding transactions, and optionally opens
|
||||
@ -201,7 +201,7 @@ options as shown above.
|
||||
|
||||
Tag Table:
|
||||
Node: Top74
|
||||
Node: OPTIONS3162
|
||||
Ref: #options3249
|
||||
Node: OPTIONS3156
|
||||
Ref: #options3243
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -237,4 +237,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger-web 1.2.98 June 2017 hledger-web(1)
|
||||
hledger-web 1.3 June 2017 hledger-web(1)
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
.\"t
|
||||
|
||||
.TH "hledger" "1" "June 2017" "hledger 1.2.98" "hledger User Manuals"
|
||||
.TH "hledger" "1" "June 2017" "hledger 1.3" "hledger User Manuals"
|
||||
|
||||
|
||||
|
||||
|
||||
@ -3,8 +3,8 @@ This is hledger.1.info, produced by makeinfo version 6.0 from stdin.
|
||||
|
||||
File: hledger.1.info, Node: Top, Next: EXAMPLES, Up: (dir)
|
||||
|
||||
hledger(1) hledger 1.2.98
|
||||
*************************
|
||||
hledger(1) hledger 1.3
|
||||
**********************
|
||||
|
||||
This is hledger's command-line interface (there are also curses and web
|
||||
interfaces). Its basic function is to read a plain text file describing
|
||||
@ -2113,129 +2113,129 @@ transactions.
|
||||
|
||||
Tag Table:
|
||||
Node: Top70
|
||||
Node: EXAMPLES1892
|
||||
Ref: #examples1994
|
||||
Node: OPTIONS3640
|
||||
Ref: #options3744
|
||||
Node: General options4025
|
||||
Ref: #general-options4152
|
||||
Node: Command options6690
|
||||
Ref: #command-options6843
|
||||
Node: Command arguments7241
|
||||
Ref: #command-arguments7401
|
||||
Node: Special characters7522
|
||||
Ref: #special-characters7680
|
||||
Node: Input files8848
|
||||
Ref: #input-files8986
|
||||
Node: Smart dates10949
|
||||
Ref: #smart-dates11092
|
||||
Node: Report start & end date12071
|
||||
Ref: #report-start-end-date12243
|
||||
Node: Report intervals13309
|
||||
Ref: #report-intervals13474
|
||||
Node: Period expressions13875
|
||||
Ref: #period-expressions14035
|
||||
Node: Depth limiting16375
|
||||
Ref: #depth-limiting16521
|
||||
Node: Pivoting16722
|
||||
Ref: #pivoting16842
|
||||
Node: Cost18613
|
||||
Ref: #cost18723
|
||||
Node: Market value18841
|
||||
Ref: #market-value18978
|
||||
Node: Regular expressions20278
|
||||
Ref: #regular-expressions20416
|
||||
Node: QUERIES21777
|
||||
Ref: #queries21881
|
||||
Node: COMMANDS25546
|
||||
Ref: #commands25660
|
||||
Node: accounts26333
|
||||
Ref: #accounts26433
|
||||
Node: activity27415
|
||||
Ref: #activity27527
|
||||
Node: add27886
|
||||
Ref: #add27987
|
||||
Node: balance30645
|
||||
Ref: #balance30758
|
||||
Node: Flat mode33773
|
||||
Ref: #flat-mode33900
|
||||
Node: Depth limited balance reports34320
|
||||
Ref: #depth-limited-balance-reports34523
|
||||
Node: Multicolumn balance reports34943
|
||||
Ref: #multicolumn-balance-reports35154
|
||||
Node: Custom balance output39802
|
||||
Ref: #custom-balance-output39986
|
||||
Node: Colour support42079
|
||||
Ref: #colour-support42240
|
||||
Node: Output destination42413
|
||||
Ref: #output-destination42571
|
||||
Node: CSV output42841
|
||||
Ref: #csv-output42960
|
||||
Node: balancesheet43357
|
||||
Ref: #balancesheet43485
|
||||
Node: cashflow45392
|
||||
Ref: #cashflow45509
|
||||
Node: help47377
|
||||
Ref: #help47489
|
||||
Node: incomestatement48327
|
||||
Ref: #incomestatement48457
|
||||
Node: info50349
|
||||
Ref: #info50456
|
||||
Node: man50820
|
||||
Ref: #man50917
|
||||
Node: print51322
|
||||
Ref: #print51427
|
||||
Node: register55183
|
||||
Ref: #register55296
|
||||
Node: Custom register output59792
|
||||
Ref: #custom-register-output59923
|
||||
Node: stats61220
|
||||
Ref: #stats61326
|
||||
Node: test62207
|
||||
Ref: #test62294
|
||||
Node: ADD-ON COMMANDS62662
|
||||
Ref: #add-on-commands62774
|
||||
Node: Official add-ons64061
|
||||
Ref: #official-add-ons64203
|
||||
Node: api64290
|
||||
Ref: #api64381
|
||||
Node: ui64433
|
||||
Ref: #ui64534
|
||||
Node: web64592
|
||||
Ref: #web64683
|
||||
Node: Third party add-ons64729
|
||||
Ref: #third-party-add-ons64906
|
||||
Node: diff65041
|
||||
Ref: #diff65140
|
||||
Node: iadd65239
|
||||
Ref: #iadd65355
|
||||
Node: interest65438
|
||||
Ref: #interest65561
|
||||
Node: irr65656
|
||||
Ref: #irr65756
|
||||
Node: Experimental add-ons65834
|
||||
Ref: #experimental-add-ons65988
|
||||
Node: autosync66381
|
||||
Ref: #autosync66495
|
||||
Node: budget66734
|
||||
Ref: #budget66858
|
||||
Node: chart66924
|
||||
Ref: #chart67043
|
||||
Node: check67114
|
||||
Ref: #check67238
|
||||
Node: check-dates67305
|
||||
Ref: #check-dates67447
|
||||
Node: check-dupes67520
|
||||
Ref: #check-dupes67663
|
||||
Node: equity67740
|
||||
Ref: #equity67868
|
||||
Node: prices67987
|
||||
Ref: #prices68116
|
||||
Node: print-unique68171
|
||||
Ref: #print-unique68320
|
||||
Node: register-match68413
|
||||
Ref: #register-match68569
|
||||
Node: rewrite68667
|
||||
Ref: #rewrite68788
|
||||
Node: EXAMPLES1886
|
||||
Ref: #examples1988
|
||||
Node: OPTIONS3634
|
||||
Ref: #options3738
|
||||
Node: General options4019
|
||||
Ref: #general-options4146
|
||||
Node: Command options6684
|
||||
Ref: #command-options6837
|
||||
Node: Command arguments7235
|
||||
Ref: #command-arguments7395
|
||||
Node: Special characters7516
|
||||
Ref: #special-characters7674
|
||||
Node: Input files8842
|
||||
Ref: #input-files8980
|
||||
Node: Smart dates10943
|
||||
Ref: #smart-dates11086
|
||||
Node: Report start & end date12065
|
||||
Ref: #report-start-end-date12237
|
||||
Node: Report intervals13303
|
||||
Ref: #report-intervals13468
|
||||
Node: Period expressions13869
|
||||
Ref: #period-expressions14029
|
||||
Node: Depth limiting16369
|
||||
Ref: #depth-limiting16515
|
||||
Node: Pivoting16716
|
||||
Ref: #pivoting16836
|
||||
Node: Cost18607
|
||||
Ref: #cost18717
|
||||
Node: Market value18835
|
||||
Ref: #market-value18972
|
||||
Node: Regular expressions20272
|
||||
Ref: #regular-expressions20410
|
||||
Node: QUERIES21771
|
||||
Ref: #queries21875
|
||||
Node: COMMANDS25540
|
||||
Ref: #commands25654
|
||||
Node: accounts26327
|
||||
Ref: #accounts26427
|
||||
Node: activity27409
|
||||
Ref: #activity27521
|
||||
Node: add27880
|
||||
Ref: #add27981
|
||||
Node: balance30639
|
||||
Ref: #balance30752
|
||||
Node: Flat mode33767
|
||||
Ref: #flat-mode33894
|
||||
Node: Depth limited balance reports34314
|
||||
Ref: #depth-limited-balance-reports34517
|
||||
Node: Multicolumn balance reports34937
|
||||
Ref: #multicolumn-balance-reports35148
|
||||
Node: Custom balance output39796
|
||||
Ref: #custom-balance-output39980
|
||||
Node: Colour support42073
|
||||
Ref: #colour-support42234
|
||||
Node: Output destination42407
|
||||
Ref: #output-destination42565
|
||||
Node: CSV output42835
|
||||
Ref: #csv-output42954
|
||||
Node: balancesheet43351
|
||||
Ref: #balancesheet43479
|
||||
Node: cashflow45386
|
||||
Ref: #cashflow45503
|
||||
Node: help47371
|
||||
Ref: #help47483
|
||||
Node: incomestatement48321
|
||||
Ref: #incomestatement48451
|
||||
Node: info50343
|
||||
Ref: #info50450
|
||||
Node: man50814
|
||||
Ref: #man50911
|
||||
Node: print51316
|
||||
Ref: #print51421
|
||||
Node: register55177
|
||||
Ref: #register55290
|
||||
Node: Custom register output59786
|
||||
Ref: #custom-register-output59917
|
||||
Node: stats61214
|
||||
Ref: #stats61320
|
||||
Node: test62201
|
||||
Ref: #test62288
|
||||
Node: ADD-ON COMMANDS62656
|
||||
Ref: #add-on-commands62768
|
||||
Node: Official add-ons64055
|
||||
Ref: #official-add-ons64197
|
||||
Node: api64284
|
||||
Ref: #api64375
|
||||
Node: ui64427
|
||||
Ref: #ui64528
|
||||
Node: web64586
|
||||
Ref: #web64677
|
||||
Node: Third party add-ons64723
|
||||
Ref: #third-party-add-ons64900
|
||||
Node: diff65035
|
||||
Ref: #diff65134
|
||||
Node: iadd65233
|
||||
Ref: #iadd65349
|
||||
Node: interest65432
|
||||
Ref: #interest65555
|
||||
Node: irr65650
|
||||
Ref: #irr65750
|
||||
Node: Experimental add-ons65828
|
||||
Ref: #experimental-add-ons65982
|
||||
Node: autosync66375
|
||||
Ref: #autosync66489
|
||||
Node: budget66728
|
||||
Ref: #budget66852
|
||||
Node: chart66918
|
||||
Ref: #chart67037
|
||||
Node: check67108
|
||||
Ref: #check67232
|
||||
Node: check-dates67299
|
||||
Ref: #check-dates67441
|
||||
Node: check-dupes67514
|
||||
Ref: #check-dupes67657
|
||||
Node: equity67734
|
||||
Ref: #equity67862
|
||||
Node: prices67981
|
||||
Ref: #prices68110
|
||||
Node: print-unique68165
|
||||
Ref: #print-unique68314
|
||||
Node: register-match68407
|
||||
Ref: #register-match68563
|
||||
Node: rewrite68661
|
||||
Ref: #rewrite68782
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -1878,4 +1878,4 @@ SEE ALSO
|
||||
|
||||
|
||||
|
||||
hledger 1.2.98 June 2017 hledger(1)
|
||||
hledger 1.3 June 2017 hledger(1)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user