diff --git a/hledger/hledger.1 b/hledger/hledger.1 index 089475f40..2e0ed991d 100644 --- a/hledger/hledger.1 +++ b/hledger/hledger.1 @@ -5161,24 +5161,22 @@ help .PD 0 .P .PD -Show the hledger user manual in one of several formats, optionally -positioned at a given TOPIC (if possible). -.PP -TOPIC is any heading in the manual, or a heading prefix, case +Show the hledger user manual with info, man, or a pager if possible. +With a TOPIC argument, open it at that topic if possible. +TOPIC can be any heading in the manual, or a heading prefix, case insensitive. Eg: \f[C]commands\f[R], \f[C]print\f[R], \f[C]forecast\f[R], -\f[C]\[dq]auto postings\[dq]\f[R], \f[C]journal\f[R], \f[C]amount\f[R]. +\f[C]journal\f[R], \f[C]amount\f[R], \f[C]\[dq]auto postings\[dq]\f[R]. .PP -This command shows the user manual built in to this hledger version. -It can be useful if the correct version of the hledger manual, or the -usual viewing tools, are not installed on your system. +This command shows the hledger manual built in to your hledger version. +It can be useful when offline, or when you prefer the terminal to a web +browser, or when the appropriate hledger manual or viewing tools are not +installed on your system. .PP -By default it uses the best viewer it can find in $PATH, in this order: -\f[C]info\f[R], \f[C]man\f[R], $PAGER (unless a topic is specified), -\f[C]less\f[R], or stdout. -When run non-interactively, it always uses stdout. -Or you can select a particular viewer with the \f[C]-i\f[R] (info), -\f[C]-m\f[R] (man), or \f[C]-p\f[R] (pager) flags. +By default it chooses the best viewer found in $PATH, preferring info +since the hledger manual is large. +You can select a particular viewer with the \f[C]-i\f[R], \f[C]-m\f[R], +or \f[C]-p\f[R] flags. .PP Examples .IP diff --git a/hledger/hledger.info b/hledger/hledger.info index 77e3c9389..8dbae05f4 100644 --- a/hledger/hledger.info +++ b/hledger/hledger.info @@ -4261,22 +4261,19 @@ File: hledger.info, Node: help, Next: import, Prev: files, Up: COMMANDS ========== help -Show the hledger user manual in one of several formats, optionally -positioned at a given TOPIC (if possible). +Show the hledger user manual with info, man, or a pager if possible. +With a TOPIC argument, open it at that topic if possible. TOPIC can be +any heading in the manual, or a heading prefix, case insensitive. Eg: +'commands', 'print', 'forecast', 'journal', 'amount', '"auto postings"'. - TOPIC is any heading in the manual, or a heading prefix, case -insensitive. Eg: 'commands', 'print', 'forecast', '"auto postings"', -'journal', 'amount'. + This command shows the hledger manual built in to your hledger +version. It can be useful when offline, or when you prefer the terminal +to a web browser, or when the appropriate hledger manual or viewing +tools are not installed on your system. - This command shows the user manual built in to this hledger version. -It can be useful if the correct version of the hledger manual, or the -usual viewing tools, are not installed on your system. - - By default it uses the best viewer it can find in $PATH, in this -order: 'info', 'man', $PAGER (unless a topic is specified), 'less', or -stdout. When run non-interactively, it always uses stdout. Or you can -select a particular viewer with the '-i' (info), '-m' (man), or '-p' -(pager) flags. + By default it chooses the best viewer found in $PATH, preferring info +since the hledger manual is large. You can select a particular viewer +with the '-i', '-m', or '-p' flags. Examples @@ -9885,324 +9882,324 @@ Node: files154054 Ref: #files154156 Node: help154303 Ref: #help154405 -Node: import155393 -Ref: #import155509 -Node: Deduplication156602 -Ref: #deduplication156727 -Node: Import testing158621 -Ref: #import-testing158786 -Node: Importing balance assignments159274 -Ref: #importing-balance-assignments159480 -Node: Commodity display styles160129 -Ref: #commodity-display-styles160302 -Node: incomestatement160431 -Ref: #incomestatement160566 -Node: notes161898 -Ref: #notes162013 -Node: payees162381 -Ref: #payees162489 -Node: prices163015 -Ref: #prices163123 -Node: print163492 -Ref: #print163604 -Node: print-unique168972 -Ref: #print-unique169100 -Node: register169385 -Ref: #register169514 -Node: Custom register output174264 -Ref: #custom-register-output174395 -Node: register-match175732 -Ref: #register-match175868 -Node: rewrite176219 -Ref: #rewrite176336 -Node: Re-write rules in a file178242 -Ref: #re-write-rules-in-a-file178405 -Node: Diff output format179554 -Ref: #diff-output-format179737 -Node: rewrite vs print --auto180829 -Ref: #rewrite-vs.-print---auto180989 -Node: roi181545 -Ref: #roi181645 -Node: Spaces and special characters in --inv and --pnl183370 -Ref: #spaces-and-special-characters-in---inv-and---pnl183610 -Node: Semantics of --inv and --pnl184098 -Ref: #semantics-of---inv-and---pnl184337 -Node: IRR and TWR explained186187 -Ref: #irr-and-twr-explained186347 -Node: stats189433 -Ref: #stats189534 -Node: tags190914 -Ref: #tags191014 -Node: test192028 -Ref: #test192138 -Node: Add-on commands192885 -Ref: #add-on-commands193004 -Node: JOURNAL FORMAT194135 -Ref: #journal-format194263 -Node: Transactions196490 -Ref: #transactions196605 -Node: Dates197619 -Ref: #dates197735 -Node: Simple dates197800 -Ref: #simple-dates197920 -Node: Secondary dates198429 -Ref: #secondary-dates198577 -Node: Posting dates199913 -Ref: #posting-dates200036 -Node: Status201408 -Ref: #status201518 -Node: Code203226 -Ref: #code203338 -Node: Description203570 -Ref: #description203698 -Node: Payee and note204018 -Ref: #payee-and-note204126 -Node: Comments204461 -Ref: #comments204583 -Node: Tags205777 -Ref: #tags-1205888 -Node: Postings207343 -Ref: #postings207467 -Node: Virtual postings208493 -Ref: #virtual-postings208604 -Node: Account names209909 -Ref: #account-names210046 -Node: Amounts210534 -Ref: #amounts210671 -Node: Decimal marks digit group marks211656 -Ref: #decimal-marks-digit-group-marks211833 -Node: Commodity212854 -Ref: #commodity213043 -Node: Directives influencing number parsing and display213995 -Ref: #directives-influencing-number-parsing-and-display214256 -Node: Commodity display style214749 -Ref: #commodity-display-style214957 -Node: Rounding217152 -Ref: #rounding217272 -Node: Transaction prices217684 -Ref: #transaction-prices217850 -Node: Equity conversion postings220322 -Ref: #equity-conversion-postings220475 -Node: Lot prices lot dates222993 -Ref: #lot-prices-lot-dates223176 -Node: Balance assertions223664 -Ref: #balance-assertions223842 -Node: Assertions and ordering224915 -Ref: #assertions-and-ordering225106 -Node: Assertions and multiple included files225806 -Ref: #assertions-and-multiple-included-files226068 -Node: Assertions and multiple -f files226568 -Ref: #assertions-and-multiple--f-files226821 -Node: Assertions and commodities227218 -Ref: #assertions-and-commodities227442 -Node: Assertions and prices228622 -Ref: #assertions-and-prices228830 -Node: Assertions and subaccounts229270 -Ref: #assertions-and-subaccounts229493 -Node: Assertions and virtual postings229817 -Ref: #assertions-and-virtual-postings230057 -Node: Assertions and auto postings230189 -Ref: #assertions-and-auto-postings230421 -Node: Assertions and precision231066 -Ref: #assertions-and-precision231250 -Node: Balance assignments231517 -Ref: #balance-assignments231687 -Node: Balance assignments and prices232851 -Ref: #balance-assignments-and-prices233017 -Node: Directives233241 -Ref: #directives233404 -Node: Directives and multiple files237896 -Ref: #directives-and-multiple-files238092 -Node: Comment blocks238784 -Ref: #comment-blocks238961 -Node: Including other files239137 -Ref: #including-other-files239311 -Node: Default year240235 -Ref: #default-year240393 -Node: Declaring payees240800 -Ref: #declaring-payees240971 -Node: Declaring the decimal mark241217 -Ref: #declaring-the-decimal-mark241417 -Node: Declaring commodities241814 -Ref: #declaring-commodities242005 -Node: Commodity error checking244523 -Ref: #commodity-error-checking244673 -Node: Default commodity245188 -Ref: #default-commodity245368 -Node: Declaring market prices246484 -Ref: #declaring-market-prices246673 -Node: Declaring accounts247486 -Ref: #declaring-accounts247666 -Node: Account comments248830 -Ref: #account-comments248983 -Node: Account subdirectives249406 -Ref: #account-subdirectives249600 -Node: Account error checking249742 -Ref: #account-error-checking249943 -Node: Account display order251132 -Ref: #account-display-order251323 -Node: Account types252424 -Ref: #account-types252568 -Node: Rewriting accounts256243 -Ref: #rewriting-accounts256422 -Node: Basic aliases257462 -Ref: #basic-aliases257598 -Node: Regex aliases258342 -Ref: #regex-aliases258504 -Node: Combining aliases259394 -Ref: #combining-aliases259577 -Node: Aliases and multiple files260853 -Ref: #aliases-and-multiple-files261052 -Node: end aliases261631 -Ref: #end-aliases261825 -Node: Aliases can generate bad account names261974 -Ref: #aliases-can-generate-bad-account-names262217 -Node: Aliases and account types262802 -Ref: #aliases-and-account-types262999 -Node: Default parent account263695 -Ref: #default-parent-account263885 -Node: Periodic transactions264769 -Ref: #periodic-transactions264952 -Node: Periodic rule syntax266907 -Ref: #periodic-rule-syntax267087 -Node: Periodic rules and relative dates267546 -Ref: #periodic-rules-and-relative-dates267814 -Node: Two spaces between period expression and description!268325 -Ref: #two-spaces-between-period-expression-and-description268651 -Node: Forecasting with periodic transactions269335 -Ref: #forecasting-with-periodic-transactions269634 -Node: Budgeting with periodic transactions272405 -Ref: #budgeting-with-periodic-transactions272638 -Node: Auto postings273047 -Ref: #auto-postings273183 -Node: Auto postings and multiple files275362 -Ref: #auto-postings-and-multiple-files275560 -Node: Auto postings and dates275769 -Ref: #auto-postings-and-dates276037 -Node: Auto postings and transaction balancing / inferred amounts / balance assertions276212 -Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions276557 -Node: Auto posting tags277060 -Ref: #auto-posting-tags277269 -Node: CSV FORMAT277905 -Ref: #csv-format278033 -Node: Examples280663 -Ref: #examples280766 -Node: Basic280974 -Ref: #basic281076 -Node: Bank of Ireland281618 -Ref: #bank-of-ireland281755 -Node: Amazon283217 -Ref: #amazon283337 -Node: Paypal285056 -Ref: #paypal285152 -Node: CSV rules292796 -Ref: #csv-rules292914 -Node: skip293247 -Ref: #skip293347 -Node: fields list293722 -Ref: #fields-list293861 -Node: field assignment295427 -Ref: #field-assignment295579 -Node: Field names296614 -Ref: #field-names296754 -Node: date field297134 -Ref: #date-field297254 -Node: date2 field297302 -Ref: #date2-field297445 -Node: status field297501 -Ref: #status-field297646 -Node: code field297695 -Ref: #code-field297842 -Node: description field297887 -Ref: #description-field298049 -Node: comment field298108 -Ref: #comment-field298265 -Node: account field298576 -Ref: #account-field298728 -Node: amount field299303 -Ref: #amount-field299454 -Node: currency field300699 -Ref: #currency-field300854 -Node: balance field301111 -Ref: #balance-field301245 -Node: separator301617 -Ref: #separator301749 -Node: if block302289 -Ref: #if-block302416 -Node: Matching the whole record302817 -Ref: #matching-the-whole-record302994 -Node: Matching individual fields303797 -Ref: #matching-individual-fields304003 -Node: Combining matchers304227 -Ref: #combining-matchers304425 -Node: Rules applied on successful match304738 -Ref: #rules-applied-on-successful-match304931 -Node: if table305585 -Ref: #if-table305706 -Node: end307444 -Ref: #end307558 -Node: date-format307782 -Ref: #date-format307916 -Node: decimal-mark308912 -Ref: #decimal-mark309059 -Node: newest-first309398 -Ref: #newest-first309541 -Node: include310224 -Ref: #include310357 -Node: balance-type310801 -Ref: #balance-type310923 -Node: Tips311623 -Ref: #tips311714 -Node: Rapid feedback312013 -Ref: #rapid-feedback312132 -Node: Valid CSV312584 -Ref: #valid-csv312716 -Node: File Extension312908 -Ref: #file-extension313062 -Node: Reading multiple CSV files313491 -Ref: #reading-multiple-csv-files313678 -Node: Valid transactions313919 -Ref: #valid-transactions314099 -Node: Deduplicating importing314727 -Ref: #deduplicating-importing314908 -Node: Setting amounts315944 -Ref: #setting-amounts316101 -Node: Amount signs318545 -Ref: #amount-signs318699 -Node: Setting currency/commodity319386 -Ref: #setting-currencycommodity319574 -Node: Amount decimal places320748 -Ref: #amount-decimal-places320940 -Node: Referencing other fields321252 -Ref: #referencing-other-fields321451 -Node: How CSV rules are evaluated322348 -Ref: #how-csv-rules-are-evaluated322523 -Node: TIMECLOCK FORMAT323974 -Ref: #timeclock-format324114 -Node: TIMEDOT FORMAT326175 -Ref: #timedot-format326313 -Node: COMMON TASKS330875 -Ref: #common-tasks331004 -Node: Getting help331278 -Ref: #getting-help331412 -Node: Constructing command lines332164 -Ref: #constructing-command-lines332358 -Node: Starting a journal file333055 -Ref: #starting-a-journal-file333255 -Node: Setting opening balances334443 -Ref: #setting-opening-balances334641 -Node: Recording transactions337782 -Ref: #recording-transactions337964 -Node: Reconciling338520 -Ref: #reconciling338665 -Node: Reporting340922 -Ref: #reporting341064 -Node: Migrating to a new file345063 -Ref: #migrating-to-a-new-file345213 -Node: LIMITATIONS345512 -Ref: #limitations345640 -Node: TROUBLESHOOTING346409 -Ref: #troubleshooting346524 +Node: import155346 +Ref: #import155462 +Node: Deduplication156555 +Ref: #deduplication156680 +Node: Import testing158574 +Ref: #import-testing158739 +Node: Importing balance assignments159227 +Ref: #importing-balance-assignments159433 +Node: Commodity display styles160082 +Ref: #commodity-display-styles160255 +Node: incomestatement160384 +Ref: #incomestatement160519 +Node: notes161851 +Ref: #notes161966 +Node: payees162334 +Ref: #payees162442 +Node: prices162968 +Ref: #prices163076 +Node: print163445 +Ref: #print163557 +Node: print-unique168925 +Ref: #print-unique169053 +Node: register169338 +Ref: #register169467 +Node: Custom register output174217 +Ref: #custom-register-output174348 +Node: register-match175685 +Ref: #register-match175821 +Node: rewrite176172 +Ref: #rewrite176289 +Node: Re-write rules in a file178195 +Ref: #re-write-rules-in-a-file178358 +Node: Diff output format179507 +Ref: #diff-output-format179690 +Node: rewrite vs print --auto180782 +Ref: #rewrite-vs.-print---auto180942 +Node: roi181498 +Ref: #roi181598 +Node: Spaces and special characters in --inv and --pnl183323 +Ref: #spaces-and-special-characters-in---inv-and---pnl183563 +Node: Semantics of --inv and --pnl184051 +Ref: #semantics-of---inv-and---pnl184290 +Node: IRR and TWR explained186140 +Ref: #irr-and-twr-explained186300 +Node: stats189386 +Ref: #stats189487 +Node: tags190867 +Ref: #tags190967 +Node: test191981 +Ref: #test192091 +Node: Add-on commands192838 +Ref: #add-on-commands192957 +Node: JOURNAL FORMAT194088 +Ref: #journal-format194216 +Node: Transactions196443 +Ref: #transactions196558 +Node: Dates197572 +Ref: #dates197688 +Node: Simple dates197753 +Ref: #simple-dates197873 +Node: Secondary dates198382 +Ref: #secondary-dates198530 +Node: Posting dates199866 +Ref: #posting-dates199989 +Node: Status201361 +Ref: #status201471 +Node: Code203179 +Ref: #code203291 +Node: Description203523 +Ref: #description203651 +Node: Payee and note203971 +Ref: #payee-and-note204079 +Node: Comments204414 +Ref: #comments204536 +Node: Tags205730 +Ref: #tags-1205841 +Node: Postings207296 +Ref: #postings207420 +Node: Virtual postings208446 +Ref: #virtual-postings208557 +Node: Account names209862 +Ref: #account-names209999 +Node: Amounts210487 +Ref: #amounts210624 +Node: Decimal marks digit group marks211609 +Ref: #decimal-marks-digit-group-marks211786 +Node: Commodity212807 +Ref: #commodity212996 +Node: Directives influencing number parsing and display213948 +Ref: #directives-influencing-number-parsing-and-display214209 +Node: Commodity display style214702 +Ref: #commodity-display-style214910 +Node: Rounding217105 +Ref: #rounding217225 +Node: Transaction prices217637 +Ref: #transaction-prices217803 +Node: Equity conversion postings220275 +Ref: #equity-conversion-postings220428 +Node: Lot prices lot dates222946 +Ref: #lot-prices-lot-dates223129 +Node: Balance assertions223617 +Ref: #balance-assertions223795 +Node: Assertions and ordering224868 +Ref: #assertions-and-ordering225059 +Node: Assertions and multiple included files225759 +Ref: #assertions-and-multiple-included-files226021 +Node: Assertions and multiple -f files226521 +Ref: #assertions-and-multiple--f-files226774 +Node: Assertions and commodities227171 +Ref: #assertions-and-commodities227395 +Node: Assertions and prices228575 +Ref: #assertions-and-prices228783 +Node: Assertions and subaccounts229223 +Ref: #assertions-and-subaccounts229446 +Node: Assertions and virtual postings229770 +Ref: #assertions-and-virtual-postings230010 +Node: Assertions and auto postings230142 +Ref: #assertions-and-auto-postings230374 +Node: Assertions and precision231019 +Ref: #assertions-and-precision231203 +Node: Balance assignments231470 +Ref: #balance-assignments231640 +Node: Balance assignments and prices232804 +Ref: #balance-assignments-and-prices232970 +Node: Directives233194 +Ref: #directives233357 +Node: Directives and multiple files237849 +Ref: #directives-and-multiple-files238045 +Node: Comment blocks238737 +Ref: #comment-blocks238914 +Node: Including other files239090 +Ref: #including-other-files239264 +Node: Default year240188 +Ref: #default-year240346 +Node: Declaring payees240753 +Ref: #declaring-payees240924 +Node: Declaring the decimal mark241170 +Ref: #declaring-the-decimal-mark241370 +Node: Declaring commodities241767 +Ref: #declaring-commodities241958 +Node: Commodity error checking244476 +Ref: #commodity-error-checking244626 +Node: Default commodity245141 +Ref: #default-commodity245321 +Node: Declaring market prices246437 +Ref: #declaring-market-prices246626 +Node: Declaring accounts247439 +Ref: #declaring-accounts247619 +Node: Account comments248783 +Ref: #account-comments248936 +Node: Account subdirectives249359 +Ref: #account-subdirectives249553 +Node: Account error checking249695 +Ref: #account-error-checking249896 +Node: Account display order251085 +Ref: #account-display-order251276 +Node: Account types252377 +Ref: #account-types252521 +Node: Rewriting accounts256196 +Ref: #rewriting-accounts256375 +Node: Basic aliases257415 +Ref: #basic-aliases257551 +Node: Regex aliases258295 +Ref: #regex-aliases258457 +Node: Combining aliases259347 +Ref: #combining-aliases259530 +Node: Aliases and multiple files260806 +Ref: #aliases-and-multiple-files261005 +Node: end aliases261584 +Ref: #end-aliases261778 +Node: Aliases can generate bad account names261927 +Ref: #aliases-can-generate-bad-account-names262170 +Node: Aliases and account types262755 +Ref: #aliases-and-account-types262952 +Node: Default parent account263648 +Ref: #default-parent-account263838 +Node: Periodic transactions264722 +Ref: #periodic-transactions264905 +Node: Periodic rule syntax266860 +Ref: #periodic-rule-syntax267040 +Node: Periodic rules and relative dates267499 +Ref: #periodic-rules-and-relative-dates267767 +Node: Two spaces between period expression and description!268278 +Ref: #two-spaces-between-period-expression-and-description268604 +Node: Forecasting with periodic transactions269288 +Ref: #forecasting-with-periodic-transactions269587 +Node: Budgeting with periodic transactions272358 +Ref: #budgeting-with-periodic-transactions272591 +Node: Auto postings273000 +Ref: #auto-postings273136 +Node: Auto postings and multiple files275315 +Ref: #auto-postings-and-multiple-files275513 +Node: Auto postings and dates275722 +Ref: #auto-postings-and-dates275990 +Node: Auto postings and transaction balancing / inferred amounts / balance assertions276165 +Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions276510 +Node: Auto posting tags277013 +Ref: #auto-posting-tags277222 +Node: CSV FORMAT277858 +Ref: #csv-format277986 +Node: Examples280616 +Ref: #examples280719 +Node: Basic280927 +Ref: #basic281029 +Node: Bank of Ireland281571 +Ref: #bank-of-ireland281708 +Node: Amazon283170 +Ref: #amazon283290 +Node: Paypal285009 +Ref: #paypal285105 +Node: CSV rules292749 +Ref: #csv-rules292867 +Node: skip293200 +Ref: #skip293300 +Node: fields list293675 +Ref: #fields-list293814 +Node: field assignment295380 +Ref: #field-assignment295532 +Node: Field names296567 +Ref: #field-names296707 +Node: date field297087 +Ref: #date-field297207 +Node: date2 field297255 +Ref: #date2-field297398 +Node: status field297454 +Ref: #status-field297599 +Node: code field297648 +Ref: #code-field297795 +Node: description field297840 +Ref: #description-field298002 +Node: comment field298061 +Ref: #comment-field298218 +Node: account field298529 +Ref: #account-field298681 +Node: amount field299256 +Ref: #amount-field299407 +Node: currency field300652 +Ref: #currency-field300807 +Node: balance field301064 +Ref: #balance-field301198 +Node: separator301570 +Ref: #separator301702 +Node: if block302242 +Ref: #if-block302369 +Node: Matching the whole record302770 +Ref: #matching-the-whole-record302947 +Node: Matching individual fields303750 +Ref: #matching-individual-fields303956 +Node: Combining matchers304180 +Ref: #combining-matchers304378 +Node: Rules applied on successful match304691 +Ref: #rules-applied-on-successful-match304884 +Node: if table305538 +Ref: #if-table305659 +Node: end307397 +Ref: #end307511 +Node: date-format307735 +Ref: #date-format307869 +Node: decimal-mark308865 +Ref: #decimal-mark309012 +Node: newest-first309351 +Ref: #newest-first309494 +Node: include310177 +Ref: #include310310 +Node: balance-type310754 +Ref: #balance-type310876 +Node: Tips311576 +Ref: #tips311667 +Node: Rapid feedback311966 +Ref: #rapid-feedback312085 +Node: Valid CSV312537 +Ref: #valid-csv312669 +Node: File Extension312861 +Ref: #file-extension313015 +Node: Reading multiple CSV files313444 +Ref: #reading-multiple-csv-files313631 +Node: Valid transactions313872 +Ref: #valid-transactions314052 +Node: Deduplicating importing314680 +Ref: #deduplicating-importing314861 +Node: Setting amounts315897 +Ref: #setting-amounts316054 +Node: Amount signs318498 +Ref: #amount-signs318652 +Node: Setting currency/commodity319339 +Ref: #setting-currencycommodity319527 +Node: Amount decimal places320701 +Ref: #amount-decimal-places320893 +Node: Referencing other fields321205 +Ref: #referencing-other-fields321404 +Node: How CSV rules are evaluated322301 +Ref: #how-csv-rules-are-evaluated322476 +Node: TIMECLOCK FORMAT323927 +Ref: #timeclock-format324067 +Node: TIMEDOT FORMAT326128 +Ref: #timedot-format326266 +Node: COMMON TASKS330828 +Ref: #common-tasks330957 +Node: Getting help331231 +Ref: #getting-help331365 +Node: Constructing command lines332117 +Ref: #constructing-command-lines332311 +Node: Starting a journal file333008 +Ref: #starting-a-journal-file333208 +Node: Setting opening balances334396 +Ref: #setting-opening-balances334594 +Node: Recording transactions337735 +Ref: #recording-transactions337917 +Node: Reconciling338473 +Ref: #reconciling338618 +Node: Reporting340875 +Ref: #reporting341017 +Node: Migrating to a new file345016 +Ref: #migrating-to-a-new-file345166 +Node: LIMITATIONS345465 +Ref: #limitations345593 +Node: TROUBLESHOOTING346362 +Ref: #troubleshooting346477  End Tag Table diff --git a/hledger/hledger.txt b/hledger/hledger.txt index a01b14e6d..ccbb8385c 100644 --- a/hledger/hledger.txt +++ b/hledger/hledger.txt @@ -3633,20 +3633,19 @@ COMMANDS help help - Show the hledger user manual in one of several formats, optionally - positioned at a given TOPIC (if possible). + Show the hledger user manual with info, man, or a pager if possible. + With a TOPIC argument, open it at that topic if possible. TOPIC can be + any heading in the manual, or a heading prefix, case insensitive. Eg: + commands, print, forecast, journal, amount, "auto postings". - TOPIC is any heading in the manual, or a heading prefix, case insensi- - tive. Eg: commands, print, forecast, "auto postings", journal, amount. + This command shows the hledger manual built in to your hledger version. + It can be useful when offline, or when you prefer the terminal to a web + browser, or when the appropriate hledger manual or viewing tools are + not installed on your system. - This command shows the user manual built in to this hledger version. - It can be useful if the correct version of the hledger manual, or the - usual viewing tools, are not installed on your system. - - By default it uses the best viewer it can find in $PATH, in this order: - info, man, $PAGER (unless a topic is specified), less, or stdout. When - run non-interactively, it always uses stdout. Or you can select a par- - ticular viewer with the -i (info), -m (man), or -p (pager) flags. + By default it chooses the best viewer found in $PATH, preferring info + since the hledger manual is large. You can select a particular viewer + with the -i, -m, or -p flags. Examples @@ -5380,6 +5379,7 @@ JOURNAL FORMAT Generate extra transactions or ~ budget goals Generate extra postings = + CHECKING FOR ERRORS: Define valid entities to allow account, commodity, stricter error checking payee @@ -5402,9 +5402,6 @@ JOURNAL FORMAT any text, ignored. alias Rewrites account names, in following entries until end of Y current file or end aliases. - - - apply Prepends a common parent account to all account names, in Y account following entries until end of current file or end apply account. @@ -6388,8 +6385,6 @@ CSV FORMAT below, after the examples: - - skip skip one or more header lines or matched CSV records fields list name CSV fields, assign them to hledger