;doc: update manuals

This commit is contained in:
Simon Michael 2022-11-07 16:18:28 -10:00
parent 82aa8f1975
commit 6e5c30ea1a
3 changed files with 198 additions and 134 deletions

View File

@ -53,6 +53,18 @@ watch for data and date changes and reload automatically
\f[B]\f[CB]--theme=default|terminal|greenterm\f[B]\f[R]
use this custom display theme
.TP
\f[B]\f[CB]--menu\f[B]\f[R]
start in the menu screen
.TP
\f[B]\f[CB]--all\f[B]\f[R]
start in the all accounts screen
.TP
\f[B]\f[CB]--bs\f[B]\f[R]
start in the balance sheet accounts screen
.TP
\f[B]\f[CB]--is\f[B]\f[R]
start in the income statement accounts screen
.TP
\f[B]\f[CB]--register=ACCTREGEX\f[B]\f[R]
start in the (first) matched account\[aq]s register screen
.TP
@ -335,6 +347,17 @@ reliably reset to normal mode.
.PP
Additional screen-specific keys are described below.
.SH SCREENS
.PP
hledger-ui can show a number of different screens, described below.
It shows the Balance sheet accounts screen to start with, except in the
following situations:
.IP \[bu] 2
If no asset/liability/equity accounts can be detected, or if an account
query has been given on the command line, it starts in the All accounts
screen.
.IP \[bu] 2
If a starting screen is specified with --menu/--all/--bs/--is/--register
on the command line, it starts there.
.SS Menu screen
.PP
The top-most screen.
@ -343,14 +366,13 @@ to navigate to it.
From here you can navigate to three accounts screens:
.SS All accounts screen
.PP
This screen shows all accounts (unless filtered by a query), and their
This screen shows all accounts (possibly filtered by a query), and their
current balances.
It is like the \f[C]hledger balance\f[R] command.
.SS Balance sheet accounts screen
.PP
This is the screen normally shown at startup.
It shows asset, liability and equity accounts, if these can be detected
(see account types).
This screen shows asset, liability and equity accounts, if these can be
detected (see account types).
It always shows historical end balances on some date (not balance
changes).
It is like the \f[C]hledger balancesheetequity\f[R] command.

View File

@ -68,6 +68,18 @@ the data.
'--theme=default|terminal|greenterm'
use this custom display theme
'--menu'
start in the menu screen
'--all'
start in the all accounts screen
'--bs'
start in the balance sheet accounts screen
'--is'
start in the income statement accounts screen
'--register=ACCTREGEX'
start in the (first) matched account's register screen
@ -352,6 +364,17 @@ File: hledger-ui.info, Node: SCREENS, Next: TIPS, Prev: KEYS, Up: Top
4 SCREENS
*********
hledger-ui can show a number of different screens, described below. It
shows the Balance sheet accounts screen to start with, except in the
following situations:
* If no asset/liability/equity accounts can be detected, or if an
account query has been given on the command line, it starts in the
All accounts screen.
* If a starting screen is specified with -menu/-all/-bs/-is/-register
on the command line, it starts there.
* Menu:
* Menu screen::
@ -378,7 +401,7 @@ File: hledger-ui.info, Node: All accounts screen, Next: Balance sheet accounts
4.2 All accounts screen
=======================
This screen shows all accounts (unless filtered by a query), and their
This screen shows all accounts (possibly filtered by a query), and their
current balances. It is like the 'hledger balance' command.

@ -387,10 +410,10 @@ File: hledger-ui.info, Node: Balance sheet accounts screen, Next: Income state
4.3 Balance sheet accounts screen
=================================
This is the screen normally shown at startup. It shows asset, liability
and equity accounts, if these can be detected (see account types). It
always shows historical end balances on some date (not balance changes).
It is like the 'hledger balancesheetequity' command.
This screen shows asset, liability and equity accounts, if these can be
detected (see account types). It always shows historical end balances
on some date (not balance changes). It is like the 'hledger
balancesheetequity' command.

