diff --git a/hledger/hledger.1 b/hledger/hledger.1 index c96db9260..a84298ffe 100644 --- a/hledger/hledger.1 +++ b/hledger/hledger.1 @@ -1895,7 +1895,8 @@ rendered on one line \f[C]%20(total)\ \ %2(depth_spacer)%\-(account)\f[] \- the default format for the single\-column balance report .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS Colour support .PP The balance command shows negative amounts in red, if: @@ -2014,7 +2015,8 @@ Normally balancesheet shows historical ending balances, which is what you need for a balance sheet; note this means it ignores report begin dates. .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS balancesheetequity .PP Just like balancesheet, but also reports Equity (which it assumes is @@ -2151,7 +2153,8 @@ Normally cashflow shows changes in assets per period, though as with multicolumn balance reports you can alter the report mode with \f[C]\-\-change\f[]/\f[C]\-\-cumulative\f[]/\f[C]\-\-historical\f[]. .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS check\-dates .PP Check that transactions are sorted by increasing date. @@ -2350,7 +2353,8 @@ Normally incomestatement shows revenues/expenses per period, though as with multicolumn balance reports you can alter the report mode with \f[C]\-\-change\f[]/\f[C]\-\-cumulative\f[]/\f[C]\-\-historical\f[]. .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS prices .PP Print all market prices from the journal. @@ -2463,7 +2467,8 @@ increasing dates, and that transactions on the same day do not get reordered. See also the import command. .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. Here's an example of print's CSV output: .IP .nf @@ -2675,7 +2680,8 @@ $\ hledger\ reg\ \-w\ $COLUMNS,40\ \ \ \ \ \ #\ use\ terminal\ width,\ and\ set\ \f[] .fi .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS register\-match .PP Print the one posting whose transaction description is closest to DESC, @@ -2714,7 +2720,8 @@ The stats command displays summary information for the whole journal, or a matched part of it. With a reporting interval, it shows a report for each report period. .PP -This command also supports output destination and output formats. +This command also supports output destination and output format +selection. .SS tags .PP List all the tag names used in the journal. diff --git a/hledger/hledger.info b/hledger/hledger.info index 06706e67f..6105f4463 100644 --- a/hledger/hledger.info +++ b/hledger/hledger.info @@ -1474,7 +1474,8 @@ may be needed to get pleasing results. * '%20(total) %2(depth_spacer)%-(account)' - the default format for the single-column balance report - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: Colour support, Prev: Custom balance output, Up: balance @@ -1570,7 +1571,8 @@ the report mode with '--change'/'--cumulative'/'--historical'. Normally balancesheet shows historical ending balances, which is what you need for a balance sheet; note this means it ignores report begin dates. - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: balancesheetequity, Next: cashflow, Prev: balancesheet, Up: COMMANDS @@ -1682,7 +1684,8 @@ each report period. Normally cashflow shows changes in assets per period, though as with multicolumn balance reports you can alter the report mode with '--change'/'--cumulative'/'--historical'. - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: check-dates, Next: check-dupes, Prev: cashflow, Up: COMMANDS @@ -1861,7 +1864,8 @@ each report period. Normally incomestatement shows revenues/expenses per period, though as with multicolumn balance reports you can alter the report mode with '--change'/'--cumulative'/'--historical'. - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: prices, Next: print, Prev: incomestatement, Up: COMMANDS @@ -1958,8 +1962,8 @@ $ hledger -f bank1.csv print --new increasing dates, and that transactions on the same day do not get reordered. See also the import command. - This command also supports output destination and output formats. -Here's an example of print's CSV output: + This command also supports output destination and output format +selection. Here's an example of print's CSV output: $ hledger print -Ocsv "txnidx","date","date2","status","code","description","comment","account","amount","commodity","credit","debit","posting-status","posting-comment" @@ -2129,7 +2133,8 @@ $ export COLUMNS=100; hledger reg # set till session end (or window resize) $ hledger reg -w 100,40 # set overall width 100, description width 40 $ hledger reg -w $COLUMNS,40 # use terminal width, and set description width - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: register-match, Next: rewrite, Prev: register, Up: COMMANDS @@ -2178,7 +2183,8 @@ Commodities : 1 ($) or a matched part of it. With a reporting interval, it shows a report for each report period. - This command also supports output destination and output formats. + This command also supports output destination and output format +selection.  File: hledger.info, Node: tags, Next: test, Prev: stats, Up: COMMANDS @@ -2450,75 +2456,75 @@ Node: Budgets44692 Ref: #budgets44839 Node: Custom balance output48670 Ref: #custom-balance-output48832 -Node: Colour support50989 -Ref: #colour-support51121 -Node: balancesheet51294 -Ref: #balancesheet51430 -Node: balancesheetequity53732 -Ref: #balancesheetequity53881 -Node: cashflow54418 -Ref: #cashflow54546 -Node: check-dates56660 -Ref: #check-dates56787 -Node: check-dupes56904 -Ref: #check-dupes57028 -Node: close57165 -Ref: #close57272 -Node: help57602 -Ref: #help57702 -Node: import58776 -Ref: #import58890 -Node: incomestatement59620 -Ref: #incomestatement59754 -Node: prices62149 -Ref: #prices62264 -Node: print62307 -Ref: #print62417 -Node: print-unique67301 -Ref: #print-unique67427 -Node: register67495 -Ref: #register67622 -Node: Custom register output72123 -Ref: #custom-register-output72252 -Node: register-match73473 -Ref: #register-match73607 -Node: rewrite73790 -Ref: #rewrite73907 -Node: stats73976 -Ref: #stats74079 -Node: tags74940 -Ref: #tags75038 -Node: test75274 -Ref: #test75358 -Node: ADD-ON COMMANDS75726 -Ref: #add-on-commands75836 -Node: Official add-ons77123 -Ref: #official-add-ons77263 -Node: api77350 -Ref: #api77439 -Node: ui77491 -Ref: #ui77590 -Node: web77648 -Ref: #web77737 -Node: Third party add-ons77783 -Ref: #third-party-add-ons77958 -Node: diff78093 -Ref: #diff78190 -Node: iadd78289 -Ref: #iadd78403 -Node: interest78486 -Ref: #interest78607 -Node: irr78702 -Ref: #irr78800 -Node: Experimental add-ons78878 -Ref: #experimental-add-ons79030 -Node: autosync79321 -Ref: #autosync79433 -Node: budget79672 -Ref: #budget79794 -Node: chart79860 -Ref: #chart79977 -Node: check80048 -Ref: #check80150 +Node: Colour support50998 +Ref: #colour-support51130 +Node: balancesheet51303 +Ref: #balancesheet51439 +Node: balancesheetequity53750 +Ref: #balancesheetequity53899 +Node: cashflow54436 +Ref: #cashflow54564 +Node: check-dates56687 +Ref: #check-dates56814 +Node: check-dupes56931 +Ref: #check-dupes57055 +Node: close57192 +Ref: #close57299 +Node: help57629 +Ref: #help57729 +Node: import58803 +Ref: #import58917 +Node: incomestatement59647 +Ref: #incomestatement59781 +Node: prices62185 +Ref: #prices62300 +Node: print62343 +Ref: #print62453 +Node: print-unique67347 +Ref: #print-unique67473 +Node: register67541 +Ref: #register67668 +Node: Custom register output72169 +Ref: #custom-register-output72298 +Node: register-match73528 +Ref: #register-match73662 +Node: rewrite73845 +Ref: #rewrite73962 +Node: stats74031 +Ref: #stats74134 +Node: tags75004 +Ref: #tags75102 +Node: test75338 +Ref: #test75422 +Node: ADD-ON COMMANDS75790 +Ref: #add-on-commands75900 +Node: Official add-ons77187 +Ref: #official-add-ons77327 +Node: api77414 +Ref: #api77503 +Node: ui77555 +Ref: #ui77654 +Node: web77712 +Ref: #web77801 +Node: Third party add-ons77847 +Ref: #third-party-add-ons78022 +Node: diff78157 +Ref: #diff78254 +Node: iadd78353 +Ref: #iadd78467 +Node: interest78550 +Ref: #interest78671 +Node: irr78766 +Ref: #irr78864 +Node: Experimental add-ons78942 +Ref: #experimental-add-ons79094 +Node: autosync79385 +Ref: #autosync79497 +Node: budget79736 +Ref: #budget79858 +Node: chart79924 +Ref: #chart80041 +Node: check80112 +Ref: #check80214  End Tag Table diff --git a/hledger/hledger.txt b/hledger/hledger.txt index 5cf6d6ebf..02502c698 100644 --- a/hledger/hledger.txt +++ b/hledger/hledger.txt @@ -1340,7 +1340,8 @@ COMMANDS o %20(total) %2(depth_spacer)%-(account) - the default format for the single-column balance report - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. Colour support The balance command shows negative amounts in red, if: @@ -1351,11 +1352,11 @@ COMMANDS balancesheet This command displays a simple balance sheet, showing historical ending - balances of asset and liability accounts (ignoring any report begin - date). It assumes that these accounts are under a top-level asset or - liability account (case insensitive, plural forms also allowed). Note - this report shows all account balances with normal positive sign (like - conventional financial statements, unlike balance/print/register) + balances of asset and liability accounts (ignoring any report begin + date). It assumes that these accounts are under a top-level asset or + liability account (case insensitive, plural forms also allowed). Note + this report shows all account balances with normal positive sign (like + conventional financial statements, unlike balance/print/register) (experimental). (bs) --change @@ -1363,7 +1364,7 @@ COMMANDS balances --cumulative - show balance change accumulated across periods (in multicolumn + show balance change accumulated across periods (in multicolumn reports), instead of historical ending balances -H --historical @@ -1419,12 +1420,13 @@ COMMANDS 0 With a reporting interval, multiple columns will be shown, one for each - report period. As with multicolumn balance reports, you can alter the - report mode with --change/--cumulative/--historical. Normally bal- - ancesheet shows historical ending balances, which is what you need for + report period. As with multicolumn balance reports, you can alter the + report mode with --change/--cumulative/--historical. Normally bal- + ancesheet shows historical ending balances, which is what you need for a balance sheet; note this means it ignores report begin dates. - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. balancesheetequity Just like balancesheet, but also reports Equity (which it assumes is @@ -1523,33 +1525,34 @@ COMMANDS though as with multicolumn balance reports you can alter the report mode with --change/--cumulative/--historical. - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. check-dates - Check that transactions are sorted by increasing date. With a query, + Check that transactions are sorted by increasing date. With a query, only matched transactions' dates are checked. check-dupes - Report account names having the same leaf but different prefixes. An + Report account names having the same leaf but different prefixes. An example: http://stefanorodighiero.net/software/hledger-dupes.html close - Print closing/opening transactions that bring some or all account bal- - ances to zero and back. Can be useful for bringing asset/liability + Print closing/opening transactions that bring some or all account bal- + ances to zero and back. Can be useful for bringing asset/liability balances across file boundaries, or for closing out income/expenses for - a period. This was formerly called "equity", as in Ledger, and that + a period. This was formerly called "equity", as in Ledger, and that alias is also accepted. See close -help for more. help Show any of the hledger manuals. - The help command displays any of the main hledger manuals, in one of - several ways. Run it with no argument to list the manuals, or provide + The help command displays any of the main hledger manuals, in one of + several ways. Run it with no argument to list the manuals, or provide a full or partial manual name to select one. - hledger manuals are available in several formats. hledger help will - use the first of these display methods that it finds: info, man, - $PAGER, less, stdout (or when non-interactive, just stdout). You can + hledger manuals are available in several formats. hledger help will + use the first of these display methods that it finds: info, man, + $PAGER, less, stdout (or when non-interactive, just stdout). You can force a particular viewer with the --info, --man, --pager, --cat flags. $ hledger help @@ -1573,7 +1576,7 @@ COMMANDS ... import - Read new transactions added to each FILE since last run, and add them + Read new transactions added to each FILE since last run, and add them to the main journal file. --dry-run @@ -1583,28 +1586,28 @@ COMMANDS each one. So eg to add new transactions from all CSV files to the main journal, it's just: hledger import *.csv - New transactions are detected in the same way as print -new: by assum- + New transactions are detected in the same way as print -new: by assum- ing transactions are always added to the input files in increasing date order, and by saving .latest.FILE state files. - The -dry-run output is in journal format, so you can filter it, eg to + The -dry-run output is in journal format, so you can filter it, eg to see only uncategorised transactions: $ hledger import --dry ... | hledger -f- print unknown --ignore-assertions incomestatement - This command displays a simple income statement, showing revenues and - expenses during a period. It assumes that these accounts are under a - top-level revenue or income or expense account (case insensitive, plu- - ral forms also allowed). Note this report shows all account balances - with normal positive sign (like conventional financial statements, + This command displays a simple income statement, showing revenues and + expenses during a period. It assumes that these accounts are under a + top-level revenue or income or expense account (case insensitive, plu- + ral forms also allowed). Note this report shows all account balances + with normal positive sign (like conventional financial statements, unlike balance/print/register) (experimental). (is) --change show balance change in each period (default) --cumulative - show balance change accumulated across periods (in multicolumn + show balance change accumulated across periods (in multicolumn reports), instead of changes during periods -H --historical @@ -1638,8 +1641,8 @@ COMMANDS --sort-amount sort by amount instead of account code/name - This command displays a simple income statement. It currently assumes - that you have top-level accounts named income (or revenue) and expense + This command displays a simple income statement. It currently assumes + that you have top-level accounts named income (or revenue) and expense (plural forms also allowed.) $ hledger incomestatement @@ -1664,11 +1667,12 @@ COMMANDS 0 With a reporting interval, multiple columns will be shown, one for each - report period. Normally incomestatement shows revenues/expenses per - period, though as with multicolumn balance reports you can alter the + report period. Normally incomestatement shows revenues/expenses per + period, though as with multicolumn balance reports you can alter the report mode with --change/--cumulative/--historical. - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. prices Print all market prices from the journal. @@ -1753,8 +1757,8 @@ COMMANDS increasing dates, and that transactions on the same day do not get reordered. See also the import command. - This command also supports output destination and output formats. - Here's an example of print's CSV output: + This command also supports output destination and output format selec- + tion. Here's an example of print's CSV output: $ hledger print -Ocsv "txnidx","date","date2","status","code","description","comment","account","amount","commodity","credit","debit","posting-status","posting-comment" @@ -1907,11 +1911,12 @@ COMMANDS $ hledger reg -w 100,40 # set overall width 100, description width 40 $ hledger reg -w $COLUMNS,40 # use terminal width, and set description width - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. register-match Print the one posting whose transaction description is closest to DESC, - in the style of the register command. Helps ledger-autosync detect + in the style of the register command. Helps ledger-autosync detect already-seen transactions when importing. rewrite @@ -1921,7 +1926,7 @@ COMMANDS Show some journal statistics. -o FILE --output-file=FILE - write output to FILE. A file extension matching one of the + write output to FILE. A file extension matching one of the above formats selects that format. $ hledger stats @@ -1936,11 +1941,12 @@ COMMANDS Accounts : 8 (depth 3) Commodities : 1 ($) - The stats command displays summary information for the whole journal, - or a matched part of it. With a reporting interval, it shows a report + The stats command displays summary information for the whole journal, + or a matched part of it. With a reporting interval, it shows a report for each report period. - This command also supports output destination and output formats. + This command also supports output destination and output format selec- + tion. tags List all the tag names used in the journal. With a TAGREGEX argument, diff --git a/hledger/hledger_balance.m4.md b/hledger/hledger_balance.m4.md index 7dae7f926..dc82e4bb9 100644 --- a/hledger/hledger_balance.m4.md +++ b/hledger/hledger_balance.m4.md @@ -390,7 +390,7 @@ Some example formats: - `%,%-50(account) %25(total)` - account name padded to 50 characters, total padded to 20 characters, with multiple commodities rendered on one line - `%20(total) %2(depth_spacer)%-(account)` - the default format for the single-column balance report -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ### Colour support diff --git a/hledger/hledger_commands.m4.md b/hledger/hledger_commands.m4.md index 86573e016..de50691c0 100644 --- a/hledger/hledger_commands.m4.md +++ b/hledger/hledger_commands.m4.md @@ -250,7 +250,7 @@ Normally balancesheet shows historical ending balances, which is what you need for a balance sheet; note this means it ignores report begin dates. -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ## balancesheetequity Just like [balancesheet](#balancesheet), but also reports Equity @@ -351,7 +351,7 @@ Normally cashflow shows changes in assets per period, though as with [multicolumn balance reports](#multicolumn-balance-reports) you can alter the report mode with `--change`/`--cumulative`/`--historical`. -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ## check-dates Check that transactions are sorted by increasing date. @@ -503,7 +503,7 @@ Normally incomestatement shows revenues/expenses per period, though as with [multicolumn balance reports](#multicolumn-balance-reports) you can alter the report mode with `--change`/`--cumulative`/`--historical`. -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ## prices Print all [market prices](/manual#market-prices) from the journal. @@ -585,7 +585,7 @@ This assumes that transactions added to FILE always have same or increasing date and that transactions on the same day do not get reordered. See also the [import](#import) command. -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. Here's an example of print's CSV output: ```shell $ hledger print -Ocsv @@ -740,7 +740,7 @@ $ hledger reg -w 100,40 # set overall width 100, description width 40 $ hledger reg -w $COLUMNS,40 # use terminal width, and set description width ``` -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ## register-match Print the one posting whose transaction description is closest to DESC, @@ -774,7 +774,7 @@ The stats command displays summary information for the whole journal, or a matched part of it. With a [reporting interval](#reporting-interval), it shows a report for each report period. -This command also supports [output destination](/manual.html#output-destination) and [output formats](/manual.html#output-formats). +This command also supports [output destination](/manual.html#output-destination) and [output format](/manual.html#output-format) selection. ## tags List all the tag names used in the journal. With a TAGREGEX argument,