ui: document latest keys

hledger-ui/doc/hledger-ui.1

@@ -226,18 +226,22 @@ 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.
 .PP
-\f[C]g\f[] gets the latest data and reloads the screen (and any previous
+\f[C]g\f[] gets the latest data and refreshes the screen (and any
-screens).
+previous screens).
 With large journal files, there can be a noticeable pause.
 .PP
-\f[C]q\f[] quits the application.
+\f[C]/\f[] lets you set or change the filter query, which limits the
+data shown on most screens (in addition to the quick filters described
+below).
+While editing the query you can use typical command\-line edit keys
+(ctrl\-a/e/k), press enter to set the new filter, or press escape to
+cancel.
 .PP
-\f[C]f\f[] lets you add or change the current filter query which limits
+\f[C]BACKSPACE\f[] or \f[C]DELETE\f[] clears any filters in effect.
-the data shown on most screens.
+.PP
-While editing, you can use typical command\-line edit keys, and press
+\f[C]ESCAPE\f[] clears any filters and jumps to the top screen.
-enter to set the new filter, or escape to cancel.
+.PP
-Note queries which filter by account name may not work well in the
+\f[C]q\f[] quits the application.
-register screen.
 .PP
 Additional screen\-specific keys are described below.
 .SH SCREENS
@@ -330,6 +334,9 @@ transactions/postings are shown.
 .PP
 Press \f[C]right\f[] or \f[C]enter\f[] to view the selected transaction
 in full detail.
+.PP
+Note, filter queries which filter by account name do not yet do much
+useful on this screen.
 .SS Transaction screen
 .PP
 This screen shows a single transaction, as a general journal entry,

hledger-ui/doc/hledger-ui.1.info

@@ -157,16 +157,20 @@ Generally 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.
 
-   `g' gets the latest data and reloads the screen (and any previous
+   `g' gets the latest data and refreshes the screen (and any previous
 screens). With large journal files, there can be a noticeable pause.
 
-   `q' quits the application.
+   `/' lets you set or change the filter query, which limits the data
+shown on most screens (in addition to the quick filters described
+below). While editing the query you can use typical command-line edit
+keys (ctrl-a/e/k), press enter to set the new filter, or press escape to
+cancel.
 
-   `f' lets you add or change the current filter query which limits the
+   `BACKSPACE' or `DELETE' clears any filters in effect.
-data shown on most screens. While editing, you can use typical
+
-command-line edit keys, and press enter to set the new filter, or escape
+   `ESCAPE' clears any filters and jumps to the top screen.
-to cancel. Note queries which filter by account name may not work well
+
-in the register screen.
+   `q' quits the application.
 
    Additional screen-specific keys are described below.
 
@@ -267,6 +271,9 @@ uncleared transactions/postings are shown.
    Press `right' or `enter' to view the selected transaction in full
 detail.
 
+   Note, filter queries which filter by account name do not yet do much
+useful on this screen.
+
 
 File: hledger-ui.1.info,  Node: Transaction screen,  Next: Error screen,  Prev: Register screen,  Up: SCREENS
 
@@ -309,15 +316,15 @@ Node: OPTIONS714
 Ref: #options813
 Node: KEYS3689
 Ref: #keys3786
-Node: SCREENS4506
+Node: SCREENS4611
-Ref: #screens4593
+Ref: #screens4698
-Node: Accounts screen4683
+Node: Accounts screen4788
-Ref: #accounts-screen4813
+Ref: #accounts-screen4918
-Node: Register screen5917
+Node: Register screen6022
-Ref: #register-screen6074
+Ref: #register-screen6179
-Node: Transaction screen7731
+Node: Transaction screen7932
-Ref: #transaction-screen7891
+Ref: #transaction-screen8092
-Node: Error screen8758
+Node: Error screen8959
-Ref: #error-screen8882
+Ref: #error-screen9083
 
 End Tag Table

hledger-ui/doc/hledger-ui.1.m4.md

@@ -87,16 +87,20 @@ _reportingoptions_
 Generally 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.
 
-`g` gets the latest data and reloads the screen (and any previous
+`g` gets the latest data and refreshes the screen (and any previous
 screens). With large journal files, there can be a noticeable pause.
 
-`q` quits the application.
+`/` lets you set or change the [filter query](/journal.html#queries),
+which limits the data shown on most screens (in addition to the quick
+filters described below). While editing the query you can use typical
+command-line edit keys (ctrl-a/e/k), press enter to set the new filter,
+or press escape to cancel.
 
-`f` lets you add or change the current
+`BACKSPACE` or `DELETE` clears any filters in effect.
-[filter query](/journal.html#queries) which limits the data shown on
+
-most screens. While editing, you can use typical command-line edit keys,
+`ESCAPE` clears any filters and jumps to the top screen.
-and press enter to set the new filter, or escape to cancel. Note queries
+
-which filter by account name may not work well in the register screen.
+`q` quits the application.
 
 Additional screen-specific keys are described below.
 
@@ -178,6 +182,9 @@ transactions/postings are shown.
 Press `right` or `enter` to view the selected transaction in full
 detail.
 
+Note, filter queries which filter by account name do not yet do much
+useful on this screen.
+
 ## Transaction screen
 
 This screen shows a single transaction, as a general journal entry,

hledger-ui/doc/hledger-ui.1.txt

@@ -149,16 +149,20 @@ KKEEYYSS
        returns to the previous screen, up/down/page up/page down/home/end move
        up and down through lists.
 
-       g  gets  the  latest  data  and  reloads  the  screen (and any previous
+       g  gets  the  latest  data  and  refreshes the screen (and any previous
        screens).  With large journal files, there can be a noticeable pause.
 
-       q quits the application.
+       / lets you set or change the filter query, which limits the data  shown
+       on  most  screens  (in  addition to the quick filters described below).
+       While editing the query you can  use  typical  command-line  edit  keys
+       (ctrl-a/e/k),  press  enter  to  set the new filter, or press escape to
+       cancel.
 
-       f lets you add or change the current filter query which limits the data
+       BACKSPACE or DELETE clears any filters in effect.
-       shown on most screens.  While editing, you can use typical command-line
+
-       edit keys, and press enter to set the new filter, or escape to  cancel.
+       ESCAPE clears any filters and jumps to the top screen.
-       Note queries which filter by account name may not work well in the reg-
+
-       ister screen.
+       q quits the application.
 
        Additional screen-specific keys are described below.
 
@@ -232,6 +236,9 @@ SSCCRREEEENNSS
 
        Press right or enter to view the selected transaction in full detail.
 
+       Note,  filter  queries  which filter by account name do not yet do much
+       useful on this screen.
+
    TTrraannssaaccttiioonn ssccrreeeenn
        This screen shows a single transaction, as  a  general  journal  entry,
        similar  to  hledger's  print command and journal format (hledger_jour-