hledger-ui 1.20.1 → 1.20.2
raw patch · 5 files changed
+215/−208 lines, 5 filesdep ~hledgerdep ~hledger-lib
Dependency ranges changed: hledger, hledger-lib
Files
- CHANGES.md +8/−0
- hledger-ui.1 +53/−54
- hledger-ui.cabal +5/−5
- hledger-ui.info +97/−99
- hledger-ui.txt +52/−50
CHANGES.md view
@@ -1,6 +1,14 @@ User-visible changes in hledger-ui. See also the hledger changelog. +# 1.20.2 2020-12-28++- Fix loss of capitalisation in part of the manual. ++- Fix the info manual's node structure.++- Use hledger 1.20.2.+ # 1.20.1 2020-12-15 - Fix the F key (toggle future/forecast transactions), which in 1.20
hledger-ui.1 view
@@ -1,11 +1,11 @@ -.TH "hledger-ui" "1" "December 2020" "hledger-ui 1.20.1" "hledger User Manuals"+.TH "HLEDGER-UI" "1" "December 2020" "hledger-ui-1.20.1 " "hledger User Manuals" .SH NAME .PP-hledger-ui - terminal interface for the hledger accounting tool+A terminal interface (TUI) for the hledger accounting tool. .SH SYNOPSIS .PP \f[C]hledger-ui [OPTIONS] [QUERYARGS]\f[R]@@ -189,18 +189,18 @@ \f[B]\f[CB]--debug[=N]\f[B]\f[R] show debug output (levels 1-9, default: 1) .PP-a \[at]file argument will be expanded to the contents of file, which+A \[at]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 \f[C]--\f[R] argument before.)-.SH keys+(To prevent this, insert a \f[C]--\f[R] argument before.)+.SH KEYS .PP \f[C]?\f[R] shows a help dialog listing all keys.-(some of these also appear in the quick help at the bottom of each-screen.) press \f[C]?\f[R] again (or \f[C]escape\f[R], or-\f[C]left\f[R], or \f[C]q\f[R]) to close it.-the following keys work on most screens:+(Some of these also appear in the quick help at the bottom of each+screen.) Press \f[C]?\f[R] again (or \f[C]ESCAPE\f[R], or+\f[C]LEFT\f[R], or \f[C]q\f[R]) to close it.+The following keys work on most screens: .PP-the cursor keys navigate: \f[C]right\f[R] (or \f[C]enter\f[R]) goes+The cursor keys navigate: \f[C]right\f[R] (or \f[C]enter\f[R]) goes deeper, \f[C]left\f[R] returns to the previous screen, \f[C]up\f[R]/\f[C]down\f[R]/\f[C]page up\f[R]/\f[C]page down\f[R]/\f[C]home\f[R]/\f[C]end\f[R] move up and down through lists.@@ -212,104 +212,103 @@ faster you may want to adjust it. (If you\[aq]re on a mac, the karabiner app is one way to do that.) .PP-with shift pressed, the cursor keys adjust the report period, limiting+With shift pressed, the cursor keys adjust the report period, limiting the transactions to be shown (by default, all are shown). \f[C]shift-down/up\f[R] steps downward and upward through these standard report period durations: year, quarter, month, week, day.-then, \f[C]shift-left/right\f[R] moves to the previous/next period.+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]--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+To set a non-standard period, you can use \f[C]/\f[R] and a \f[C]date:\f[R] query. .PP \f[C]/\f[R] 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 \f[C]enter\f[R] to set it, or \f[C]escape\f[R]to cancel.-there are also keys for quickly adjusting some common filters like+While editing the query, you can use CTRL-a/e/d/k, BS, cursor keys;+press \f[C]ENTER\f[R] to set it, or \f[C]ESCAPE\f[R]to cancel.+There are also keys for quickly adjusting some common filters like account depth and transaction status (see below).-\f[C]backspace\f[R] or \f[C]delete\f[R] removes all filters, showing all+\f[C]BACKSPACE\f[R] or \f[C]DELETE\f[R] removes all filters, showing all transactions. .PP-as mentioned above, by default hledger-ui hides future 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[C]f\f[R] toggles forecast mode, in which future/forecasted+\f[C]F\f[R] toggles forecast mode, in which future/forecasted transactions are shown.-\f[I](experimental)\f[R] .PP-\f[C]escape\f[R] resets the UI state and jumps back to the top screen,+\f[C]ESCAPE\f[R] resets the UI state and jumps back to the top screen, restoring the app\[aq]s initial state at startup. Or, it cancels minibuffer data entry or the help dialog. .PP-\f[C]ctrl-l\f[R] redraws the screen and centers the selection if+\f[C]CTRL-l\f[R] 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[R] reloads from the data file(s) and updates the current screen and any previous screens.-(with large files, this could cause a noticeable pause.)+(With large files, this could cause a noticeable pause.) .PP-\f[C]i\f[R] toggles balance assertion checking.-disabling balance assertions temporarily can be useful for+\f[C]I\f[R] toggles balance assertion checking.+Disabling balance assertions temporarily can be useful for troubleshooting. .PP \f[C]a\f[R] runs command-line hledger\[aq]s add command, and reloads the updated file.-this allows some basic data entry.+This allows some basic data entry. .PP-\f[C]a\f[R] is like \f[C]a\f[R], but runs the hledger-iadd tool, which+\f[C]A\f[R] is like \f[C]a\f[R], but runs the hledger-iadd tool, which provides a terminal interface.-this key will be available if \f[C]hledger-iadd\f[R] is installed in+This key will be available if \f[C]hledger-iadd\f[R] is installed in $path. .PP-\f[C]e\f[R] runs $hledger_ui_editor, or $editor, or a default+\f[C]E\f[R] runs $HLEDGER_UI_EDITOR, or $EDITOR, or a default (\f[C]emacsclient -a \[dq]\[dq] -nw\f[R]) on the journal file.-with some editors (emacs, vi), the cursor will be positioned at the+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. .PP-\f[C]b\f[R] toggles cost mode, showing amounts in their transaction-price\[aq]s commodity (like toggling the \f[C]-b/--cost\f[R] flag).+\f[C]B\f[R] toggles cost mode, showing amounts in their transaction+price\[aq]s commodity (like toggling the \f[C]-B/--cost\f[R] flag). .PP-\f[C]v\f[R] toggles value mode, showing amounts\[aq] current market+\f[C]V\f[R] toggles value mode, showing amounts\[aq] current market value in their default valuation commodity (like toggling the-\f[C]-v/--market\f[R] flag).-note, \[dq]current market value\[dq] means the value on the report end+\f[C]-V/--market\f[R] flag).+Note, \[dq]current market value\[dq] 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+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+Eg: to see a transaction as it was valued on july 30, go to the accounts or register screen, press \f[C]/\f[R], and add \f[C]date:-7/30\f[R] to the query. .PP-at most one of cost or value mode can be active at once.+At most one of cost or value mode can be active at once. .PP-there\[aq]s not yet any visual reminder when cost or value mode is+There\[aq]s not yet any visual reminder when cost or value mode is active; for now pressing \f[C]b\f[R] \f[C]b\f[R] \f[C]v\f[R] should reliably reset to normal mode. .PP-with --watch active, if you save an edit to the journal file while-viewing the transaction screen in cost or value mode, the-\f[C]b\f[R]/\f[C]v\f[R] keys will stop working.-to work around, press g to force a manual reload, or exit the+With \f[C]--watch\f[R] active, if you save an edit to the journal file+while viewing the transaction screen in cost or value mode, the+\f[C]B\f[R]/\f[C]V\f[R] keys will stop working.+To work around, press \f[C]g\f[R] to force a manual reload, or exit the transaction screen. .PP \f[C]q\f[R] quits the application. .PP-additional screen-specific keys are described below.-.SH screens-.SS accounts screen+Additional screen-specific keys are described below.+.SH SCREENS+.SS Accounts screen .PP-this is normally the first screen displayed.-it lists accounts and their balances, like hledger\[aq]s balance+This is normally the first screen displayed.+It lists accounts and their balances, like hledger\[aq]s balance command.-by default, it shows all accounts and their latest ending balances+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+If you specify a query on the command line, it shows just the matched accounts and the balances from matched transactions. .PP Account names are shown as a flat list by default; press \f[C]t\f[R] to@@ -505,6 +504,6 @@ Released under GNU GPL v3 or later. .SH SEE ALSO-hledger(1), hledger\-ui(1), hledger\-web(1),-hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_timedot(5),-ledger(1)+hledger(1), hledger\-ui(1), hledger\-web(1), ledger(1)++hledger_journal(5), hledger_csv(5), hledger_timeclock(5), hledger_timedot(5)
hledger-ui.cabal view
@@ -4,10 +4,10 @@ -- -- see: https://github.com/sol/hpack ----- hash: aa2ee3de3cbd0649f1506526856f8646a597192d6dcd5e80e30204b3b6764578+-- hash: 2db561169954b597771f5f15da315b4f928c9430f17910a3aebaa908165579a6 name: hledger-ui-version: 1.20.1+version: 1.20.2 synopsis: Curses-style terminal interface for the hledger accounting system description: A simple curses-style terminal user interface for the hledger accounting system. It can be a more convenient way to browse your accounts than the CLI.@@ -64,7 +64,7 @@ hs-source-dirs: ./. ghc-options: -Wall -fno-warn-unused-do-bind -fno-warn-name-shadowing -fno-warn-missing-signatures -fno-warn-type-defaults -fno-warn-orphans- cpp-options: -DVERSION="1.20.1"+ cpp-options: -DVERSION="1.20.2" build-depends: ansi-terminal >=0.9 , async@@ -78,8 +78,8 @@ , extra >=1.6.3 , filepath , fsnotify >=0.2.1.2 && <0.4- , hledger >=1.20.1 && <1.21- , hledger-lib >=1.20.1 && <1.21+ , hledger >=1.20.2 && <1.21+ , hledger-lib >=1.20.2 && <1.21 , megaparsec >=7.0.0 && <9.1 , microlens >=0.4 , microlens-platform >=0.2.3.1
hledger-ui.info view
@@ -3,10 +3,10 @@ File: hledger-ui.info, Node: Top, Next: OPTIONS, Up: (dir) -hledger-ui(1) hledger-ui 1.20.1-*******************************+hledger-ui(1)+************* -hledger-ui - terminal interface for the hledger accounting tool+A terminal interface (TUI) for the hledger accounting tool. 'hledger-ui [OPTIONS] [QUERYARGS]' 'hledger ui -- [OPTIONS] [QUERYARGS]'@@ -36,18 +36,14 @@ * Menu: * OPTIONS::-* keys::-* screens::-* accounts screen::-* Register screen::-* Transaction screen::-* Error screen::+* KEYS::+* SCREENS:: * ENVIRONMENT:: * FILES:: * BUGS:: -File: hledger-ui.info, Node: OPTIONS, Next: keys, Prev: Top, Up: Top+File: hledger-ui.info, Node: OPTIONS, Next: KEYS, Prev: Top, Up: Top 1 OPTIONS *********@@ -208,22 +204,22 @@ 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+ 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.) -File: hledger-ui.info, Node: keys, Next: screens, Prev: OPTIONS, Up: Top+File: hledger-ui.info, Node: KEYS, Next: SCREENS, Prev: OPTIONS, Up: Top -2 keys+2 KEYS ****** -'?' 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' (or 'enter') goes deeper, 'left'+ 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. Emacs-style ('ctrl-p'/'ctrl-n'/'ctrl-f'/'ctrl-b') movement keys are also supported@@ -232,99 +228,106 @@ 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,+ 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,+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+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+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+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 -+ 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-future/forecasted transactions are shown. _(experimental)_+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,+ '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+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.+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. - at most one of cost or value mode can be active at once.+ 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+ 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 mode. - with -watch active, if you save an edit to the journal file while-viewing the transaction screen in cost or value mode, the 'b'/'v' keys-will stop working. to work around, press g to force a manual reload, or-exit the transaction screen.+ With '--watch' active, if you save an edit to the journal file while+viewing the transaction screen in cost or value mode, the 'B'/'V' keys+will stop working. To work around, press 'g' to force a manual reload,+or exit the transaction screen. 'q' quits the application. - additional screen-specific keys are described below.+ Additional screen-specific keys are described below. -File: hledger-ui.info, Node: screens, Next: accounts screen, Prev: keys, Up: Top+File: hledger-ui.info, Node: SCREENS, Next: ENVIRONMENT, Prev: KEYS, Up: Top -3 screens+3 SCREENS ********* +* Menu:++* Accounts screen::+* Register screen::+* Transaction screen::+* Error screen::+ -File: hledger-ui.info, Node: accounts screen, Next: Register screen, Prev: screens, Up: Top+File: hledger-ui.info, Node: Accounts screen, Next: Register screen, Up: SCREENS -4 accounts screen-*****************+3.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+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+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@@ -365,10 +368,10 @@ Press 'right' or 'enter' to view an account's transactions register. -File: hledger-ui.info, Node: Register screen, Next: Transaction screen, Prev: accounts screen, Up: Top+File: hledger-ui.info, Node: Register screen, Next: Transaction screen, Prev: Accounts screen, Up: SCREENS -5 Register screen-*****************+3.2 Register screen+=================== This screen shows the transactions affecting a particular account, like a check register. Each line represents one transaction and shows:@@ -412,10 +415,10 @@ detail. -File: hledger-ui.info, Node: Transaction screen, Next: Error screen, Prev: Register screen, Up: Top+File: hledger-ui.info, Node: Transaction screen, Next: Error screen, Prev: Register screen, Up: SCREENS -6 Transaction screen-********************+3.3 Transaction screen+====================== This screen shows a single transaction, as a general journal entry, similar to hledger's print command and journal format@@ -436,10 +439,10 @@ reload). -File: hledger-ui.info, Node: Error screen, Next: ENVIRONMENT, Prev: Transaction screen, Up: Top+File: hledger-ui.info, Node: Error screen, Prev: Transaction screen, Up: SCREENS -7 Error screen-**************+3.4 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@@ -447,9 +450,9 @@ to cancel the reload attempt.) -File: hledger-ui.info, Node: ENVIRONMENT, Next: FILES, Prev: Error screen, Up: Top+File: hledger-ui.info, Node: ENVIRONMENT, Next: FILES, Prev: SCREENS, Up: Top -8 ENVIRONMENT+4 ENVIRONMENT ************* *COLUMNS* The screen width to use. Default: the full terminal width.@@ -477,7 +480,7 @@ File: hledger-ui.info, Node: FILES, Next: BUGS, Prev: ENVIRONMENT, Up: Top -9 FILES+5 FILES ******* Reads data from one or more files in hledger journal, timeclock,@@ -488,8 +491,8 @@ File: hledger-ui.info, Node: BUGS, Prev: FILES, Up: Top -10 BUGS-*******+6 BUGS+****** The need to precede options with '--' when invoked from hledger is awkward.@@ -516,30 +519,25 @@ Tag Table: Node: Top71-Node: OPTIONS1554-Ref: #options1651-Node: keys5718-Ref: #keys5813-Node: screens10145-Ref: #screens10254-Node: accounts screen10254-Ref: #accounts-screen10390-Node: Register screen12605-Ref: #register-screen12752-Node: Transaction screen14749-Ref: #transaction-screen14899-Node: Error screen15769-Ref: #error-screen15903-Node: ENVIRONMENT16147-Ref: #environment16266-Node: FILES17073-Ref: #files17172-Node: BUGS17385-Ref: #bugs17464+Node: OPTIONS1434+Ref: #options1531+Node: KEYS5598+Ref: #keys5693+Node: SCREENS10012+Ref: #screens10117+Node: Accounts screen10207+Ref: #accounts-screen10335+Node: Register screen12550+Ref: #register-screen12705+Node: Transaction screen14702+Ref: #transaction-screen14860+Node: Error screen15730+Ref: #error-screen15852+Node: ENVIRONMENT16096+Ref: #environment16210+Node: FILES17017+Ref: #files17116+Node: BUGS17329+Ref: #bugs17406 End Tag Table---Local Variables:-coding: utf-8-End:
hledger-ui.txt view
@@ -1,10 +1,10 @@ -hledger-ui(1) hledger User Manuals hledger-ui(1)+HLEDGER-UI(1) hledger User Manuals HLEDGER-UI(1) NAME- hledger-ui - terminal interface for the hledger accounting tool+ A terminal interface (TUI) for the hledger accounting tool. SYNOPSIS hledger-ui [OPTIONS] [QUERYARGS]@@ -185,16 +185,16 @@ --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,+ 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.) -keys- ? 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:+KEYS+ ? 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 (or enter) goes deeper, left returns to+ 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. Emacs-style (ctrl-p/ctrl-n/ctrl-f/ctrl-b) movement keys are also supported (but not vi-style keys, since hledger-1.19,@@ -202,87 +202,87 @@ 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+ 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+ 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+ 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 /+ 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 escapeto cancel. there are also keys for quickly adjusting some+ 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).- backspace or delete removes all filters, showing all transactions.+ BACKSPACE or DELETE removes all filters, showing all transactions. - as mentioned above, by default hledger-ui hides future transactions -+ As mentioned above, by default hledger-ui hides future transactions - both ordinary transactions recorded in the journal, and periodic trans-- actions generated by rule. f toggles forecast mode, in which fu-- ture/forecasted transactions are shown. (experimental)+ actions generated by rule. F toggles forecast mode, in which fu-+ ture/forecasted transactions are shown. - escape resets the UI state and jumps back to the top screen, restoring+ 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 en- try or the help dialog. - ctrl-l redraws the screen and centers the selection if possible (selec-+ 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+ 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.+ 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 installed in+ 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 cursor+ 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 possi- ble) when invoked from the error screen. - b toggles cost mode, showing amounts in their transaction price's com-- modity (like toggling the -b/--cost flag).+ B toggles cost mode, showing amounts in their transaction price's com-+ modity (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 transaction+ 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. - at most one of cost or value mode can be active at once.+ 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;+ 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 mode. - with --watch active, if you save an edit to the journal file while- viewing the transaction screen in cost or value mode, the b/v keys will- stop working. to work around, press g to force a manual reload, or+ With --watch active, if you save an edit to the journal file while+ viewing the transaction screen in cost or value mode, the B/V keys will+ stop working. To work around, press g to force a manual reload, or exit the transaction screen. q quits the application. - additional screen-specific keys are described below.+ Additional screen-specific keys are described below. -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+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+ 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@@ -452,9 +452,11 @@ SEE ALSO- hledger(1), hledger-ui(1), hledger-web(1), hledger_csv(5),- hledger_journal(5), hledger_timeclock(5), hledger_timedot(5), ledger(1)+ hledger(1), hledger-ui(1), hledger-web(1), ledger(1) + hledger_journal(5), hledger_csv(5), hledger_timeclock(5), hledger_time-+ dot(5) -hledger-ui 1.20.1 December 2020 hledger-ui(1)++hledger-ui-1.20.1 December 2020 HLEDGER-UI(1)