File: hledger-ui.info, Node: Income statement accounts screen, Next: Register screen, Prev: Balance sheet accounts screen, Up: SCREENS
@ -676,38 +699,38 @@ Tag Table:
Node: Top221
Node: OPTIONS1657
Ref: #options1755
Node: MOUSE6637
Ref: #mouse6732
Node: KEYS7014
Ref: #keys7107
Node: SCREENS11193
Ref: #screens11291
Node: Menu screen11472
Ref: #menu-screen11592
Node: All accounts screen11761
Ref: #all-accounts-screen11935
Node: Balance sheet accounts screen12068
Ref: #balance-sheet-accounts-screen12283
Node: Income statement accounts screen12554
Ref: #income-statement-accounts-screen12771
Node: Register screen15216
Ref: #register-screen15388
Node: Transaction screen17372
Ref: #transaction-screen17530
Node: Error screen18400
Ref: #error-screen18522
Node: TIPS18766
Ref: #tips18865
Node: Watch mode18907
Ref: #watch-mode19014
Node: Debug output20470
Ref: #debug-output20581
Node: ENVIRONMENT20793
Ref: #environment20904
Node: FILES22289
Ref: #files22388
Node: BUGS22601
Ref: #bugs22678
Node: MOUSE6839
Ref: #mouse6934
Node: KEYS7216
Ref: #keys7309
Node: SCREENS11395
Ref: #screens11493
Node: Menu screen12123
Ref: #menu-screen12243
Node: All accounts screen12412
Ref: #all-accounts-screen12586
Node: Balance sheet accounts screen12721
Ref: #balance-sheet-accounts-screen12936
Node: Income statement accounts screen13170
Ref: #income-statement-accounts-screen13387
Node: Register screen15832
Ref: #register-screen16004
Node: Transaction screen17988
Ref: #transaction-screen18146
Node: Error screen19016
Ref: #error-screen19138
Node: TIPS19382
Ref: #tips19481
Node: Watch mode19523
Ref: #watch-mode19630
Node: Debug output21086
Ref: #debug-output21197
Node: ENVIRONMENT21409
Ref: #environment21520
Node: FILES22905
Ref: #files23004
Node: BUGS23217
Ref: #bugs23294

End Tag Table

View File

@ -47,6 +47,14 @@ OPTIONS
--theme=default|terminal|greenterm
use this custom display theme
--menu start in the menu screen
--all start in the all accounts screen
--bs start in the balance sheet accounts screen
--is start in the income statement accounts screen
--register=ACCTREGEX
start in the (first) matched account's register screen
@ -308,20 +316,31 @@ KEYS
Additional screen-specific keys are described below.
SCREENS
hledger-ui can show a number of different screens, described below. It
shows the Balance sheet accounts screen to start with, except in the
following situations:
o If no asset/liability/equity accounts can be detected, or if an
account query has been given on the command line, it starts in the
All accounts screen.
o If a starting screen is specified with --menu/--all/--bs/--is/--reg-
ister on the command line, it starts there.
Menu screen
The top-most screen. hledger-ui does not show this screen at startup,
but you can press LEFT to navigate to it. From here you can navigate
to three accounts screens:
All accounts screen
This screen shows all accounts (unless filtered by a query), and their
current balances. It is like the hledger balance command.
This screen shows all accounts (possibly filtered by a query), and
their current balances. It is like the hledger balance command.
Balance sheet accounts screen
This is the screen normally shown at startup. It shows asset, liabil-
ity and equity accounts, if these can be detected (see account types).
It always shows historical end balances on some date (not balance
changes). It is like the hledger balancesheetequity command.
This screen shows asset, liability and equity accounts, if these can be
detected (see account types). It always shows historical end balances
on some date (not balance changes). It is like the hledger bal-
ancesheetequity command.
Income statement accounts screen
This screen shows revenue and expense accounts. It always shows bal-