diff --git a/hledger-lib/.date.m4 b/hledger-lib/.date.m4 index 196a44605..b7f3131e4 100644 --- a/hledger-lib/.date.m4 +++ b/hledger-lib/.date.m4 @@ -1,2 +1,2 @@ m4_dnl Date to show in man pages. Updated by "Shake manuals" -m4_define({{_monthyear_}}, {{September 2022}})m4_dnl +m4_define({{_monthyear_}}, {{October 2022}})m4_dnl diff --git a/hledger-ui/.date.m4 b/hledger-ui/.date.m4 index 196a44605..b7f3131e4 100644 --- a/hledger-ui/.date.m4 +++ b/hledger-ui/.date.m4 @@ -1,2 +1,2 @@ m4_dnl Date to show in man pages. Updated by "Shake manuals" -m4_define({{_monthyear_}}, {{September 2022}})m4_dnl +m4_define({{_monthyear_}}, {{October 2022}})m4_dnl diff --git a/hledger-ui/hledger-ui.1 b/hledger-ui/hledger-ui.1 index e36d8cfd5..8c84c1308 100644 --- a/hledger-ui/hledger-ui.1 +++ b/hledger-ui/hledger-ui.1 @@ -1,5 +1,5 @@ -.TH "HLEDGER-UI" "1" "September 2022" "hledger-ui-1.27 " "hledger User Manuals" +.TH "HLEDGER-UI" "1" "October 2022" "hledger-ui-1.27.99 " "hledger User Manuals" @@ -7,7 +7,7 @@ .PP hledger-ui is a terminal interface (TUI) for the hledger accounting tool. -This manual is for hledger-ui 1.27. +This manual is for hledger-ui 1.27.99. .SH SYNOPSIS .PP \f[C]hledger-ui [OPTIONS] [QUERYARGS]\f[R] @@ -335,6 +335,10 @@ reliably reset to normal mode. .PP Additional screen-specific keys are described below. .SH SCREENS +.SS Menu screen +.PP +The top-most screen, currently with just one menu item and not shown by +default. .SS Accounts screen .PP This is normally the first screen displayed. @@ -389,6 +393,7 @@ balances are shown (hledger-ui shows zero items by default, unlike command-line hledger). .PP Press \f[C]RIGHT\f[R] to view an account\[aq]s transactions register. +Or, \f[C]LEFT\f[R] to see the menu screen. .SS Register screen .PP This screen shows the transactions affecting a particular account, like @@ -455,6 +460,25 @@ They will vary depending on which account register you came from The #N number preceding them is the transaction\[aq]s position within the complete unfiltered journal, which is a more stable id (at least until the next reload). +.SS Balance sheet accounts screen +.PP +This is like the accounts screen except: +.IP \[bu] 2 +it shows only asset, liability and equity accounts (see account types) +.IP \[bu] 2 +it always shows historical end balances on some date (not balance +changes). +.PP +It corresponds to the \f[C]hledger balancesheet\f[R] command. +.SS Income statement accounts screen +.PP +Like the accounts screen except: +.IP \[bu] 2 +it shows only revenue and expense accounts +.IP \[bu] 2 +it always shows balance changes in some period (not end balances). +.PP +It corresponds to the \f[C]hledger incomestatement\f[R] command. .SS Error screen .PP This screen will appear if there is a problem, such as a parse error, diff --git a/hledger-ui/hledger-ui.info b/hledger-ui/hledger-ui.info index 87d6550cd..05b004e8d 100644 --- a/hledger-ui/hledger-ui.info +++ b/hledger-ui/hledger-ui.info @@ -12,7 +12,7 @@ hledger-ui(1) ************* hledger-ui is a terminal interface (TUI) for the hledger accounting -tool. This manual is for hledger-ui 1.27. +tool. This manual is for hledger-ui 1.27.99. 'hledger-ui [OPTIONS] [QUERYARGS]' 'hledger ui -- [OPTIONS] [QUERYARGS]' @@ -354,15 +354,27 @@ File: hledger-ui.info, Node: SCREENS, Next: TIPS, Prev: KEYS, Up: Top * Menu: +* Menu screen:: * Accounts screen:: * Register screen:: * Transaction screen:: +* Balance sheet accounts screen:: +* Income statement accounts screen:: * Error screen::  -File: hledger-ui.info, Node: Accounts screen, Next: Register screen, Up: SCREENS +File: hledger-ui.info, Node: Menu screen, Next: Accounts screen, Up: SCREENS -4.1 Accounts screen +4.1 Menu screen +=============== + +The top-most screen, currently with just one menu item and not shown by +default. + + +File: hledger-ui.info, Node: Accounts screen, Next: Register screen, Prev: Menu screen, Up: SCREENS + +4.2 Accounts screen =================== This is normally the first screen displayed. It lists accounts and @@ -408,12 +420,13 @@ is removed.) 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. Or, 'LEFT' +to see the menu screen.  File: hledger-ui.info, Node: Register screen, Next: Transaction screen, Prev: Accounts screen, Up: SCREENS -4.2 Register screen +4.3 Register screen =================== This screen shows the transactions affecting a particular account, like @@ -457,9 +470,9 @@ command-line hledger). Press 'RIGHT' to view the selected transaction in detail.  -File: hledger-ui.info, Node: Transaction screen, Next: Error screen, Prev: Register screen, Up: SCREENS +File: hledger-ui.info, Node: Transaction screen, Next: Balance sheet accounts screen, Prev: Register screen, Up: SCREENS -4.3 Transaction screen +4.4 Transaction screen ====================== This screen shows a single transaction, as a general journal entry, @@ -481,9 +494,37 @@ unfiltered journal, which is a more stable id (at least until the next reload).  -File: hledger-ui.info, Node: Error screen, Prev: Transaction screen, Up: SCREENS +File: hledger-ui.info, Node: Balance sheet accounts screen, Next: Income statement accounts screen, Prev: Transaction screen, Up: SCREENS -4.4 Error screen +4.5 Balance sheet accounts screen +================================= + +This is like the accounts screen except: + + * it shows only asset, liability and equity accounts (see account + types) + * it always shows historical end balances on some date (not balance + changes). + + It corresponds to the 'hledger balancesheet' command. + + +File: hledger-ui.info, Node: Income statement accounts screen, Next: Error screen, Prev: Balance sheet accounts screen, Up: SCREENS + +4.6 Income statement accounts screen +==================================== + +Like the accounts screen except: + + * it shows only revenue and expense accounts + * it always shows balance changes in some period (not end balances). + + It corresponds to the 'hledger incomestatement' command. + + +File: hledger-ui.info, Node: Error screen, Prev: Income statement accounts screen, Up: SCREENS + +4.7 Error screen ================ This screen will appear if there is a problem, such as a parse error, @@ -640,34 +681,40 @@ program is restarted.  Tag Table: Node: Top221 -Node: OPTIONS1654 -Ref: #options1752 -Node: MOUSE6634 -Ref: #mouse6729 -Node: KEYS7011 -Ref: #keys7104 -Node: SCREENS11190 -Ref: #screens11288 -Node: Accounts screen11378 -Ref: #accounts-screen11506 -Node: Register screen13845 -Ref: #register-screen14000 -Node: Transaction screen15984 -Ref: #transaction-screen16142 -Node: Error screen17012 -Ref: #error-screen17134 -Node: TIPS17378 -Ref: #tips17477 -Node: Watch mode17529 -Ref: #watch-mode17646 -Node: Watch mode limitations18396 -Ref: #watch-mode-limitations18537 -Node: ENVIRONMENT19673 -Ref: #environment19784 -Node: FILES21169 -Ref: #files21268 -Node: BUGS21481 -Ref: #bugs21558 +Node: OPTIONS1657 +Ref: #options1755 +Node: MOUSE6637 +Ref: #mouse6732 +Node: KEYS7014 +Ref: #keys7107 +Node: SCREENS11193 +Ref: #screens11291 +Node: Menu screen11468 +Ref: #menu-screen11584 +Node: Accounts screen11666 +Ref: #accounts-screen11814 +Node: Register screen14189 +Ref: #register-screen14344 +Node: Transaction screen16328 +Ref: #transaction-screen16503 +Node: Balance sheet accounts screen17373 +Ref: #balance-sheet-accounts-screen17587 +Node: Income statement accounts screen17855 +Ref: #income-statement-accounts-screen18069 +Node: Error screen18285 +Ref: #error-screen18421 +Node: TIPS18665 +Ref: #tips18764 +Node: Watch mode18816 +Ref: #watch-mode18933 +Node: Watch mode limitations19683 +Ref: #watch-mode-limitations19824 +Node: ENVIRONMENT20960 +Ref: #environment21071 +Node: FILES22456 +Ref: #files22555 +Node: BUGS22768 +Ref: #bugs22845  End Tag Table diff --git a/hledger-ui/hledger-ui.txt b/hledger-ui/hledger-ui.txt index f4caaae65..38bf4249a 100644 --- a/hledger-ui/hledger-ui.txt +++ b/hledger-ui/hledger-ui.txt @@ -5,7 +5,7 @@ HLEDGER-UI(1) hledger User Manuals HLEDGER-UI(1) NAME hledger-ui is a terminal interface (TUI) for the hledger accounting - tool. This manual is for hledger-ui 1.27. + tool. This manual is for hledger-ui 1.27.99. SYNOPSIS hledger-ui [OPTIONS] [QUERYARGS] @@ -308,50 +308,55 @@ KEYS Additional screen-specific keys are described below. SCREENS + Menu screen + The top-most screen, currently with just one menu item and not shown by + default. + 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). Accounts which have been declared with an account - directive are also listed, even if not yet used (except for empty par- - ent accounts). 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). Accounts which have been declared with an account + directive are also listed, even if not yet used (except for empty par- + ent accounts). 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 subac- - counts, except where subaccounts are hidden by a depth limit (see - below). In tree mode, all account balances are inclusive of subac- + Account names are shown as a flat list by default; press t to toggle + tree mode. In list mode, account balances are exclusive of subac- + counts, except where subaccounts are hidden by a depth limit (see + below). In tree mode, all account balances are inclusive of subac- counts. - To see less detail, press a number key, 1 to 9, to set a depth limit. + 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 + 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. 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 to view an account's transactions register. + Press RIGHT to view an account's transactions register. Or, LEFT to + see the menu screen. Register screen This screen shows the transactions affecting a particular account, like @@ -411,6 +416,26 @@ SCREENS them is the transaction's position within the complete unfiltered jour- nal, which is a more stable id (at least until the next reload). + Balance sheet accounts screen + This is like the accounts screen except: + + o it shows only asset, liability and equity accounts (see account + types) + + o it always shows historical end balances on some date (not balance + changes). + + It corresponds to the hledger balancesheet command. + + Income statement accounts screen + Like the accounts screen except: + + o it shows only revenue and expense accounts + + o it always shows balance changes in some period (not end balances). + + It corresponds to the hledger incomestatement command. + 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 @@ -549,4 +574,4 @@ SEE ALSO -hledger-ui-1.27 September 2022 HLEDGER-UI(1) +hledger-ui-1.27.99 October 2022 HLEDGER-UI(1) diff --git a/hledger-web/.date.m4 b/hledger-web/.date.m4 index 196a44605..b7f3131e4 100644 --- a/hledger-web/.date.m4 +++ b/hledger-web/.date.m4 @@ -1,2 +1,2 @@ m4_dnl Date to show in man pages. Updated by "Shake manuals" -m4_define({{_monthyear_}}, {{September 2022}})m4_dnl +m4_define({{_monthyear_}}, {{October 2022}})m4_dnl diff --git a/hledger-web/hledger-web.1 b/hledger-web/hledger-web.1 index f454ac42b..983d78932 100644 --- a/hledger-web/hledger-web.1 +++ b/hledger-web/hledger-web.1 @@ -1,12 +1,12 @@ -.TH "HLEDGER-WEB" "1" "September 2022" "hledger-web-1.27 " "hledger User Manuals" +.TH "HLEDGER-WEB" "1" "October 2022" "hledger-web-1.27.99 " "hledger User Manuals" .SH NAME .PP hledger-web is a web interface (WUI) for the hledger accounting tool. -This manual is for hledger-web 1.27. +This manual is for hledger-web 1.27.99. .SH SYNOPSIS .PP \f[C]hledger-web [OPTIONS]\f[R] diff --git a/hledger-web/hledger-web.info b/hledger-web/hledger-web.info index 6c829da2d..2562281aa 100644 --- a/hledger-web/hledger-web.info +++ b/hledger-web/hledger-web.info @@ -12,7 +12,7 @@ hledger-web(1) ************** hledger-web is a web interface (WUI) for the hledger accounting tool. -This manual is for hledger-web 1.27. +This manual is for hledger-web 1.27.99. 'hledger-web [OPTIONS]' 'hledger web -- [OPTIONS]' @@ -632,22 +632,22 @@ awkward.  Tag Table: Node: Top223 -Node: OPTIONS1886 -Ref: #options1991 -Node: PERMISSIONS9902 -Ref: #permissions10041 -Node: EDITING UPLOADING DOWNLOADING11253 -Ref: #editing-uploading-downloading11434 -Node: RELOADING12268 -Ref: #reloading12402 -Node: JSON API12835 -Ref: #json-api12949 -Node: ENVIRONMENT18439 -Ref: #environment18555 -Node: FILES19866 -Ref: #files19966 -Node: BUGS20179 -Ref: #bugs20257 +Node: OPTIONS1889 +Ref: #options1994 +Node: PERMISSIONS9905 +Ref: #permissions10044 +Node: EDITING UPLOADING DOWNLOADING11256 +Ref: #editing-uploading-downloading11437 +Node: RELOADING12271 +Ref: #reloading12405 +Node: JSON API12838 +Ref: #json-api12952 +Node: ENVIRONMENT18442 +Ref: #environment18558 +Node: FILES19869 +Ref: #files19969 +Node: BUGS20182 +Ref: #bugs20260  End Tag Table diff --git a/hledger-web/hledger-web.txt b/hledger-web/hledger-web.txt index e54e3865b..de059699b 100644 --- a/hledger-web/hledger-web.txt +++ b/hledger-web/hledger-web.txt @@ -5,7 +5,7 @@ HLEDGER-WEB(1) hledger User Manuals HLEDGER-WEB(1) NAME hledger-web is a web interface (WUI) for the hledger accounting tool. - This manual is for hledger-web 1.27. + This manual is for hledger-web 1.27.99. SYNOPSIS hledger-web [OPTIONS] @@ -586,4 +586,4 @@ SEE ALSO -hledger-web-1.27 September 2022 HLEDGER-WEB(1) +hledger-web-1.27.99 October 2022 HLEDGER-WEB(1) diff --git a/hledger/.date.m4 b/hledger/.date.m4 index 196a44605..b7f3131e4 100644 --- a/hledger/.date.m4 +++ b/hledger/.date.m4 @@ -1,2 +1,2 @@ m4_dnl Date to show in man pages. Updated by "Shake manuals" -m4_define({{_monthyear_}}, {{September 2022}})m4_dnl +m4_define({{_monthyear_}}, {{October 2022}})m4_dnl diff --git a/hledger/hledger.1 b/hledger/hledger.1 index a5634e24f..70173610f 100644 --- a/hledger/hledger.1 +++ b/hledger/hledger.1 @@ -1,6 +1,6 @@ .\"t -.TH "HLEDGER" "1" "September 2022" "hledger-1.27 " "hledger User Manuals" +.TH "HLEDGER" "1" "October 2022" "hledger-1.27.99 " "hledger User Manuals" @@ -9,7 +9,7 @@ This is the command-line interface (CLI) for the hledger accounting tool. Here we also describe hledger\[aq]s concepts and file formats. -This manual is for hledger 1.27. +This manual is for hledger 1.27.99. .SH SYNOPSIS .PP \f[C]hledger\f[R] @@ -3281,7 +3281,7 @@ backward. Input prompts are displayed in a different colour when the terminal supports it. .PP -Example (see the tutorial for a detailed explanation): +Example (see https://hledger.org/add.html for a detailed tutorial): .IP .nf \f[C] @@ -9781,8 +9781,10 @@ date-format DATEFMT This is a helper for the \f[C]date\f[R] (and \f[C]date2\f[R]) fields. If your CSV dates are not formatted like \f[C]YYYY-MM-DD\f[R], \f[C]YYYY/MM/DD\f[R] or \f[C]YYYY.MM.DD\f[R], you\[aq]ll need to add a -date-format rule describing them with a strptime date parsing pattern, -which must parse the CSV date value completely. +date-format rule describing them with a strptime-style date parsing +pattern - see +https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime. +The pattern must parse the CSV date value completely. Some examples: .IP .nf @@ -9814,17 +9816,41 @@ date-format %Y-%h-%d date-format %-m/%-d/%Y %l:%M %p some other junk \f[R] .fi +.SS \f[C]timezone\f[R] +.IP +.nf +\f[C] +timezone TIMEZONE +\f[R] +.fi .PP -For the supported strptime syntax, see: -.PD 0 -.P -.PD -https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime +When CSV contains date-times that are implicitly in some time zone other +than yours, but containing no explicit time zone information, you can +use this rule to declare the CSV\[aq]s native time zone, which helps +prevent off-by-one dates. .PP -Note that although you can parse date-times which include a time zone, -that time zone is ignored; it will not change the date that is parsed. -This means when reading CSV data with times not in your local time zone, -dates can be \[dq]off by one\[dq]. +When the CSV date-times do contain time zone information, you don\[aq]t +need this rule; instead, use \f[C]%Z\f[R] in \f[C]date-format\f[R] (or +\f[C]%z\f[R], \f[C]%EZ\f[R], \f[C]%Ez\f[R]; see the formatTime link +above). +.PP +In either of these cases, hledger will do a time-zone-aware conversion, +localising the CSV date-times to your current system time zone. +If you prefer to localise to some other time zone, eg for +reproducibility, you can (on unix at least) set the output timezone with +the TZ environment variable, eg: +.IP +.nf +\f[C] +$ TZ=HST hledger print -f foo.csv # or TZ=HST hledger import foo.csv +\f[R] +.fi +.PP +\f[C]timezone\f[R] currently does not understand timezone names, except +\[dq]UTC\[dq], \[dq]GMT\[dq], \[dq]EST\[dq], \[dq]EDT\[dq], +\[dq]CST\[dq], \[dq]CDT\[dq], \[dq]MST\[dq], \[dq]MDT\[dq], +\[dq]PST\[dq], or \[dq]PDT\[dq]. +For others, use numeric format: +HHMM or -HHMM. .SS \f[C]decimal-mark\f[R] .IP .nf diff --git a/hledger/hledger.info b/hledger/hledger.info index 3916630db..ab2401be0 100644 --- a/hledger/hledger.info +++ b/hledger/hledger.info @@ -13,7 +13,7 @@ hledger(1) This is the command-line interface (CLI) for the hledger accounting tool. Here we also describe hledger's concepts and file formats. This -manual is for hledger 1.27. +manual is for hledger 1.27.99. 'hledger' @@ -2624,7 +2624,7 @@ or press control-d or control-c to exit. * Input prompts are displayed in a different colour when the terminal supports it. - Example (see the tutorial for a detailed explanation): + Example (see https://hledger.org/add.html for a detailed tutorial): $ hledger add Adding transactions to journal file /src/hledger/examples/sample.journal @@ -8009,6 +8009,7 @@ Blank lines and lines beginning with '#' or ';' are ignored. * if table:: * end:: * date-format:: +* timezone:: * decimal-mark:: * newest-first:: * include:: @@ -8475,7 +8476,7 @@ if ,,,, end  -File: hledger.info, Node: date-format, Next: decimal-mark, Prev: end, Up: CSV rules +File: hledger.info, Node: date-format, Next: timezone, Prev: end, Up: CSV rules 13.2.9 'date-format' -------------------- @@ -8484,9 +8485,10 @@ date-format DATEFMT This is a helper for the 'date' (and 'date2') fields. If your CSV dates are not formatted like 'YYYY-MM-DD', 'YYYY/MM/DD' or 'YYYY.MM.DD', -you'll need to add a date-format rule describing them with a strptime -date parsing pattern, which must parse the CSV date value completely. -Some examples: +you'll need to add a date-format rule describing them with a +strptime-style date parsing pattern - see +https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime. +The pattern must parse the CSV date value completely. Some examples: # MM/DD/YY date-format %m/%d/%y @@ -8502,18 +8504,39 @@ date-format %Y-%h-%d # Note the time and junk must be fully parsed, though only the date is used. date-format %-m/%-d/%Y %l:%M %p some other junk - For the supported strptime syntax, see: -https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime + +File: hledger.info, Node: timezone, Next: decimal-mark, Prev: date-format, Up: CSV rules - Note that although you can parse date-times which include a time -zone, that time zone is ignored; it will not change the date that is -parsed. This means when reading CSV data with times not in your local -time zone, dates can be "off by one". +13.2.10 'timezone' +------------------ + +timezone TIMEZONE + + When CSV contains date-times that are implicitly in some time zone +other than yours, but containing no explicit time zone information, you +can use this rule to declare the CSV's native time zone, which helps +prevent off-by-one dates. + + When the CSV date-times do contain time zone information, you don't +need this rule; instead, use '%Z' in 'date-format' (or '%z', '%EZ', +'%Ez'; see the formatTime link above). + + In either of these cases, hledger will do a time-zone-aware +conversion, localising the CSV date-times to your current system time +zone. If you prefer to localise to some other time zone, eg for +reproducibility, you can (on unix at least) set the output timezone with +the TZ environment variable, eg: + +$ TZ=HST hledger print -f foo.csv # or TZ=HST hledger import foo.csv + + 'timezone' currently does not understand timezone names, except +"UTC", "GMT", "EST", "EDT", "CST", "CDT", "MST", "MDT", "PST", or "PDT". +For others, use numeric format: +HHMM or -HHMM.  -File: hledger.info, Node: decimal-mark, Next: newest-first, Prev: date-format, Up: CSV rules +File: hledger.info, Node: decimal-mark, Next: newest-first, Prev: timezone, Up: CSV rules -13.2.10 'decimal-mark' +13.2.11 'decimal-mark' ---------------------- decimal-mark . @@ -8531,7 +8554,7 @@ misparsed numbers.  File: hledger.info, Node: newest-first, Next: include, Prev: decimal-mark, Up: CSV rules -13.2.11 'newest-first' +13.2.12 'newest-first' ---------------------- hledger always sorts the generated transactions by date. Transactions @@ -8553,7 +8576,7 @@ newest-first  File: hledger.info, Node: include, Next: balance-type, Prev: newest-first, Up: CSV rules -13.2.12 'include' +13.2.13 'include' ----------------- include RULESFILE @@ -8576,7 +8599,7 @@ include categorisation.rules  File: hledger.info, Node: balance-type, Prev: include, Up: CSV rules -13.2.13 'balance-type' +13.2.14 'balance-type' ---------------------- Balance assertions generated by assigning to balanceN are of the simple @@ -9707,556 +9730,558 @@ $ LANG=en_US.UTF-8 hledger -f my.journal print  Tag Table: Node: Top208 -Node: OPTIONS2599 -Ref: #options2700 -Node: General options2842 -Ref: #general-options2967 -Node: Command options7180 -Ref: #command-options7331 -Node: Command arguments7731 -Ref: #command-arguments7889 -Node: Special characters8769 -Ref: #special-characters8932 -Node: Single escaping shell metacharacters9095 -Ref: #single-escaping-shell-metacharacters9336 -Node: Double escaping regular expression metacharacters9939 -Ref: #double-escaping-regular-expression-metacharacters10250 -Node: Triple escaping for add-on commands10776 -Ref: #triple-escaping-for-add-on-commands11036 -Node: Less escaping11680 -Ref: #less-escaping11834 -Node: Unicode characters12158 -Ref: #unicode-characters12323 -Node: Regular expressions13735 -Ref: #regular-expressions13875 -Node: ENVIRONMENT15611 -Ref: #environment15727 -Node: DATA FILES17296 -Ref: #data-files17415 -Node: Data formats17958 -Ref: #data-formats18076 -Node: Multiple files19470 -Ref: #multiple-files19612 -Node: Strict mode20081 -Ref: #strict-mode20196 -Node: TIME PERIODS20920 -Ref: #time-periods21037 -Node: Smart dates21135 -Ref: #smart-dates21261 -Node: Report start & end date23091 -Ref: #report-start-end-date23266 -Node: Report intervals24933 -Ref: #report-intervals25101 -Node: Period expressions26840 -Ref: #period-expressions26980 -Node: Period expressions with a report interval28711 -Ref: #period-expressions-with-a-report-interval28943 -Node: More complex report intervals30024 -Ref: #more-complex-report-intervals30273 -Node: Intervals with custom start date30913 -Ref: #intervals-with-custom-start-date31145 -Node: Periods or dates ?32719 -Ref: #periods-or-dates32921 -Node: Events on multiple weekdays33363 -Ref: #events-on-multiple-weekdays33542 -Node: DEPTH34405 -Ref: #depth34505 -Node: QUERIES34839 -Ref: #queries34935 -Node: Query types35876 -Ref: #query-types35995 -Node: Combining query terms39169 -Ref: #combining-query-terms39344 -Node: Queries and command options40147 -Ref: #queries-and-command-options40350 -Node: Queries and account aliases40599 -Ref: #queries-and-account-aliases40802 -Node: Queries and valuation40922 -Ref: #queries-and-valuation41115 -Node: Querying with account aliases41344 -Ref: #querying-with-account-aliases41553 -Node: Querying with cost or value41683 -Ref: #querying-with-cost-or-value41858 -Node: COST42159 -Ref: #cost42253 -Node: -B Convert to cost43447 -Ref: #b-convert-to-cost43591 -Node: Equity conversion postings45019 -Ref: #equity-conversion-postings45221 -Node: Inferring equity postings from cost45848 -Ref: #inferring-equity-postings-from-cost46085 -Node: Inferring cost from equity postings47074 -Ref: #inferring-cost-from-equity-postings47310 -Node: When to infer cost/equity49535 -Ref: #when-to-infer-costequity49741 -Node: How to record conversions50137 -Ref: #how-to-record-conversions50317 -Node: Conversion with implicit cost50608 -Ref: #conversion-with-implicit-cost50811 -Node: Conversion with explicit cost51688 -Ref: #conversion-with-explicit-cost51931 -Node: Conversion with equity postings52348 -Ref: #conversion-with-equity-postings52615 -Node: Conversion with equity postings and explicit cost53434 -Ref: #conversion-with-equity-postings-and-explicit-cost53699 -Node: Cost tips54304 -Ref: #cost-tips54418 -Node: VALUATION55147 -Ref: #valuation55252 -Node: -V Value56019 -Ref: #v-value56143 -Node: -X Value in specified commodity56338 -Ref: #x-value-in-specified-commodity56531 -Node: Valuation date56680 -Ref: #valuation-date56842 -Node: Market prices57279 -Ref: #market-prices57461 -Node: --infer-market-prices market prices from transactions58644 -Ref: #infer-market-prices-market-prices-from-transactions58911 -Node: Valuation commodity60795 -Ref: #valuation-commodity61006 -Node: Simple valuation examples62232 -Ref: #simple-valuation-examples62428 -Node: --value Flexible valuation63087 -Ref: #value-flexible-valuation63289 -Node: More valuation examples64933 -Ref: #more-valuation-examples65140 -Node: Interaction of valuation and queries67139 -Ref: #interaction-of-valuation-and-queries67378 -Node: Effect of valuation on reports67850 -Ref: #effect-of-valuation-on-reports68045 -Node: PIVOTING75742 -Ref: #pivoting75847 -Node: OUTPUT77533 -Ref: #output77635 -Node: Output destination77726 -Ref: #output-destination77860 -Node: Output styling78517 -Ref: #output-styling78665 -Node: Output format79422 -Ref: #output-format79566 -Node: CSV output80930 -Ref: #csv-output81048 -Node: HTML output81151 -Ref: #html-output81291 -Node: JSON output81385 -Ref: #json-output81525 -Node: SQL output82442 -Ref: #sql-output82560 -Node: Commodity styles83061 -Ref: #commodity-styles83188 -Node: COMMANDS83964 -Ref: #commands84076 -Node: accounts87330 -Ref: #accounts87430 -Node: activity88582 -Ref: #activity88694 -Node: add89077 -Ref: #add89180 -Node: aregister91975 -Ref: #aregister92089 -Node: aregister and custom posting dates94758 -Ref: #aregister-and-custom-posting-dates94924 -Node: balance95476 -Ref: #balance95595 -Node: balance features96588 -Ref: #balance-features96728 -Node: Simple balance report98652 -Ref: #simple-balance-report98834 -Node: Filtered balance report100314 -Ref: #filtered-balance-report100501 -Node: List or tree mode100828 -Ref: #list-or-tree-mode100996 -Node: Depth limiting102341 -Ref: #depth-limiting102507 -Node: Dropping top-level accounts103108 -Ref: #dropping-top-level-accounts103310 -Node: Multi-period balance report103620 -Ref: #multi-period-balance-report103833 -Node: Showing declared accounts106108 -Ref: #showing-declared-accounts106301 -Node: Data layout106832 -Ref: #data-layout106987 -Node: Sorting by amount114927 -Ref: #sorting-by-amount115082 -Node: Percentages115752 -Ref: #percentages115910 -Node: Balance change end balance116871 -Ref: #balance-change-end-balance117064 -Node: Balance report types118492 -Ref: #balance-report-types118682 -Node: Useful balance reports122961 -Ref: #useful-balance-reports123142 -Node: Budget report124227 -Ref: #budget-report124411 -Node: Budget report start date129686 -Ref: #budget-report-start-date129864 -Node: Budgets and subaccounts131196 -Ref: #budgets-and-subaccounts131403 -Node: Selecting budget goals134843 -Ref: #selecting-budget-goals135015 -Node: Customising single-period balance reports136049 -Ref: #customising-single-period-balance-reports136258 -Node: balancesheet138433 -Ref: #balancesheet138571 -Node: balancesheetequity139899 -Ref: #balancesheetequity140050 -Node: cashflow141453 -Ref: #cashflow141577 -Node: check143009 -Ref: #check143114 -Node: Basic checks143922 -Ref: #basic-checks144040 -Node: Strict checks144591 -Ref: #strict-checks144732 -Node: Other checks145168 -Ref: #other-checks145308 -Node: Custom checks145807 -Ref: #custom-checks145962 -Node: More about specific checks146379 -Ref: #more-about-specific-checks146539 -Node: close147267 -Ref: #close147371 -Node: close and prices149462 -Ref: #close-and-prices149591 -Node: close date149986 -Ref: #close-date150170 -Node: Example close asset/liability accounts for file transition150927 -Ref: #example-close-assetliability-accounts-for-file-transition151228 -Node: Hiding opening/closing transactions152087 -Ref: #hiding-openingclosing-transactions152358 -Node: close and balance assertions153735 -Ref: #close-and-balance-assertions153993 -Node: Example close revenue/expense accounts to retained earnings155347 -Ref: #example-close-revenueexpense-accounts-to-retained-earnings155625 -Node: codes156515 -Ref: #codes156625 -Node: commodities157337 -Ref: #commodities157466 -Node: descriptions157548 -Ref: #descriptions157678 -Node: diff157982 -Ref: #diff158090 -Node: files159137 -Ref: #files159239 -Node: help159386 -Ref: #help159488 -Node: import160439 -Ref: #import160555 -Node: Deduplication161648 -Ref: #deduplication161773 -Node: Import testing163667 -Ref: #import-testing163832 -Node: Importing balance assignments164320 -Ref: #importing-balance-assignments164526 -Node: Commodity display styles165175 -Ref: #commodity-display-styles165348 -Node: incomestatement165477 -Ref: #incomestatement165612 -Node: notes166944 -Ref: #notes167059 -Node: payees167427 -Ref: #payees167535 -Node: prices168061 -Ref: #prices168169 -Node: print168538 -Ref: #print168650 -Node: print-unique174018 -Ref: #print-unique174146 -Node: register174431 -Ref: #register174560 -Node: Custom register output179310 -Ref: #custom-register-output179441 -Node: register-match180778 -Ref: #register-match180914 -Node: rewrite181265 -Ref: #rewrite181382 -Node: Re-write rules in a file183288 -Ref: #re-write-rules-in-a-file183451 -Node: Diff output format184600 -Ref: #diff-output-format184783 -Node: rewrite vs print --auto185875 -Ref: #rewrite-vs.-print---auto186035 -Node: roi186591 -Ref: #roi186691 -Node: Spaces and special characters in --inv and --pnl188416 -Ref: #spaces-and-special-characters-in---inv-and---pnl188656 -Node: Semantics of --inv and --pnl189144 -Ref: #semantics-of---inv-and---pnl189383 -Node: IRR and TWR explained191233 -Ref: #irr-and-twr-explained191393 -Node: stats194479 -Ref: #stats194580 -Node: tags195960 -Ref: #tags196060 -Node: test197074 -Ref: #test197184 -Node: Add-on commands197931 -Ref: #add-on-commands198050 -Node: JOURNAL FORMAT199181 -Ref: #journal-format199309 -Node: Transactions201536 -Ref: #transactions201651 -Node: Dates202665 -Ref: #dates202781 -Node: Simple dates202846 -Ref: #simple-dates202966 -Node: Secondary dates203475 -Ref: #secondary-dates203623 -Node: Posting dates204959 -Ref: #posting-dates205082 -Node: Status206454 -Ref: #status206564 -Node: Code208272 -Ref: #code208384 -Node: Description208616 -Ref: #description208744 -Node: Payee and note209064 -Ref: #payee-and-note209172 -Node: Comments209507 -Ref: #comments209629 -Node: Tags210823 -Ref: #tags-1210934 -Node: Postings212389 -Ref: #postings212513 -Node: Virtual postings213539 -Ref: #virtual-postings213650 -Node: Account names214955 -Ref: #account-names215092 -Node: Amounts215580 -Ref: #amounts215717 -Node: Decimal marks digit group marks216702 -Ref: #decimal-marks-digit-group-marks216879 -Node: Commodity217900 -Ref: #commodity218089 -Node: Directives influencing number parsing and display219041 -Ref: #directives-influencing-number-parsing-and-display219302 -Node: Commodity display style219795 -Ref: #commodity-display-style220003 -Node: Rounding222198 -Ref: #rounding222318 -Node: Transaction prices222730 -Ref: #transaction-prices222896 -Node: Lot prices lot dates224819 -Ref: #lot-prices-lot-dates225002 -Node: Balance assertions225490 -Ref: #balance-assertions225668 -Node: Assertions and ordering226741 -Ref: #assertions-and-ordering226932 -Node: Assertions and multiple included files227632 -Ref: #assertions-and-multiple-included-files227894 -Node: Assertions and multiple -f files228394 -Ref: #assertions-and-multiple--f-files228647 -Node: Assertions and commodities229044 -Ref: #assertions-and-commodities229268 -Node: Assertions and prices230448 -Ref: #assertions-and-prices230656 -Node: Assertions and subaccounts231096 -Ref: #assertions-and-subaccounts231319 -Node: Assertions and virtual postings231643 -Ref: #assertions-and-virtual-postings231883 -Node: Assertions and auto postings232015 -Ref: #assertions-and-auto-postings232247 -Node: Assertions and precision232892 -Ref: #assertions-and-precision233076 -Node: Balance assignments233343 -Ref: #balance-assignments233513 -Node: Balance assignments and prices234677 -Ref: #balance-assignments-and-prices234843 -Node: Directives235067 -Ref: #directives235230 -Node: Directives and multiple files239722 -Ref: #directives-and-multiple-files239918 -Node: Comment blocks240610 -Ref: #comment-blocks240787 -Node: Including other files240963 -Ref: #including-other-files241137 -Node: Default year242061 -Ref: #default-year242219 -Node: Declaring payees242626 -Ref: #declaring-payees242797 -Node: Declaring the decimal mark243043 -Ref: #declaring-the-decimal-mark243243 -Node: Declaring commodities243640 -Ref: #declaring-commodities243831 -Node: Commodity error checking246349 -Ref: #commodity-error-checking246499 -Node: Default commodity247014 -Ref: #default-commodity247194 -Node: Declaring market prices248310 -Ref: #declaring-market-prices248499 -Node: Declaring accounts249312 -Ref: #declaring-accounts249492 -Node: Account comments250656 -Ref: #account-comments250809 -Node: Account subdirectives251232 -Ref: #account-subdirectives251426 -Node: Account error checking251568 -Ref: #account-error-checking251769 -Node: Account display order252958 -Ref: #account-display-order253149 -Node: Account types254250 -Ref: #account-types254394 -Node: Rewriting accounts258068 -Ref: #rewriting-accounts258247 -Node: Basic aliases259287 -Ref: #basic-aliases259423 -Node: Regex aliases260167 -Ref: #regex-aliases260329 -Node: Combining aliases261219 -Ref: #combining-aliases261402 -Node: Aliases and multiple files262678 -Ref: #aliases-and-multiple-files262877 -Node: end aliases263456 -Ref: #end-aliases263650 -Node: Aliases can generate bad account names263799 -Ref: #aliases-can-generate-bad-account-names264042 -Node: Aliases and account types264627 -Ref: #aliases-and-account-types264824 -Node: Default parent account265520 -Ref: #default-parent-account265710 -Node: Periodic transactions266594 -Ref: #periodic-transactions266777 -Node: Periodic rule syntax268732 -Ref: #periodic-rule-syntax268912 -Node: Periodic rules and relative dates269371 -Ref: #periodic-rules-and-relative-dates269639 -Node: Two spaces between period expression and description!270150 -Ref: #two-spaces-between-period-expression-and-description270476 -Node: Forecasting with periodic transactions271160 -Ref: #forecasting-with-periodic-transactions271459 -Node: Budgeting with periodic transactions274230 -Ref: #budgeting-with-periodic-transactions274463 -Node: Auto postings274872 -Ref: #auto-postings275008 -Node: Auto postings and multiple files277187 -Ref: #auto-postings-and-multiple-files277385 -Node: Auto postings and dates277594 -Ref: #auto-postings-and-dates277862 -Node: Auto postings and transaction balancing / inferred amounts / balance assertions278037 -Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions278382 -Node: Auto posting tags278885 -Ref: #auto-posting-tags279094 -Node: CSV FORMAT279730 -Ref: #csv-format279858 -Node: Examples282488 -Ref: #examples282591 -Node: Basic282799 -Ref: #basic282901 -Node: Bank of Ireland283443 -Ref: #bank-of-ireland283580 -Node: Amazon285042 -Ref: #amazon285162 -Node: Paypal286881 -Ref: #paypal286977 -Node: CSV rules294621 -Ref: #csv-rules294739 -Node: skip295072 -Ref: #skip295172 -Node: fields list295547 -Ref: #fields-list295686 -Node: field assignment297252 -Ref: #field-assignment297404 -Node: Field names298439 -Ref: #field-names298579 -Node: date field298959 -Ref: #date-field299079 -Node: date2 field299127 -Ref: #date2-field299270 -Node: status field299326 -Ref: #status-field299471 -Node: code field299520 -Ref: #code-field299667 -Node: description field299712 -Ref: #description-field299874 -Node: comment field299933 -Ref: #comment-field300090 -Node: account field300401 -Ref: #account-field300553 -Node: amount field301128 -Ref: #amount-field301279 -Node: currency field302524 -Ref: #currency-field302679 -Node: balance field302936 -Ref: #balance-field303070 -Node: separator303442 -Ref: #separator303574 -Node: if block304114 -Ref: #if-block304241 -Node: Matching the whole record304642 -Ref: #matching-the-whole-record304819 -Node: Matching individual fields305622 -Ref: #matching-individual-fields305828 -Node: Combining matchers306052 -Ref: #combining-matchers306250 -Node: Rules applied on successful match306563 -Ref: #rules-applied-on-successful-match306756 -Node: if table307410 -Ref: #if-table307531 -Node: end309269 -Ref: #end309383 -Node: date-format309607 -Ref: #date-format309741 -Node: decimal-mark310737 -Ref: #decimal-mark310884 -Node: newest-first311223 -Ref: #newest-first311366 -Node: include312049 -Ref: #include312182 -Node: balance-type312626 -Ref: #balance-type312748 -Node: Tips313448 -Ref: #tips313539 -Node: Rapid feedback313838 -Ref: #rapid-feedback313957 -Node: Valid CSV314409 -Ref: #valid-csv314541 -Node: File Extension314733 -Ref: #file-extension314887 -Node: Reading multiple CSV files315316 -Ref: #reading-multiple-csv-files315503 -Node: Valid transactions315744 -Ref: #valid-transactions315924 -Node: Deduplicating importing316552 -Ref: #deduplicating-importing316733 -Node: Setting amounts317769 -Ref: #setting-amounts317926 -Node: Amount signs320370 -Ref: #amount-signs320524 -Node: Setting currency/commodity321211 -Ref: #setting-currencycommodity321399 -Node: Amount decimal places322573 -Ref: #amount-decimal-places322765 -Node: Referencing other fields323077 -Ref: #referencing-other-fields323276 -Node: How CSV rules are evaluated324173 -Ref: #how-csv-rules-are-evaluated324348 -Node: TIMECLOCK FORMAT325799 -Ref: #timeclock-format325939 -Node: TIMEDOT FORMAT328000 -Ref: #timedot-format328138 -Node: COMMON TASKS332700 -Ref: #common-tasks332829 -Node: Getting help333103 -Ref: #getting-help333237 -Node: Constructing command lines333989 -Ref: #constructing-command-lines334183 -Node: Starting a journal file334880 -Ref: #starting-a-journal-file335080 -Node: Setting opening balances336268 -Ref: #setting-opening-balances336466 -Node: Recording transactions339607 -Ref: #recording-transactions339789 -Node: Reconciling340345 -Ref: #reconciling340490 -Node: Reporting342747 -Ref: #reporting342889 -Node: Migrating to a new file346874 -Ref: #migrating-to-a-new-file347024 -Node: LIMITATIONS347323 -Ref: #limitations347451 -Node: TROUBLESHOOTING348220 -Ref: #troubleshooting348335 +Node: OPTIONS2602 +Ref: #options2703 +Node: General options2845 +Ref: #general-options2970 +Node: Command options7183 +Ref: #command-options7334 +Node: Command arguments7734 +Ref: #command-arguments7892 +Node: Special characters8772 +Ref: #special-characters8935 +Node: Single escaping shell metacharacters9098 +Ref: #single-escaping-shell-metacharacters9339 +Node: Double escaping regular expression metacharacters9942 +Ref: #double-escaping-regular-expression-metacharacters10253 +Node: Triple escaping for add-on commands10779 +Ref: #triple-escaping-for-add-on-commands11039 +Node: Less escaping11683 +Ref: #less-escaping11837 +Node: Unicode characters12161 +Ref: #unicode-characters12326 +Node: Regular expressions13738 +Ref: #regular-expressions13878 +Node: ENVIRONMENT15614 +Ref: #environment15730 +Node: DATA FILES17299 +Ref: #data-files17418 +Node: Data formats17961 +Ref: #data-formats18079 +Node: Multiple files19473 +Ref: #multiple-files19615 +Node: Strict mode20084 +Ref: #strict-mode20199 +Node: TIME PERIODS20923 +Ref: #time-periods21040 +Node: Smart dates21138 +Ref: #smart-dates21264 +Node: Report start & end date23094 +Ref: #report-start-end-date23269 +Node: Report intervals24936 +Ref: #report-intervals25104 +Node: Period expressions26843 +Ref: #period-expressions26983 +Node: Period expressions with a report interval28714 +Ref: #period-expressions-with-a-report-interval28946 +Node: More complex report intervals30027 +Ref: #more-complex-report-intervals30276 +Node: Intervals with custom start date30916 +Ref: #intervals-with-custom-start-date31148 +Node: Periods or dates ?32722 +Ref: #periods-or-dates32924 +Node: Events on multiple weekdays33366 +Ref: #events-on-multiple-weekdays33545 +Node: DEPTH34408 +Ref: #depth34508 +Node: QUERIES34842 +Ref: #queries34938 +Node: Query types35879 +Ref: #query-types35998 +Node: Combining query terms39172 +Ref: #combining-query-terms39347 +Node: Queries and command options40150 +Ref: #queries-and-command-options40353 +Node: Queries and account aliases40602 +Ref: #queries-and-account-aliases40805 +Node: Queries and valuation40925 +Ref: #queries-and-valuation41118 +Node: Querying with account aliases41347 +Ref: #querying-with-account-aliases41556 +Node: Querying with cost or value41686 +Ref: #querying-with-cost-or-value41861 +Node: COST42162 +Ref: #cost42256 +Node: -B Convert to cost43450 +Ref: #b-convert-to-cost43594 +Node: Equity conversion postings45022 +Ref: #equity-conversion-postings45224 +Node: Inferring equity postings from cost45851 +Ref: #inferring-equity-postings-from-cost46088 +Node: Inferring cost from equity postings47077 +Ref: #inferring-cost-from-equity-postings47313 +Node: When to infer cost/equity49538 +Ref: #when-to-infer-costequity49744 +Node: How to record conversions50140 +Ref: #how-to-record-conversions50320 +Node: Conversion with implicit cost50611 +Ref: #conversion-with-implicit-cost50814 +Node: Conversion with explicit cost51691 +Ref: #conversion-with-explicit-cost51934 +Node: Conversion with equity postings52351 +Ref: #conversion-with-equity-postings52618 +Node: Conversion with equity postings and explicit cost53437 +Ref: #conversion-with-equity-postings-and-explicit-cost53702 +Node: Cost tips54307 +Ref: #cost-tips54421 +Node: VALUATION55150 +Ref: #valuation55255 +Node: -V Value56022 +Ref: #v-value56146 +Node: -X Value in specified commodity56341 +Ref: #x-value-in-specified-commodity56534 +Node: Valuation date56683 +Ref: #valuation-date56845 +Node: Market prices57282 +Ref: #market-prices57464 +Node: --infer-market-prices market prices from transactions58647 +Ref: #infer-market-prices-market-prices-from-transactions58914 +Node: Valuation commodity60798 +Ref: #valuation-commodity61009 +Node: Simple valuation examples62235 +Ref: #simple-valuation-examples62431 +Node: --value Flexible valuation63090 +Ref: #value-flexible-valuation63292 +Node: More valuation examples64936 +Ref: #more-valuation-examples65143 +Node: Interaction of valuation and queries67142 +Ref: #interaction-of-valuation-and-queries67381 +Node: Effect of valuation on reports67853 +Ref: #effect-of-valuation-on-reports68048 +Node: PIVOTING75745 +Ref: #pivoting75850 +Node: OUTPUT77536 +Ref: #output77638 +Node: Output destination77729 +Ref: #output-destination77863 +Node: Output styling78520 +Ref: #output-styling78668 +Node: Output format79425 +Ref: #output-format79569 +Node: CSV output80933 +Ref: #csv-output81051 +Node: HTML output81154 +Ref: #html-output81294 +Node: JSON output81388 +Ref: #json-output81528 +Node: SQL output82445 +Ref: #sql-output82563 +Node: Commodity styles83064 +Ref: #commodity-styles83191 +Node: COMMANDS83967 +Ref: #commands84079 +Node: accounts87333 +Ref: #accounts87433 +Node: activity88585 +Ref: #activity88697 +Node: add89080 +Ref: #add89183 +Node: aregister91991 +Ref: #aregister92105 +Node: aregister and custom posting dates94774 +Ref: #aregister-and-custom-posting-dates94940 +Node: balance95492 +Ref: #balance95611 +Node: balance features96604 +Ref: #balance-features96744 +Node: Simple balance report98668 +Ref: #simple-balance-report98850 +Node: Filtered balance report100330 +Ref: #filtered-balance-report100517 +Node: List or tree mode100844 +Ref: #list-or-tree-mode101012 +Node: Depth limiting102357 +Ref: #depth-limiting102523 +Node: Dropping top-level accounts103124 +Ref: #dropping-top-level-accounts103326 +Node: Multi-period balance report103636 +Ref: #multi-period-balance-report103849 +Node: Showing declared accounts106124 +Ref: #showing-declared-accounts106317 +Node: Data layout106848 +Ref: #data-layout107003 +Node: Sorting by amount114943 +Ref: #sorting-by-amount115098 +Node: Percentages115768 +Ref: #percentages115926 +Node: Balance change end balance116887 +Ref: #balance-change-end-balance117080 +Node: Balance report types118508 +Ref: #balance-report-types118698 +Node: Useful balance reports122977 +Ref: #useful-balance-reports123158 +Node: Budget report124243 +Ref: #budget-report124427 +Node: Budget report start date129702 +Ref: #budget-report-start-date129880 +Node: Budgets and subaccounts131212 +Ref: #budgets-and-subaccounts131419 +Node: Selecting budget goals134859 +Ref: #selecting-budget-goals135031 +Node: Customising single-period balance reports136065 +Ref: #customising-single-period-balance-reports136274 +Node: balancesheet138449 +Ref: #balancesheet138587 +Node: balancesheetequity139915 +Ref: #balancesheetequity140066 +Node: cashflow141469 +Ref: #cashflow141593 +Node: check143025 +Ref: #check143130 +Node: Basic checks143938 +Ref: #basic-checks144056 +Node: Strict checks144607 +Ref: #strict-checks144748 +Node: Other checks145184 +Ref: #other-checks145324 +Node: Custom checks145823 +Ref: #custom-checks145978 +Node: More about specific checks146395 +Ref: #more-about-specific-checks146555 +Node: close147283 +Ref: #close147387 +Node: close and prices149478 +Ref: #close-and-prices149607 +Node: close date150002 +Ref: #close-date150186 +Node: Example close asset/liability accounts for file transition150943 +Ref: #example-close-assetliability-accounts-for-file-transition151244 +Node: Hiding opening/closing transactions152103 +Ref: #hiding-openingclosing-transactions152374 +Node: close and balance assertions153751 +Ref: #close-and-balance-assertions154009 +Node: Example close revenue/expense accounts to retained earnings155363 +Ref: #example-close-revenueexpense-accounts-to-retained-earnings155641 +Node: codes156531 +Ref: #codes156641 +Node: commodities157353 +Ref: #commodities157482 +Node: descriptions157564 +Ref: #descriptions157694 +Node: diff157998 +Ref: #diff158106 +Node: files159153 +Ref: #files159255 +Node: help159402 +Ref: #help159504 +Node: import160455 +Ref: #import160571 +Node: Deduplication161664 +Ref: #deduplication161789 +Node: Import testing163683 +Ref: #import-testing163848 +Node: Importing balance assignments164336 +Ref: #importing-balance-assignments164542 +Node: Commodity display styles165191 +Ref: #commodity-display-styles165364 +Node: incomestatement165493 +Ref: #incomestatement165628 +Node: notes166960 +Ref: #notes167075 +Node: payees167443 +Ref: #payees167551 +Node: prices168077 +Ref: #prices168185 +Node: print168554 +Ref: #print168666 +Node: print-unique174034 +Ref: #print-unique174162 +Node: register174447 +Ref: #register174576 +Node: Custom register output179326 +Ref: #custom-register-output179457 +Node: register-match180794 +Ref: #register-match180930 +Node: rewrite181281 +Ref: #rewrite181398 +Node: Re-write rules in a file183304 +Ref: #re-write-rules-in-a-file183467 +Node: Diff output format184616 +Ref: #diff-output-format184799 +Node: rewrite vs print --auto185891 +Ref: #rewrite-vs.-print---auto186051 +Node: roi186607 +Ref: #roi186707 +Node: Spaces and special characters in --inv and --pnl188432 +Ref: #spaces-and-special-characters-in---inv-and---pnl188672 +Node: Semantics of --inv and --pnl189160 +Ref: #semantics-of---inv-and---pnl189399 +Node: IRR and TWR explained191249 +Ref: #irr-and-twr-explained191409 +Node: stats194495 +Ref: #stats194596 +Node: tags195976 +Ref: #tags196076 +Node: test197090 +Ref: #test197200 +Node: Add-on commands197947 +Ref: #add-on-commands198066 +Node: JOURNAL FORMAT199197 +Ref: #journal-format199325 +Node: Transactions201552 +Ref: #transactions201667 +Node: Dates202681 +Ref: #dates202797 +Node: Simple dates202862 +Ref: #simple-dates202982 +Node: Secondary dates203491 +Ref: #secondary-dates203639 +Node: Posting dates204975 +Ref: #posting-dates205098 +Node: Status206470 +Ref: #status206580 +Node: Code208288 +Ref: #code208400 +Node: Description208632 +Ref: #description208760 +Node: Payee and note209080 +Ref: #payee-and-note209188 +Node: Comments209523 +Ref: #comments209645 +Node: Tags210839 +Ref: #tags-1210950 +Node: Postings212405 +Ref: #postings212529 +Node: Virtual postings213555 +Ref: #virtual-postings213666 +Node: Account names214971 +Ref: #account-names215108 +Node: Amounts215596 +Ref: #amounts215733 +Node: Decimal marks digit group marks216718 +Ref: #decimal-marks-digit-group-marks216895 +Node: Commodity217916 +Ref: #commodity218105 +Node: Directives influencing number parsing and display219057 +Ref: #directives-influencing-number-parsing-and-display219318 +Node: Commodity display style219811 +Ref: #commodity-display-style220019 +Node: Rounding222214 +Ref: #rounding222334 +Node: Transaction prices222746 +Ref: #transaction-prices222912 +Node: Lot prices lot dates224835 +Ref: #lot-prices-lot-dates225018 +Node: Balance assertions225506 +Ref: #balance-assertions225684 +Node: Assertions and ordering226757 +Ref: #assertions-and-ordering226948 +Node: Assertions and multiple included files227648 +Ref: #assertions-and-multiple-included-files227910 +Node: Assertions and multiple -f files228410 +Ref: #assertions-and-multiple--f-files228663 +Node: Assertions and commodities229060 +Ref: #assertions-and-commodities229284 +Node: Assertions and prices230464 +Ref: #assertions-and-prices230672 +Node: Assertions and subaccounts231112 +Ref: #assertions-and-subaccounts231335 +Node: Assertions and virtual postings231659 +Ref: #assertions-and-virtual-postings231899 +Node: Assertions and auto postings232031 +Ref: #assertions-and-auto-postings232263 +Node: Assertions and precision232908 +Ref: #assertions-and-precision233092 +Node: Balance assignments233359 +Ref: #balance-assignments233529 +Node: Balance assignments and prices234693 +Ref: #balance-assignments-and-prices234859 +Node: Directives235083 +Ref: #directives235246 +Node: Directives and multiple files239738 +Ref: #directives-and-multiple-files239934 +Node: Comment blocks240626 +Ref: #comment-blocks240803 +Node: Including other files240979 +Ref: #including-other-files241153 +Node: Default year242077 +Ref: #default-year242235 +Node: Declaring payees242642 +Ref: #declaring-payees242813 +Node: Declaring the decimal mark243059 +Ref: #declaring-the-decimal-mark243259 +Node: Declaring commodities243656 +Ref: #declaring-commodities243847 +Node: Commodity error checking246365 +Ref: #commodity-error-checking246515 +Node: Default commodity247030 +Ref: #default-commodity247210 +Node: Declaring market prices248326 +Ref: #declaring-market-prices248515 +Node: Declaring accounts249328 +Ref: #declaring-accounts249508 +Node: Account comments250672 +Ref: #account-comments250825 +Node: Account subdirectives251248 +Ref: #account-subdirectives251442 +Node: Account error checking251584 +Ref: #account-error-checking251785 +Node: Account display order252974 +Ref: #account-display-order253165 +Node: Account types254266 +Ref: #account-types254410 +Node: Rewriting accounts258084 +Ref: #rewriting-accounts258263 +Node: Basic aliases259303 +Ref: #basic-aliases259439 +Node: Regex aliases260183 +Ref: #regex-aliases260345 +Node: Combining aliases261235 +Ref: #combining-aliases261418 +Node: Aliases and multiple files262694 +Ref: #aliases-and-multiple-files262893 +Node: end aliases263472 +Ref: #end-aliases263666 +Node: Aliases can generate bad account names263815 +Ref: #aliases-can-generate-bad-account-names264058 +Node: Aliases and account types264643 +Ref: #aliases-and-account-types264840 +Node: Default parent account265536 +Ref: #default-parent-account265726 +Node: Periodic transactions266610 +Ref: #periodic-transactions266793 +Node: Periodic rule syntax268748 +Ref: #periodic-rule-syntax268928 +Node: Periodic rules and relative dates269387 +Ref: #periodic-rules-and-relative-dates269655 +Node: Two spaces between period expression and description!270166 +Ref: #two-spaces-between-period-expression-and-description270492 +Node: Forecasting with periodic transactions271176 +Ref: #forecasting-with-periodic-transactions271475 +Node: Budgeting with periodic transactions274246 +Ref: #budgeting-with-periodic-transactions274479 +Node: Auto postings274888 +Ref: #auto-postings275024 +Node: Auto postings and multiple files277203 +Ref: #auto-postings-and-multiple-files277401 +Node: Auto postings and dates277610 +Ref: #auto-postings-and-dates277878 +Node: Auto postings and transaction balancing / inferred amounts / balance assertions278053 +Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions278398 +Node: Auto posting tags278901 +Ref: #auto-posting-tags279110 +Node: CSV FORMAT279746 +Ref: #csv-format279874 +Node: Examples282504 +Ref: #examples282607 +Node: Basic282815 +Ref: #basic282917 +Node: Bank of Ireland283459 +Ref: #bank-of-ireland283596 +Node: Amazon285058 +Ref: #amazon285178 +Node: Paypal286897 +Ref: #paypal286993 +Node: CSV rules294637 +Ref: #csv-rules294755 +Node: skip295101 +Ref: #skip295201 +Node: fields list295576 +Ref: #fields-list295715 +Node: field assignment297281 +Ref: #field-assignment297433 +Node: Field names298468 +Ref: #field-names298608 +Node: date field298988 +Ref: #date-field299108 +Node: date2 field299156 +Ref: #date2-field299299 +Node: status field299355 +Ref: #status-field299500 +Node: code field299549 +Ref: #code-field299696 +Node: description field299741 +Ref: #description-field299903 +Node: comment field299962 +Ref: #comment-field300119 +Node: account field300430 +Ref: #account-field300582 +Node: amount field301157 +Ref: #amount-field301308 +Node: currency field302553 +Ref: #currency-field302708 +Node: balance field302965 +Ref: #balance-field303099 +Node: separator303471 +Ref: #separator303603 +Node: if block304143 +Ref: #if-block304270 +Node: Matching the whole record304671 +Ref: #matching-the-whole-record304848 +Node: Matching individual fields305651 +Ref: #matching-individual-fields305857 +Node: Combining matchers306081 +Ref: #combining-matchers306279 +Node: Rules applied on successful match306592 +Ref: #rules-applied-on-successful-match306785 +Node: if table307439 +Ref: #if-table307560 +Node: end309298 +Ref: #end309412 +Node: date-format309636 +Ref: #date-format309766 +Node: timezone310490 +Ref: #timezone310625 +Node: decimal-mark311626 +Ref: #decimal-mark311770 +Node: newest-first312109 +Ref: #newest-first312252 +Node: include312935 +Ref: #include313068 +Node: balance-type313512 +Ref: #balance-type313634 +Node: Tips314334 +Ref: #tips314425 +Node: Rapid feedback314724 +Ref: #rapid-feedback314843 +Node: Valid CSV315295 +Ref: #valid-csv315427 +Node: File Extension315619 +Ref: #file-extension315773 +Node: Reading multiple CSV files316202 +Ref: #reading-multiple-csv-files316389 +Node: Valid transactions316630 +Ref: #valid-transactions316810 +Node: Deduplicating importing317438 +Ref: #deduplicating-importing317619 +Node: Setting amounts318655 +Ref: #setting-amounts318812 +Node: Amount signs321256 +Ref: #amount-signs321410 +Node: Setting currency/commodity322097 +Ref: #setting-currencycommodity322285 +Node: Amount decimal places323459 +Ref: #amount-decimal-places323651 +Node: Referencing other fields323963 +Ref: #referencing-other-fields324162 +Node: How CSV rules are evaluated325059 +Ref: #how-csv-rules-are-evaluated325234 +Node: TIMECLOCK FORMAT326685 +Ref: #timeclock-format326825 +Node: TIMEDOT FORMAT328886 +Ref: #timedot-format329024 +Node: COMMON TASKS333586 +Ref: #common-tasks333715 +Node: Getting help333989 +Ref: #getting-help334123 +Node: Constructing command lines334875 +Ref: #constructing-command-lines335069 +Node: Starting a journal file335766 +Ref: #starting-a-journal-file335966 +Node: Setting opening balances337154 +Ref: #setting-opening-balances337352 +Node: Recording transactions340493 +Ref: #recording-transactions340675 +Node: Reconciling341231 +Ref: #reconciling341376 +Node: Reporting343633 +Ref: #reporting343775 +Node: Migrating to a new file347760 +Ref: #migrating-to-a-new-file347910 +Node: LIMITATIONS348209 +Ref: #limitations348337 +Node: TROUBLESHOOTING349106 +Ref: #troubleshooting349221  End Tag Table diff --git a/hledger/hledger.txt b/hledger/hledger.txt index 548ce0e4c..fb7d062ac 100644 --- a/hledger/hledger.txt +++ b/hledger/hledger.txt @@ -6,7 +6,7 @@ HLEDGER(1) hledger User Manuals HLEDGER(1) NAME This is the command-line interface (CLI) for the hledger accounting tool. Here we also describe hledger's concepts and file formats. This - manual is for hledger 1.27. + manual is for hledger 1.27.99. SYNOPSIS hledger @@ -2202,7 +2202,7 @@ COMMANDS o Input prompts are displayed in a different colour when the terminal supports it. - Example (see the tutorial for a detailed explanation): + Example (see https://hledger.org/add.html for a detailed tutorial): $ hledger add Adding transactions to journal file /src/hledger/examples/sample.journal @@ -7079,9 +7079,10 @@ CSV FORMAT This is a helper for the date (and date2) fields. If your CSV dates are not formatted like YYYY-MM-DD, YYYY/MM/DD or YYYY.MM.DD, you'll - need to add a date-format rule describing them with a strptime date - parsing pattern, which must parse the CSV date value completely. Some - examples: + need to add a date-format rule describing them with a strptime-style + date parsing pattern - see https://hackage.haskell.org/pack- + age/time/docs/Data-Time-Format.html#v:formatTime. The pattern must + parse the CSV date value completely. Some examples: # MM/DD/YY date-format %m/%d/%y @@ -7097,14 +7098,29 @@ CSV FORMAT # Note the time and junk must be fully parsed, though only the date is used. date-format %-m/%-d/%Y %l:%M %p some other junk - For the supported strptime syntax, see: - https://hackage.haskell.org/package/time/docs/Data-Time-For- - mat.html#v:formatTime + timezone + timezone TIMEZONE - Note that although you can parse date-times which include a time zone, - that time zone is ignored; it will not change the date that is parsed. - This means when reading CSV data with times not in your local time - zone, dates can be "off by one". + When CSV contains date-times that are implicitly in some time zone + other than yours, but containing no explicit time zone information, you + can use this rule to declare the CSV's native time zone, which helps + prevent off-by-one dates. + + When the CSV date-times do contain time zone information, you don't + need this rule; instead, use %Z in date-format (or %z, %EZ, %Ez; see + the formatTime link above). + + In either of these cases, hledger will do a time-zone-aware conversion, + localising the CSV date-times to your current system time zone. If you + prefer to localise to some other time zone, eg for reproducibility, you + can (on unix at least) set the output timezone with the TZ environment + variable, eg: + + $ TZ=HST hledger print -f foo.csv # or TZ=HST hledger import foo.csv + + timezone currently does not understand timezone names, except "UTC", + "GMT", "EST", "EDT", "CST", "CDT", "MST", "MDT", "PST", or "PDT". For + others, use numeric format: +HHMM or -HHMM. decimal-mark decimal-mark . @@ -8155,4 +8171,4 @@ SEE ALSO -hledger-1.27 September 2022 HLEDGER(1) +hledger-1.27.99 October 2022 HLEDGER(1)