;doc: regen manuals
[ci skip]
This commit is contained in:
		
							parent
							
								
									24996caaeb
								
							
						
					
					
						commit
						ce4de7aeb9
					
				| @ -1,6 +1,6 @@ | ||||
| .\"t | ||||
| 
 | ||||
| .TH "hledger_csv" "5" "June 2020" "hledger 1.18" "hledger User Manuals" | ||||
| .TH "hledger_csv" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -3,8 +3,8 @@ This is hledger_csv.info, produced by makeinfo version 6.7 from stdin. | ||||
|  | ||||
| File: hledger_csv.info,  Node: Top,  Next: EXAMPLES,  Up: (dir) | ||||
| 
 | ||||
| hledger_csv(5) hledger 1.18 | ||||
| *************************** | ||||
| hledger_csv(5) hledger 1.18.99 | ||||
| ****************************** | ||||
| 
 | ||||
| CSV - how hledger reads CSV data, and the CSV rules file format | ||||
| 
 | ||||
| @ -1036,74 +1036,74 @@ command the user specified. | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top72 | ||||
| Node: EXAMPLES2174 | ||||
| Ref: #examples2280 | ||||
| Node: Basic2488 | ||||
| Ref: #basic2588 | ||||
| Node: Bank of Ireland3130 | ||||
| Ref: #bank-of-ireland3265 | ||||
| Node: Amazon4727 | ||||
| Ref: #amazon4845 | ||||
| Node: Paypal6564 | ||||
| Ref: #paypal6658 | ||||
| Node: CSV RULES14302 | ||||
| Ref: #csv-rules14411 | ||||
| Node: skip14687 | ||||
| Ref: #skip14780 | ||||
| Node: fields15155 | ||||
| Ref: #fields15277 | ||||
| Node: Transaction field names16442 | ||||
| Ref: #transaction-field-names16602 | ||||
| Node: Posting field names16713 | ||||
| Ref: #posting-field-names16865 | ||||
| Node: account16935 | ||||
| Ref: #account17051 | ||||
| Node: amount17588 | ||||
| Ref: #amount17719 | ||||
| Node: currency18826 | ||||
| Ref: #currency18961 | ||||
| Node: balance19167 | ||||
| Ref: #balance19301 | ||||
| Node: comment19618 | ||||
| Ref: #comment19735 | ||||
| Node: field assignment19898 | ||||
| Ref: #field-assignment20041 | ||||
| Node: separator20859 | ||||
| Ref: #separator20988 | ||||
| Node: if21399 | ||||
| Ref: #if21501 | ||||
| Node: end23657 | ||||
| Ref: #end23763 | ||||
| Node: date-format23987 | ||||
| Ref: #date-format24119 | ||||
| Node: newest-first24868 | ||||
| Ref: #newest-first25006 | ||||
| Node: include25689 | ||||
| Ref: #include25818 | ||||
| Node: balance-type26262 | ||||
| Ref: #balance-type26382 | ||||
| Node: TIPS27082 | ||||
| Ref: #tips27164 | ||||
| Node: Rapid feedback27420 | ||||
| Ref: #rapid-feedback27537 | ||||
| Node: Valid CSV27997 | ||||
| Ref: #valid-csv28127 | ||||
| Node: File Extension28319 | ||||
| Ref: #file-extension28471 | ||||
| Node: Reading multiple CSV files28881 | ||||
| Ref: #reading-multiple-csv-files29066 | ||||
| Node: Valid transactions29307 | ||||
| Ref: #valid-transactions29485 | ||||
| Node: Deduplicating importing30113 | ||||
| Ref: #deduplicating-importing30292 | ||||
| Node: Setting amounts31325 | ||||
| Ref: #setting-amounts31494 | ||||
| Node: Setting currency/commodity32481 | ||||
| Ref: #setting-currencycommodity32673 | ||||
| Node: Referencing other fields33476 | ||||
| Ref: #referencing-other-fields33676 | ||||
| Node: How CSV rules are evaluated34573 | ||||
| Ref: #how-csv-rules-are-evaluated34746 | ||||
| Node: EXAMPLES2180 | ||||
| Ref: #examples2286 | ||||
| Node: Basic2494 | ||||
| Ref: #basic2594 | ||||
| Node: Bank of Ireland3136 | ||||
| Ref: #bank-of-ireland3271 | ||||
| Node: Amazon4733 | ||||
| Ref: #amazon4851 | ||||
| Node: Paypal6570 | ||||
| Ref: #paypal6664 | ||||
| Node: CSV RULES14308 | ||||
| Ref: #csv-rules14417 | ||||
| Node: skip14693 | ||||
| Ref: #skip14786 | ||||
| Node: fields15161 | ||||
| Ref: #fields15283 | ||||
| Node: Transaction field names16448 | ||||
| Ref: #transaction-field-names16608 | ||||
| Node: Posting field names16719 | ||||
| Ref: #posting-field-names16871 | ||||
| Node: account16941 | ||||
| Ref: #account17057 | ||||
| Node: amount17594 | ||||
| Ref: #amount17725 | ||||
| Node: currency18832 | ||||
| Ref: #currency18967 | ||||
| Node: balance19173 | ||||
| Ref: #balance19307 | ||||
| Node: comment19624 | ||||
| Ref: #comment19741 | ||||
| Node: field assignment19904 | ||||
| Ref: #field-assignment20047 | ||||
| Node: separator20865 | ||||
| Ref: #separator20994 | ||||
| Node: if21405 | ||||
| Ref: #if21507 | ||||
| Node: end23663 | ||||
| Ref: #end23769 | ||||
| Node: date-format23993 | ||||
| Ref: #date-format24125 | ||||
| Node: newest-first24874 | ||||
| Ref: #newest-first25012 | ||||
| Node: include25695 | ||||
| Ref: #include25824 | ||||
| Node: balance-type26268 | ||||
| Ref: #balance-type26388 | ||||
| Node: TIPS27088 | ||||
| Ref: #tips27170 | ||||
| Node: Rapid feedback27426 | ||||
| Ref: #rapid-feedback27543 | ||||
| Node: Valid CSV28003 | ||||
| Ref: #valid-csv28133 | ||||
| Node: File Extension28325 | ||||
| Ref: #file-extension28477 | ||||
| Node: Reading multiple CSV files28887 | ||||
| Ref: #reading-multiple-csv-files29072 | ||||
| Node: Valid transactions29313 | ||||
| Ref: #valid-transactions29491 | ||||
| Node: Deduplicating importing30119 | ||||
| Ref: #deduplicating-importing30298 | ||||
| Node: Setting amounts31331 | ||||
| Ref: #setting-amounts31500 | ||||
| Node: Setting currency/commodity32487 | ||||
| Ref: #setting-currencycommodity32679 | ||||
| Node: Referencing other fields33482 | ||||
| Ref: #referencing-other-fields33682 | ||||
| Node: How CSV rules are evaluated34579 | ||||
| Ref: #how-csv-rules-are-evaluated34752 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -852,4 +852,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger 1.18                       June 2020                    hledger_csv(5) | ||||
| hledger 1.18.99                    June 2020                    hledger_csv(5) | ||||
|  | ||||
| @ -1,6 +1,6 @@ | ||||
| .\"t | ||||
| 
 | ||||
| .TH "hledger_journal" "5" "June 2020" "hledger 1.18" "hledger User Manuals" | ||||
| .TH "hledger_journal" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| @ -1143,15 +1143,20 @@ files can be included (not CSV files, currently). | ||||
| If the file path does not begin with a slash, it is relative to the | ||||
| current file\[aq]s folder. | ||||
| .PP | ||||
| It may contain glob patterns to match multiple files, eg: | ||||
| A tilde means home directory, eg: \f[C]include \[ti]/main.journal\f[R]. | ||||
| .PP | ||||
| The path may contain glob patterns to match multiple files, eg: | ||||
| \f[C]include *.journal\f[R]. | ||||
| .PP | ||||
| Or a tilde, meaning home directory: | ||||
| \f[C]include \[ti]/main.journal\f[R]. | ||||
| There is limited support for recursive wildcards: \f[C]**/\f[R] (the | ||||
| slash is required) matches 0 or more subdirectories. | ||||
| It\[aq]s not super convenient since you have to avoid include cycles and | ||||
| including directories, but this can be done, eg: | ||||
| \f[C]include */**/*.journal\f[R]. | ||||
| .PP | ||||
| It may also be prefixed to force a specific file format, overriding the | ||||
| file extension (as described in hledger.1 -> Input files): | ||||
| \f[C]include timedot:\[ti]/notes/2020*.md\f[R]. | ||||
| The path may also be prefixed to force a specific file format, | ||||
| overriding the file extension (as described in hledger.1 -> Input | ||||
| files): \f[C]include timedot:\[ti]/notes/2020*.md\f[R]. | ||||
| .SS Default year | ||||
| .PP | ||||
| You can set a default year to be used for subsequent dates which | ||||
|  | ||||
| @ -4,8 +4,8 @@ stdin. | ||||
|  | ||||
| File: hledger_journal.info,  Node: Top,  Up: (dir) | ||||
| 
 | ||||
| hledger_journal(5) hledger 1.18 | ||||
| ******************************* | ||||
| hledger_journal(5) hledger 1.18.99 | ||||
| ********************************** | ||||
| 
 | ||||
| Journal - hledger's default file format, representing a General Journal | ||||
| 
 | ||||
| @ -1023,14 +1023,19 @@ timedot files can be included (not CSV files, currently). | ||||
|    If the file path does not begin with a slash, it is relative to the | ||||
| current file's folder. | ||||
| 
 | ||||
|    It may contain glob patterns to match multiple files, eg: 'include | ||||
| *.journal'. | ||||
|    A tilde means home directory, eg: 'include ~/main.journal'. | ||||
| 
 | ||||
|    Or a tilde, meaning home directory: 'include ~/main.journal'. | ||||
|    The path may contain glob patterns to match multiple files, eg: | ||||
| 'include *.journal'. | ||||
| 
 | ||||
|    It may also be prefixed to force a specific file format, overriding | ||||
| the file extension (as described in hledger.1 -> Input files): 'include | ||||
| timedot:~/notes/2020*.md'. | ||||
|    There is limited support for recursive wildcards: '**/' (the slash is | ||||
| required) matches 0 or more subdirectories.  It's not super convenient | ||||
| since you have to avoid include cycles and including directories, but | ||||
| this can be done, eg: 'include */**/*.journal'. | ||||
| 
 | ||||
|    The path may also be prefixed to force a specific file format, | ||||
| overriding the file extension (as described in hledger.1 -> Input | ||||
| files): 'include timedot:~/notes/2020*.md'. | ||||
| 
 | ||||
|  | ||||
| File: hledger_journal.info,  Node: Default year,  Next: Declaring commodities,  Prev: Including other files,  Up: Directives | ||||
| @ -1823,124 +1828,124 @@ will have these tags added: | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top76 | ||||
| Node: Transactions1869 | ||||
| Ref: #transactions1961 | ||||
| Node: Dates3245 | ||||
| Ref: #dates3344 | ||||
| Node: Simple dates3409 | ||||
| Ref: #simple-dates3535 | ||||
| Node: Secondary dates4044 | ||||
| Ref: #secondary-dates4198 | ||||
| Node: Posting dates5534 | ||||
| Ref: #posting-dates5663 | ||||
| Node: Status7035 | ||||
| Ref: #status7156 | ||||
| Node: Description8864 | ||||
| Ref: #description8998 | ||||
| Node: Payee and note9318 | ||||
| Ref: #payee-and-note9432 | ||||
| Node: Comments9767 | ||||
| Ref: #comments9893 | ||||
| Node: Tags11087 | ||||
| Ref: #tags11202 | ||||
| Node: Postings12595 | ||||
| Ref: #postings12723 | ||||
| Node: Virtual postings13749 | ||||
| Ref: #virtual-postings13866 | ||||
| Node: Account names15171 | ||||
| Ref: #account-names15312 | ||||
| Node: Amounts15799 | ||||
| Ref: #amounts15938 | ||||
| Node: Digit group marks17046 | ||||
| Ref: #digit-group-marks17194 | ||||
| Node: Amount display style18132 | ||||
| Ref: #amount-display-style18286 | ||||
| Node: Transaction prices19723 | ||||
| Ref: #transaction-prices19895 | ||||
| Node: Lot prices and lot dates22227 | ||||
| Ref: #lot-prices-and-lot-dates22424 | ||||
| Node: Balance assertions22912 | ||||
| Ref: #balance-assertions23098 | ||||
| Node: Assertions and ordering24131 | ||||
| Ref: #assertions-and-ordering24319 | ||||
| Node: Assertions and included files25019 | ||||
| Ref: #assertions-and-included-files25262 | ||||
| Node: Assertions and multiple -f options25595 | ||||
| Ref: #assertions-and-multiple--f-options25851 | ||||
| Node: Assertions and commodities25983 | ||||
| Ref: #assertions-and-commodities26215 | ||||
| Node: Assertions and prices27372 | ||||
| Ref: #assertions-and-prices27586 | ||||
| Node: Assertions and subaccounts28026 | ||||
| Ref: #assertions-and-subaccounts28255 | ||||
| Node: Assertions and virtual postings28579 | ||||
| Ref: #assertions-and-virtual-postings28821 | ||||
| Node: Assertions and precision28963 | ||||
| Ref: #assertions-and-precision29156 | ||||
| Node: Balance assignments29423 | ||||
| Ref: #balance-assignments29597 | ||||
| Node: Balance assignments and prices30761 | ||||
| Ref: #balance-assignments-and-prices30933 | ||||
| Node: Directives31157 | ||||
| Ref: #directives31316 | ||||
| Node: Directives and multiple files37007 | ||||
| Ref: #directives-and-multiple-files37190 | ||||
| Node: Comment blocks37854 | ||||
| Ref: #comment-blocks38037 | ||||
| Node: Including other files38213 | ||||
| Ref: #including-other-files38393 | ||||
| Node: Default year39044 | ||||
| Ref: #default-year39213 | ||||
| Node: Declaring commodities39620 | ||||
| Ref: #declaring-commodities39803 | ||||
| Node: Default commodity41609 | ||||
| Ref: #default-commodity41795 | ||||
| Node: Declaring market prices42684 | ||||
| Ref: #declaring-market-prices42879 | ||||
| Node: Declaring accounts43736 | ||||
| Ref: #declaring-accounts43922 | ||||
| Node: Account comments44847 | ||||
| Ref: #account-comments45010 | ||||
| Node: Account subdirectives45434 | ||||
| Ref: #account-subdirectives45629 | ||||
| Node: Account types45942 | ||||
| Ref: #account-types46126 | ||||
| Node: Account display order47765 | ||||
| Ref: #account-display-order47935 | ||||
| Node: Rewriting accounts49086 | ||||
| Ref: #rewriting-accounts49271 | ||||
| Node: Basic aliases50028 | ||||
| Ref: #basic-aliases50174 | ||||
| Node: Regex aliases50878 | ||||
| Ref: #regex-aliases51050 | ||||
| Node: Combining aliases51768 | ||||
| Ref: #combining-aliases51961 | ||||
| Node: Aliases and multiple files53237 | ||||
| Ref: #aliases-and-multiple-files53446 | ||||
| Node: end aliases54025 | ||||
| Ref: #end-aliases54182 | ||||
| Node: Default parent account54283 | ||||
| Ref: #default-parent-account54451 | ||||
| Node: Periodic transactions55335 | ||||
| Ref: #periodic-transactions55510 | ||||
| Node: Periodic rule syntax57382 | ||||
| Ref: #periodic-rule-syntax57588 | ||||
| Node: Two spaces between period expression and description!58292 | ||||
| Ref: #two-spaces-between-period-expression-and-description58611 | ||||
| Node: Forecasting with periodic transactions59295 | ||||
| Ref: #forecasting-with-periodic-transactions59600 | ||||
| Node: Budgeting with periodic transactions61655 | ||||
| Ref: #budgeting-with-periodic-transactions61894 | ||||
| Node: Auto postings62343 | ||||
| Ref: #auto-postings62483 | ||||
| Node: Auto postings and multiple files64662 | ||||
| Ref: #auto-postings-and-multiple-files64866 | ||||
| Node: Auto postings and dates65075 | ||||
| Ref: #auto-postings-and-dates65349 | ||||
| Node: Auto postings and transaction balancing / inferred amounts / balance assertions65524 | ||||
| Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions65875 | ||||
| Node: Auto posting tags66217 | ||||
| Ref: #auto-posting-tags66432 | ||||
| Node: Transactions1875 | ||||
| Ref: #transactions1967 | ||||
| Node: Dates3251 | ||||
| Ref: #dates3350 | ||||
| Node: Simple dates3415 | ||||
| Ref: #simple-dates3541 | ||||
| Node: Secondary dates4050 | ||||
| Ref: #secondary-dates4204 | ||||
| Node: Posting dates5540 | ||||
| Ref: #posting-dates5669 | ||||
| Node: Status7041 | ||||
| Ref: #status7162 | ||||
| Node: Description8870 | ||||
| Ref: #description9004 | ||||
| Node: Payee and note9324 | ||||
| Ref: #payee-and-note9438 | ||||
| Node: Comments9773 | ||||
| Ref: #comments9899 | ||||
| Node: Tags11093 | ||||
| Ref: #tags11208 | ||||
| Node: Postings12601 | ||||
| Ref: #postings12729 | ||||
| Node: Virtual postings13755 | ||||
| Ref: #virtual-postings13872 | ||||
| Node: Account names15177 | ||||
| Ref: #account-names15318 | ||||
| Node: Amounts15805 | ||||
| Ref: #amounts15944 | ||||
| Node: Digit group marks17052 | ||||
| Ref: #digit-group-marks17200 | ||||
| Node: Amount display style18138 | ||||
| Ref: #amount-display-style18292 | ||||
| Node: Transaction prices19729 | ||||
| Ref: #transaction-prices19901 | ||||
| Node: Lot prices and lot dates22233 | ||||
| Ref: #lot-prices-and-lot-dates22430 | ||||
| Node: Balance assertions22918 | ||||
| Ref: #balance-assertions23104 | ||||
| Node: Assertions and ordering24137 | ||||
| Ref: #assertions-and-ordering24325 | ||||
| Node: Assertions and included files25025 | ||||
| Ref: #assertions-and-included-files25268 | ||||
| Node: Assertions and multiple -f options25601 | ||||
| Ref: #assertions-and-multiple--f-options25857 | ||||
| Node: Assertions and commodities25989 | ||||
| Ref: #assertions-and-commodities26221 | ||||
| Node: Assertions and prices27378 | ||||
| Ref: #assertions-and-prices27592 | ||||
| Node: Assertions and subaccounts28032 | ||||
| Ref: #assertions-and-subaccounts28261 | ||||
| Node: Assertions and virtual postings28585 | ||||
| Ref: #assertions-and-virtual-postings28827 | ||||
| Node: Assertions and precision28969 | ||||
| Ref: #assertions-and-precision29162 | ||||
| Node: Balance assignments29429 | ||||
| Ref: #balance-assignments29603 | ||||
| Node: Balance assignments and prices30767 | ||||
| Ref: #balance-assignments-and-prices30939 | ||||
| Node: Directives31163 | ||||
| Ref: #directives31322 | ||||
| Node: Directives and multiple files37013 | ||||
| Ref: #directives-and-multiple-files37196 | ||||
| Node: Comment blocks37860 | ||||
| Ref: #comment-blocks38043 | ||||
| Node: Including other files38219 | ||||
| Ref: #including-other-files38399 | ||||
| Node: Default year39323 | ||||
| Ref: #default-year39492 | ||||
| Node: Declaring commodities39899 | ||||
| Ref: #declaring-commodities40082 | ||||
| Node: Default commodity41888 | ||||
| Ref: #default-commodity42074 | ||||
| Node: Declaring market prices42963 | ||||
| Ref: #declaring-market-prices43158 | ||||
| Node: Declaring accounts44015 | ||||
| Ref: #declaring-accounts44201 | ||||
| Node: Account comments45126 | ||||
| Ref: #account-comments45289 | ||||
| Node: Account subdirectives45713 | ||||
| Ref: #account-subdirectives45908 | ||||
| Node: Account types46221 | ||||
| Ref: #account-types46405 | ||||
| Node: Account display order48044 | ||||
| Ref: #account-display-order48214 | ||||
| Node: Rewriting accounts49365 | ||||
| Ref: #rewriting-accounts49550 | ||||
| Node: Basic aliases50307 | ||||
| Ref: #basic-aliases50453 | ||||
| Node: Regex aliases51157 | ||||
| Ref: #regex-aliases51329 | ||||
| Node: Combining aliases52047 | ||||
| Ref: #combining-aliases52240 | ||||
| Node: Aliases and multiple files53516 | ||||
| Ref: #aliases-and-multiple-files53725 | ||||
| Node: end aliases54304 | ||||
| Ref: #end-aliases54461 | ||||
| Node: Default parent account54562 | ||||
| Ref: #default-parent-account54730 | ||||
| Node: Periodic transactions55614 | ||||
| Ref: #periodic-transactions55789 | ||||
| Node: Periodic rule syntax57661 | ||||
| Ref: #periodic-rule-syntax57867 | ||||
| Node: Two spaces between period expression and description!58571 | ||||
| Ref: #two-spaces-between-period-expression-and-description58890 | ||||
| Node: Forecasting with periodic transactions59574 | ||||
| Ref: #forecasting-with-periodic-transactions59879 | ||||
| Node: Budgeting with periodic transactions61934 | ||||
| Ref: #budgeting-with-periodic-transactions62173 | ||||
| Node: Auto postings62622 | ||||
| Ref: #auto-postings62762 | ||||
| Node: Auto postings and multiple files64941 | ||||
| Ref: #auto-postings-and-multiple-files65145 | ||||
| Node: Auto postings and dates65354 | ||||
| Ref: #auto-postings-and-dates65628 | ||||
| Node: Auto postings and transaction balancing / inferred amounts / balance assertions65803 | ||||
| Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions66154 | ||||
| Node: Auto posting tags66496 | ||||
| Ref: #auto-posting-tags66711 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -792,14 +792,19 @@ FILE FORMAT | ||||
|        If  the  file  path  does not begin with a slash, it is relative to the | ||||
|        current file's folder. | ||||
| 
 | ||||
|        It may contain glob patterns  to  match  multiple  files,  eg:  include | ||||
|        A tilde means home directory, eg: include ~/main.journal. | ||||
| 
 | ||||
|        The path may contain glob patterns to match multiple files, eg: include | ||||
|        *.journal. | ||||
| 
 | ||||
|        Or a tilde, meaning home directory: include ~/main.journal. | ||||
|        There is limited support for recursive wildcards: **/ (the slash is re- | ||||
|        quired) matches 0 or more subdirectories.  It's  not  super  convenient | ||||
|        since  you  have to avoid include cycles and including directories, but | ||||
|        this can be done, eg: include */**/*.journal. | ||||
| 
 | ||||
|        It may also be prefixed to force a specific file format, overriding the | ||||
|        file extension (as described in  hledger.1  ->  Input  files):  include | ||||
|        timedot:~/notes/2020*.md. | ||||
|        The path may also be prefixed to force a specific file format, overrid- | ||||
|        ing  the file extension (as described in hledger.1 -> Input files): in- | ||||
|        clude timedot:~/notes/2020*.md. | ||||
| 
 | ||||
|    Default year | ||||
|        You can set a default year to be used for subsequent dates which  don't | ||||
| @ -1480,4 +1485,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger 1.18                       June 2020                hledger_journal(5) | ||||
| hledger 1.18.99                    June 2020                hledger_journal(5) | ||||
|  | ||||
| @ -1,5 +1,5 @@ | ||||
| 
 | ||||
| .TH "hledger_timeclock" "5" "June 2020" "hledger 1.18" "hledger User Manuals" | ||||
| .TH "hledger_timeclock" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -4,8 +4,8 @@ stdin. | ||||
|  | ||||
| File: hledger_timeclock.info,  Node: Top,  Up: (dir) | ||||
| 
 | ||||
| hledger_timeclock(5) hledger 1.18 | ||||
| ********************************* | ||||
| hledger_timeclock(5) hledger 1.18.99 | ||||
| ************************************ | ||||
| 
 | ||||
| Timeclock - the time logging format of timeclock.el, as read by hledger | ||||
| 
 | ||||
|  | ||||
| @ -78,4 +78,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger 1.18                       June 2020              hledger_timeclock(5) | ||||
| hledger 1.18.99                    June 2020              hledger_timeclock(5) | ||||
|  | ||||
| @ -1,5 +1,5 @@ | ||||
| 
 | ||||
| .TH "hledger_timedot" "5" "June 2020" "hledger 1.18" "hledger User Manuals" | ||||
| .TH "hledger_timedot" "5" "June 2020" "hledger 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -4,8 +4,8 @@ stdin. | ||||
|  | ||||
| File: hledger_timedot.info,  Node: Top,  Up: (dir) | ||||
| 
 | ||||
| hledger_timedot(5) hledger 1.18 | ||||
| ******************************* | ||||
| hledger_timedot(5) hledger 1.18.99 | ||||
| ********************************** | ||||
| 
 | ||||
| Timedot - hledger's human-friendly time logging format | ||||
| 
 | ||||
|  | ||||
| @ -161,4 +161,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger 1.18                       June 2020                hledger_timedot(5) | ||||
| hledger 1.18.99                    June 2020                hledger_timedot(5) | ||||
|  | ||||
| @ -1,5 +1,5 @@ | ||||
| 
 | ||||
| .TH "hledger-ui" "1" "June 2020" "hledger-ui 1.18" "hledger User Manuals" | ||||
| .TH "hledger-ui" "1" "June 2020" "hledger-ui 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -3,8 +3,8 @@ This is hledger-ui.info, produced by makeinfo version 6.7 from stdin. | ||||
|  | ||||
| File: hledger-ui.info,  Node: Top,  Next: OPTIONS,  Up: (dir) | ||||
| 
 | ||||
| hledger-ui(1) hledger-ui 1.18 | ||||
| ***************************** | ||||
| hledger-ui(1) hledger-ui 1.18.99 | ||||
| ******************************** | ||||
| 
 | ||||
| hledger-ui - terminal interface for the hledger accounting tool | ||||
| 
 | ||||
| @ -508,26 +508,26 @@ program is restarted. | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top71 | ||||
| Node: OPTIONS1470 | ||||
| Ref: #options1567 | ||||
| Node: KEYS5182 | ||||
| Ref: #keys5277 | ||||
| Node: SCREENS9553 | ||||
| Ref: #screens9658 | ||||
| Node: Accounts screen9748 | ||||
| Ref: #accounts-screen9876 | ||||
| Node: Register screen12092 | ||||
| Ref: #register-screen12247 | ||||
| Node: Transaction screen14244 | ||||
| Ref: #transaction-screen14402 | ||||
| Node: Error screen15272 | ||||
| Ref: #error-screen15394 | ||||
| Node: ENVIRONMENT15638 | ||||
| Ref: #environment15752 | ||||
| Node: FILES16559 | ||||
| Ref: #files16658 | ||||
| Node: BUGS16871 | ||||
| Ref: #bugs16948 | ||||
| Node: OPTIONS1476 | ||||
| Ref: #options1573 | ||||
| Node: KEYS5188 | ||||
| Ref: #keys5283 | ||||
| Node: SCREENS9559 | ||||
| Ref: #screens9664 | ||||
| Node: Accounts screen9754 | ||||
| Ref: #accounts-screen9882 | ||||
| Node: Register screen12098 | ||||
| Ref: #register-screen12253 | ||||
| Node: Transaction screen14250 | ||||
| Ref: #transaction-screen14408 | ||||
| Node: Error screen15278 | ||||
| Ref: #error-screen15400 | ||||
| Node: ENVIRONMENT15644 | ||||
| Ref: #environment15758 | ||||
| Node: FILES16565 | ||||
| Ref: #files16664 | ||||
| Node: BUGS16877 | ||||
| Ref: #bugs16954 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -450,4 +450,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger-ui 1.18                    June 2020                     hledger-ui(1) | ||||
| hledger-ui 1.18.99                 June 2020                     hledger-ui(1) | ||||
|  | ||||
| @ -1,5 +1,5 @@ | ||||
| 
 | ||||
| .TH "hledger-web" "1" "June 2020" "hledger-web 1.18" "hledger User Manuals" | ||||
| .TH "hledger-web" "1" "June 2020" "hledger-web 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|  | ||||
| @ -3,8 +3,8 @@ This is hledger-web.info, produced by makeinfo version 6.7 from stdin. | ||||
|  | ||||
| File: hledger-web.info,  Node: Top,  Next: OPTIONS,  Up: (dir) | ||||
| 
 | ||||
| hledger-web(1) hledger-web 1.18 | ||||
| ******************************* | ||||
| hledger-web(1) hledger-web 1.18.99 | ||||
| ********************************** | ||||
| 
 | ||||
| hledger-web - web interface for the hledger accounting tool | ||||
| 
 | ||||
| @ -573,22 +573,22 @@ awkward. | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top72 | ||||
| Node: OPTIONS1746 | ||||
| Ref: #options1851 | ||||
| Node: PERMISSIONS8379 | ||||
| Ref: #permissions8518 | ||||
| Node: EDITING UPLOADING DOWNLOADING9730 | ||||
| Ref: #editing-uploading-downloading9911 | ||||
| Node: RELOADING10745 | ||||
| Ref: #reloading10879 | ||||
| Node: JSON API11312 | ||||
| Ref: #json-api11426 | ||||
| Node: ENVIRONMENT16907 | ||||
| Ref: #environment17023 | ||||
| Node: FILES17756 | ||||
| Ref: #files17856 | ||||
| Node: BUGS18069 | ||||
| Ref: #bugs18147 | ||||
| Node: OPTIONS1752 | ||||
| Ref: #options1857 | ||||
| Node: PERMISSIONS8385 | ||||
| Ref: #permissions8524 | ||||
| Node: EDITING UPLOADING DOWNLOADING9736 | ||||
| Ref: #editing-uploading-downloading9917 | ||||
| Node: RELOADING10751 | ||||
| Ref: #reloading10885 | ||||
| Node: JSON API11318 | ||||
| Ref: #json-api11432 | ||||
| Node: ENVIRONMENT16913 | ||||
| Ref: #environment17029 | ||||
| Node: FILES17762 | ||||
| Ref: #files17862 | ||||
| Node: BUGS18075 | ||||
| Ref: #bugs18153 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -538,4 +538,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger-web 1.18                   June 2020                    hledger-web(1) | ||||
| hledger-web 1.18.99                June 2020                    hledger-web(1) | ||||
|  | ||||
| @ -1,6 +1,6 @@ | ||||
| .\"t | ||||
| 
 | ||||
| .TH "hledger" "1" "June 2020" "hledger 1.18" "hledger User Manuals" | ||||
| .TH "hledger" "1" "June 2020" "hledger 1.18.99" "hledger User Manuals" | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| @ -1679,18 +1679,12 @@ $ hledger balance --pivot member acct:. | ||||
| .SS Valuation | ||||
| .PP | ||||
| Instead of reporting amounts in their original commodity, hledger can | ||||
| convert them to: | ||||
| .IP \[bu] 2 | ||||
| cost (or sale amount), using the conversion rate recorded as part of the | ||||
| transaction (transaction price). | ||||
| .IP \[bu] 2 | ||||
| value, using the market prices in effect on certain date(s). | ||||
| .PP | ||||
| We call this \[dq]valuation\[dq], and it is controlled in full by the | ||||
| \f[C]--value=VALUATIONTYPE[,COMMODITY]\f[R] option. | ||||
| But we also provide simpler, Ledger-compatible | ||||
| \f[C]-B\f[R]/\f[C]-V\f[R]/\f[C]-X\f[R] flags, and usually one of these | ||||
| is all you need: | ||||
| convert them to cost/sale amount (using the conversion rate recorded in | ||||
| the transaction), or to market value (using some market price on a | ||||
| certain date). | ||||
| This is controlled by the \f[C]--value=TYPE[,COMMODITY]\f[R] option, but | ||||
| we also provide the simpler \f[C]-B\f[R]/\f[C]-V\f[R]/\f[C]-X\f[R] | ||||
| flags, and usually one of those is all you need. | ||||
| .SS -B: Cost | ||||
| .PP | ||||
| The \f[C]-B/--cost\f[R] flag converts amounts to their cost or sale | ||||
| @ -1700,13 +1694,18 @@ amount at transaction time, if they have a transaction price specified. | ||||
| The \f[C]-V/--market\f[R] flag converts amounts to market value in their | ||||
| default \f[I]valuation commodity\f[R], using the market prices in effect | ||||
| on the \f[I]valuation date(s)\f[R], if any. | ||||
| More on these things in a minute. | ||||
| More on these in a minute. | ||||
| .SS -X: Value in specified commodity | ||||
| .PP | ||||
| The \f[C]-X/--exchange\f[R] option is like \f[C]-V\f[R] except the | ||||
| desired valuation currency is specified explicitly. | ||||
| The \f[C]-X/--exchange=COMM\f[R] option is like \f[C]-V\f[R], except you | ||||
| tell it which currency you want to convert to, and it tries to convert | ||||
| everything to that. | ||||
| .SS Valuation date | ||||
| .PP | ||||
| Since market prices can change from day to day, market value reports | ||||
| have a valuation date (or more than one), which determines which market | ||||
| prices will be used. | ||||
| .PP | ||||
| For single period reports, if an explicit report end date is specified, | ||||
| that will be used as the valuation date; otherwise the valuation date is | ||||
| \[dq]today\[dq]. | ||||
| @ -1751,11 +1750,10 @@ Adding the \f[C]--infer-value\f[R] flag to \f[C]-V\f[R], \f[C]-X\f[R] or | ||||
| So for example, \f[C]hledger bs -V --infer-value\f[R] will get market | ||||
| prices both from P directives and from transactions. | ||||
| .PP | ||||
| There is a downside to this: value reports can be affected in | ||||
| There is a downside: value reports can sometimes be affected in | ||||
| confusing/undesired ways by your journal entries. | ||||
| If this happens to you, read all of this Valuation section carefully, | ||||
| and try adding \f[C]--debug\f[R] or \f[C]--debug=2\f[R] to troubleshoot | ||||
| the reason. | ||||
| and try adding \f[C]--debug\f[R] or \f[C]--debug=2\f[R] to troubleshoot. | ||||
| .PP | ||||
| \f[C]--infer-value\f[R] can infer market prices from: | ||||
| .IP \[bu] 2 | ||||
| @ -1801,17 +1799,15 @@ If there are no P directives at all (any commodity or date) and the | ||||
| \f[C]--infer-value\f[R] flag is used: the price commodity from the | ||||
| latest transaction-inferred price for A on or before valuation date. | ||||
| .PP | ||||
| Amounts for which no valuation commodity can be found are not converted. | ||||
| .PP | ||||
| This means: | ||||
| .IP \[bu] 2 | ||||
| If you have any P directives, they alone determine which commodities | ||||
| \f[C]-V\f[R] will convert, and to what. | ||||
| If you have P directives, they determine which commodities \f[C]-V\f[R] | ||||
| will convert, and to what. | ||||
| .IP \[bu] 2 | ||||
| If you have no P directives, and you add the \f[C]--infer-value\f[R] | ||||
| flag, transaction prices determine what \f[C]-V\f[R] converts. | ||||
| .IP \[bu] 2 | ||||
| \f[C]-X\f[R] tries harder to convert everything to just one commodity. | ||||
| If you have no P directives, and use the \f[C]--infer-value\f[R] flag, | ||||
| transaction prices determine it. | ||||
| .PP | ||||
| Amounts for which no valuation commodity can be found are not converted. | ||||
| .SS Simple valuation examples | ||||
| .PP | ||||
| Here are some quick examples of \f[C]-V\f[R]: | ||||
|  | ||||
| @ -3,8 +3,8 @@ This is hledger.info, produced by makeinfo version 6.7 from stdin. | ||||
|  | ||||
| File: hledger.info,  Node: Top,  Next: COMMON TASKS,  Up: (dir) | ||||
| 
 | ||||
| hledger(1) hledger 1.18 | ||||
| *********************** | ||||
| hledger(1) hledger 1.18.99 | ||||
| ************************** | ||||
| 
 | ||||
| hledger - a command-line accounting tool | ||||
| 
 | ||||
| @ -1373,17 +1373,11 @@ File: hledger.info,  Node: Valuation,  Prev: Pivoting,  Up: OPTIONS | ||||
| ============== | ||||
| 
 | ||||
| Instead of reporting amounts in their original commodity, hledger can | ||||
| convert them to: | ||||
| 
 | ||||
|    * cost (or sale amount), using the conversion rate recorded as part | ||||
|      of the transaction (transaction price). | ||||
| 
 | ||||
|    * value, using the market prices in effect on certain date(s). | ||||
| 
 | ||||
|    We call this "valuation", and it is controlled in full by the | ||||
| '--value=VALUATIONTYPE[,COMMODITY]' option.  But we also provide | ||||
| simpler, Ledger-compatible '-B'/'-V'/'-X' flags, and usually one of | ||||
| these is all you need: | ||||
| convert them to cost/sale amount (using the conversion rate recorded in | ||||
| the transaction), or to market value (using some market price on a | ||||
| certain date).  This is controlled by the '--value=TYPE[,COMMODITY]' | ||||
| option, but we also provide the simpler '-B'/'-V'/'-X' flags, and | ||||
| usually one of those is all you need. | ||||
| 
 | ||||
| * Menu: | ||||
| 
 | ||||
| @ -1416,7 +1410,7 @@ File: hledger.info,  Node: -V Value,  Next: -X Value in specified commodity,  Pr | ||||
| 
 | ||||
| The '-V/--market' flag converts amounts to market value in their default | ||||
| _valuation commodity_, using the market prices in effect on the | ||||
| _valuation date(s)_, if any.  More on these things in a minute. | ||||
| _valuation date(s)_, if any.  More on these in a minute. | ||||
| 
 | ||||
|  | ||||
| File: hledger.info,  Node: -X Value in specified commodity,  Next: Valuation date,  Prev: -V Value,  Up: Valuation | ||||
| @ -1424,8 +1418,9 @@ File: hledger.info,  Node: -X Value in specified commodity,  Next: Valuation dat | ||||
| 2.17.3 -X: Value in specified commodity | ||||
| --------------------------------------- | ||||
| 
 | ||||
| The '-X/--exchange' option is like '-V' except the desired valuation | ||||
| currency is specified explicitly. | ||||
| The '-X/--exchange=COMM' option is like '-V', except you tell it which | ||||
| currency you want to convert to, and it tries to convert everything to | ||||
| that. | ||||
| 
 | ||||
|  | ||||
| File: hledger.info,  Node: Valuation date,  Next: Market prices,  Prev: -X Value in specified commodity,  Up: Valuation | ||||
| @ -1433,9 +1428,13 @@ File: hledger.info,  Node: Valuation date,  Next: Market prices,  Prev: -X Value | ||||
| 2.17.4 Valuation date | ||||
| --------------------- | ||||
| 
 | ||||
| For single period reports, if an explicit report end date is specified, | ||||
| that will be used as the valuation date; otherwise the valuation date is | ||||
| "today". | ||||
| Since market prices can change from day to day, market value reports | ||||
| have a valuation date (or more than one), which determines which market | ||||
| prices will be used. | ||||
| 
 | ||||
|    For single period reports, if an explicit report end date is | ||||
| specified, that will be used as the valuation date; otherwise the | ||||
| valuation date is "today". | ||||
| 
 | ||||
|    For multiperiod reports, each column/period is valued on the last day | ||||
| of the period. | ||||
| @ -1486,10 +1485,10 @@ needing P directives at all. | ||||
| this.  So for example, 'hledger bs -V --infer-value' will get market | ||||
| prices both from P directives and from transactions. | ||||
| 
 | ||||
|    There is a downside to this: value reports can be affected in | ||||
|    There is a downside: value reports can sometimes be affected in | ||||
| confusing/undesired ways by your journal entries.  If this happens to | ||||
| you, read all of this Valuation section carefully, and try adding | ||||
| '--debug' or '--debug=2' to troubleshoot the reason. | ||||
| '--debug' or '--debug=2' to troubleshoot. | ||||
| 
 | ||||
|    '--infer-value' can infer market prices from: | ||||
| 
 | ||||
| @ -1531,18 +1530,16 @@ follows, in this order of preference: | ||||
|      '--infer-value' flag is used: the price commodity from the latest | ||||
|      transaction-inferred price for A on or before valuation date. | ||||
| 
 | ||||
|    Amounts for which no valuation commodity can be found are not | ||||
| converted. | ||||
| 
 | ||||
|    This means: | ||||
| 
 | ||||
|    * If you have any P directives, they alone determine which | ||||
|      commodities '-V' will convert, and to what. | ||||
|    * If you have P directives, they determine which commodities '-V' | ||||
|      will convert, and to what. | ||||
| 
 | ||||
|    * If you have no P directives, and you add the '--infer-value' flag, | ||||
|      transaction prices determine what '-V' converts. | ||||
|    * If you have no P directives, and use the '--infer-value' flag, | ||||
|      transaction prices determine it. | ||||
| 
 | ||||
|    * '-X' tries harder to convert everything to just one commodity. | ||||
|    Amounts for which no valuation commodity can be found are not | ||||
| converted. | ||||
| 
 | ||||
|  | ||||
| File: hledger.info,  Node: Simple valuation examples,  Next: --value Flexible valuation,  Prev: Valuation commodity,  Up: Valuation | ||||
| @ -3861,197 +3858,197 @@ $ LANG=en_US.UTF-8 hledger -f my.journal print | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top68 | ||||
| Node: COMMON TASKS2315 | ||||
| Ref: #common-tasks2427 | ||||
| Node: Getting help2834 | ||||
| Ref: #getting-help2966 | ||||
| Node: Constructing command lines3519 | ||||
| Ref: #constructing-command-lines3711 | ||||
| Node: Starting a journal file4408 | ||||
| Ref: #starting-a-journal-file4606 | ||||
| Node: Setting opening balances5794 | ||||
| Ref: #setting-opening-balances5990 | ||||
| Node: Recording transactions9131 | ||||
| Ref: #recording-transactions9311 | ||||
| Node: Reconciling9867 | ||||
| Ref: #reconciling10010 | ||||
| Node: Reporting12267 | ||||
| Ref: #reporting12407 | ||||
| Node: Migrating to a new file16406 | ||||
| Ref: #migrating-to-a-new-file16554 | ||||
| Node: OPTIONS16853 | ||||
| Ref: #options16960 | ||||
| Node: General options17330 | ||||
| Ref: #general-options17455 | ||||
| Node: Command options20409 | ||||
| Ref: #command-options20560 | ||||
| Node: Command arguments20958 | ||||
| Ref: #command-arguments21105 | ||||
| Node: Queries21985 | ||||
| Ref: #queries22140 | ||||
| Node: Special characters in arguments and queries26102 | ||||
| Ref: #special-characters-in-arguments-and-queries26330 | ||||
| Node: More escaping26781 | ||||
| Ref: #more-escaping26943 | ||||
| Node: Even more escaping27239 | ||||
| Ref: #even-more-escaping27433 | ||||
| Node: Less escaping28104 | ||||
| Ref: #less-escaping28266 | ||||
| Node: Unicode characters28511 | ||||
| Ref: #unicode-characters28693 | ||||
| Node: Input files30105 | ||||
| Ref: #input-files30248 | ||||
| Node: Output destination32177 | ||||
| Ref: #output-destination32329 | ||||
| Node: Output format32754 | ||||
| Ref: #output-format32904 | ||||
| Node: Regular expressions34486 | ||||
| Ref: #regular-expressions34643 | ||||
| Node: Smart dates36379 | ||||
| Ref: #smart-dates36530 | ||||
| Node: Report start & end date37891 | ||||
| Ref: #report-start-end-date38063 | ||||
| Node: Report intervals39560 | ||||
| Ref: #report-intervals39725 | ||||
| Node: Period expressions40115 | ||||
| Ref: #period-expressions40275 | ||||
| Node: Depth limiting44411 | ||||
| Ref: #depth-limiting44555 | ||||
| Node: Pivoting44887 | ||||
| Ref: #pivoting45010 | ||||
| Node: Valuation46686 | ||||
| Ref: #valuation46788 | ||||
| Node: -B Cost47588 | ||||
| Ref: #b-cost47692 | ||||
| Node: -V Value47825 | ||||
| Ref: #v-value47971 | ||||
| Node: -X Value in specified commodity48173 | ||||
| Ref: #x-value-in-specified-commodity48372 | ||||
| Node: Valuation date48476 | ||||
| Ref: #valuation-date48644 | ||||
| Node: Market prices48888 | ||||
| Ref: #market-prices49068 | ||||
| Node: --infer-value market prices from transactions49845 | ||||
| Ref: #infer-value-market-prices-from-transactions50094 | ||||
| Node: Valuation commodity51385 | ||||
| Ref: #valuation-commodity51594 | ||||
| Node: Simple valuation examples52919 | ||||
| Ref: #simple-valuation-examples53121 | ||||
| Node: --value Flexible valuation53780 | ||||
| Ref: #value-flexible-valuation53988 | ||||
| Node: More valuation examples55935 | ||||
| Ref: #more-valuation-examples56144 | ||||
| Node: Effect of valuation on reports58149 | ||||
| Ref: #effect-of-valuation-on-reports58337 | ||||
| Node: COMMANDS63858 | ||||
| Ref: #commands63966 | ||||
| Node: accounts65050 | ||||
| Ref: #accounts65148 | ||||
| Node: activity65847 | ||||
| Ref: #activity65957 | ||||
| Node: add66340 | ||||
| Ref: #add66439 | ||||
| Node: balance69178 | ||||
| Ref: #balance69289 | ||||
| Node: Classic balance report70747 | ||||
| Ref: #classic-balance-report70920 | ||||
| Node: Customising the classic balance report72289 | ||||
| Ref: #customising-the-classic-balance-report72517 | ||||
| Node: Colour support74593 | ||||
| Ref: #colour-support74760 | ||||
| Node: Flat mode74933 | ||||
| Ref: #flat-mode75081 | ||||
| Node: Depth limited balance reports75494 | ||||
| Ref: #depth-limited-balance-reports75679 | ||||
| Node: Percentages76135 | ||||
| Ref: #percentages76301 | ||||
| Node: Multicolumn balance report77438 | ||||
| Ref: #multicolumn-balance-report77618 | ||||
| Node: Budget report82880 | ||||
| Ref: #budget-report83023 | ||||
| Node: Nested budgets88289 | ||||
| Ref: #nested-budgets88401 | ||||
| Ref: #output-format-191882 | ||||
| Node: balancesheet92079 | ||||
| Ref: #balancesheet92215 | ||||
| Node: balancesheetequity93681 | ||||
| Ref: #balancesheetequity93830 | ||||
| Node: cashflow94553 | ||||
| Ref: #cashflow94681 | ||||
| Node: check-dates95860 | ||||
| Ref: #check-dates95987 | ||||
| Node: check-dupes96266 | ||||
| Ref: #check-dupes96390 | ||||
| Node: close96683 | ||||
| Ref: #close96797 | ||||
| Node: close usage98319 | ||||
| Ref: #close-usage98412 | ||||
| Node: commodities101225 | ||||
| Ref: #commodities101352 | ||||
| Node: descriptions101434 | ||||
| Ref: #descriptions101562 | ||||
| Node: diff101743 | ||||
| Ref: #diff101849 | ||||
| Node: files102896 | ||||
| Ref: #files102996 | ||||
| Node: help103143 | ||||
| Ref: #help103243 | ||||
| Node: import104324 | ||||
| Ref: #import104438 | ||||
| Node: Importing balance assignments105331 | ||||
| Ref: #importing-balance-assignments105479 | ||||
| Node: incomestatement106128 | ||||
| Ref: #incomestatement106261 | ||||
| Node: notes107748 | ||||
| Ref: #notes107861 | ||||
| Node: payees107987 | ||||
| Ref: #payees108093 | ||||
| Node: prices108251 | ||||
| Ref: #prices108357 | ||||
| Node: print108698 | ||||
| Ref: #print108808 | ||||
| Node: print-unique113594 | ||||
| Ref: #print-unique113720 | ||||
| Node: register114005 | ||||
| Ref: #register114132 | ||||
| Node: Custom register output118304 | ||||
| Ref: #custom-register-output118433 | ||||
| Node: register-match119770 | ||||
| Ref: #register-match119904 | ||||
| Node: rewrite120255 | ||||
| Ref: #rewrite120370 | ||||
| Node: Re-write rules in a file122225 | ||||
| Ref: #re-write-rules-in-a-file122359 | ||||
| Node: Diff output format123569 | ||||
| Ref: #diff-output-format123738 | ||||
| Node: rewrite vs print --auto124830 | ||||
| Ref: #rewrite-vs.-print---auto125009 | ||||
| Node: roi125565 | ||||
| Ref: #roi125663 | ||||
| Node: stats126675 | ||||
| Ref: #stats126774 | ||||
| Node: tags127562 | ||||
| Ref: #tags127660 | ||||
| Node: test127954 | ||||
| Ref: #test128062 | ||||
| Node: Add-on commands128809 | ||||
| Ref: #add-on-commands128926 | ||||
| Node: ui130269 | ||||
| Ref: #ui130357 | ||||
| Node: web130411 | ||||
| Ref: #web130514 | ||||
| Node: iadd130630 | ||||
| Ref: #iadd130741 | ||||
| Node: interest130823 | ||||
| Ref: #interest130930 | ||||
| Node: ENVIRONMENT131170 | ||||
| Ref: #environment131282 | ||||
| Node: FILES132111 | ||||
| Ref: #files-1132214 | ||||
| Node: LIMITATIONS132427 | ||||
| Ref: #limitations132546 | ||||
| Node: TROUBLESHOOTING133288 | ||||
| Ref: #troubleshooting133401 | ||||
| Node: COMMON TASKS2321 | ||||
| Ref: #common-tasks2433 | ||||
| Node: Getting help2840 | ||||
| Ref: #getting-help2972 | ||||
| Node: Constructing command lines3525 | ||||
| Ref: #constructing-command-lines3717 | ||||
| Node: Starting a journal file4414 | ||||
| Ref: #starting-a-journal-file4612 | ||||
| Node: Setting opening balances5800 | ||||
| Ref: #setting-opening-balances5996 | ||||
| Node: Recording transactions9137 | ||||
| Ref: #recording-transactions9317 | ||||
| Node: Reconciling9873 | ||||
| Ref: #reconciling10016 | ||||
| Node: Reporting12273 | ||||
| Ref: #reporting12413 | ||||
| Node: Migrating to a new file16412 | ||||
| Ref: #migrating-to-a-new-file16560 | ||||
| Node: OPTIONS16859 | ||||
| Ref: #options16966 | ||||
| Node: General options17336 | ||||
| Ref: #general-options17461 | ||||
| Node: Command options20415 | ||||
| Ref: #command-options20566 | ||||
| Node: Command arguments20964 | ||||
| Ref: #command-arguments21111 | ||||
| Node: Queries21991 | ||||
| Ref: #queries22146 | ||||
| Node: Special characters in arguments and queries26108 | ||||
| Ref: #special-characters-in-arguments-and-queries26336 | ||||
| Node: More escaping26787 | ||||
| Ref: #more-escaping26949 | ||||
| Node: Even more escaping27245 | ||||
| Ref: #even-more-escaping27439 | ||||
| Node: Less escaping28110 | ||||
| Ref: #less-escaping28272 | ||||
| Node: Unicode characters28517 | ||||
| Ref: #unicode-characters28699 | ||||
| Node: Input files30111 | ||||
| Ref: #input-files30254 | ||||
| Node: Output destination32183 | ||||
| Ref: #output-destination32335 | ||||
| Node: Output format32760 | ||||
| Ref: #output-format32910 | ||||
| Node: Regular expressions34492 | ||||
| Ref: #regular-expressions34649 | ||||
| Node: Smart dates36385 | ||||
| Ref: #smart-dates36536 | ||||
| Node: Report start & end date37897 | ||||
| Ref: #report-start-end-date38069 | ||||
| Node: Report intervals39566 | ||||
| Ref: #report-intervals39731 | ||||
| Node: Period expressions40121 | ||||
| Ref: #period-expressions40281 | ||||
| Node: Depth limiting44417 | ||||
| Ref: #depth-limiting44561 | ||||
| Node: Pivoting44893 | ||||
| Ref: #pivoting45016 | ||||
| Node: Valuation46692 | ||||
| Ref: #valuation46794 | ||||
| Node: -B Cost47483 | ||||
| Ref: #b-cost47587 | ||||
| Node: -V Value47720 | ||||
| Ref: #v-value47866 | ||||
| Node: -X Value in specified commodity48061 | ||||
| Ref: #x-value-in-specified-commodity48260 | ||||
| Node: Valuation date48409 | ||||
| Ref: #valuation-date48577 | ||||
| Node: Market prices48987 | ||||
| Ref: #market-prices49167 | ||||
| Node: --infer-value market prices from transactions49944 | ||||
| Ref: #infer-value-market-prices-from-transactions50193 | ||||
| Node: Valuation commodity51475 | ||||
| Ref: #valuation-commodity51684 | ||||
| Node: Simple valuation examples52910 | ||||
| Ref: #simple-valuation-examples53112 | ||||
| Node: --value Flexible valuation53771 | ||||
| Ref: #value-flexible-valuation53979 | ||||
| Node: More valuation examples55926 | ||||
| Ref: #more-valuation-examples56135 | ||||
| Node: Effect of valuation on reports58140 | ||||
| Ref: #effect-of-valuation-on-reports58328 | ||||
| Node: COMMANDS63849 | ||||
| Ref: #commands63957 | ||||
| Node: accounts65041 | ||||
| Ref: #accounts65139 | ||||
| Node: activity65838 | ||||
| Ref: #activity65948 | ||||
| Node: add66331 | ||||
| Ref: #add66430 | ||||
| Node: balance69169 | ||||
| Ref: #balance69280 | ||||
| Node: Classic balance report70738 | ||||
| Ref: #classic-balance-report70911 | ||||
| Node: Customising the classic balance report72280 | ||||
| Ref: #customising-the-classic-balance-report72508 | ||||
| Node: Colour support74584 | ||||
| Ref: #colour-support74751 | ||||
| Node: Flat mode74924 | ||||
| Ref: #flat-mode75072 | ||||
| Node: Depth limited balance reports75485 | ||||
| Ref: #depth-limited-balance-reports75670 | ||||
| Node: Percentages76126 | ||||
| Ref: #percentages76292 | ||||
| Node: Multicolumn balance report77429 | ||||
| Ref: #multicolumn-balance-report77609 | ||||
| Node: Budget report82871 | ||||
| Ref: #budget-report83014 | ||||
| Node: Nested budgets88280 | ||||
| Ref: #nested-budgets88392 | ||||
| Ref: #output-format-191873 | ||||
| Node: balancesheet92070 | ||||
| Ref: #balancesheet92206 | ||||
| Node: balancesheetequity93672 | ||||
| Ref: #balancesheetequity93821 | ||||
| Node: cashflow94544 | ||||
| Ref: #cashflow94672 | ||||
| Node: check-dates95851 | ||||
| Ref: #check-dates95978 | ||||
| Node: check-dupes96257 | ||||
| Ref: #check-dupes96381 | ||||
| Node: close96674 | ||||
| Ref: #close96788 | ||||
| Node: close usage98310 | ||||
| Ref: #close-usage98403 | ||||
| Node: commodities101216 | ||||
| Ref: #commodities101343 | ||||
| Node: descriptions101425 | ||||
| Ref: #descriptions101553 | ||||
| Node: diff101734 | ||||
| Ref: #diff101840 | ||||
| Node: files102887 | ||||
| Ref: #files102987 | ||||
| Node: help103134 | ||||
| Ref: #help103234 | ||||
| Node: import104315 | ||||
| Ref: #import104429 | ||||
| Node: Importing balance assignments105322 | ||||
| Ref: #importing-balance-assignments105470 | ||||
| Node: incomestatement106119 | ||||
| Ref: #incomestatement106252 | ||||
| Node: notes107739 | ||||
| Ref: #notes107852 | ||||
| Node: payees107978 | ||||
| Ref: #payees108084 | ||||
| Node: prices108242 | ||||
| Ref: #prices108348 | ||||
| Node: print108689 | ||||
| Ref: #print108799 | ||||
| Node: print-unique113585 | ||||
| Ref: #print-unique113711 | ||||
| Node: register113996 | ||||
| Ref: #register114123 | ||||
| Node: Custom register output118295 | ||||
| Ref: #custom-register-output118424 | ||||
| Node: register-match119761 | ||||
| Ref: #register-match119895 | ||||
| Node: rewrite120246 | ||||
| Ref: #rewrite120361 | ||||
| Node: Re-write rules in a file122216 | ||||
| Ref: #re-write-rules-in-a-file122350 | ||||
| Node: Diff output format123560 | ||||
| Ref: #diff-output-format123729 | ||||
| Node: rewrite vs print --auto124821 | ||||
| Ref: #rewrite-vs.-print---auto125000 | ||||
| Node: roi125556 | ||||
| Ref: #roi125654 | ||||
| Node: stats126666 | ||||
| Ref: #stats126765 | ||||
| Node: tags127553 | ||||
| Ref: #tags127651 | ||||
| Node: test127945 | ||||
| Ref: #test128053 | ||||
| Node: Add-on commands128800 | ||||
| Ref: #add-on-commands128917 | ||||
| Node: ui130260 | ||||
| Ref: #ui130348 | ||||
| Node: web130402 | ||||
| Ref: #web130505 | ||||
| Node: iadd130621 | ||||
| Ref: #iadd130732 | ||||
| Node: interest130814 | ||||
| Ref: #interest130921 | ||||
| Node: ENVIRONMENT131161 | ||||
| Ref: #environment131273 | ||||
| Node: FILES132102 | ||||
| Ref: #files-1132205 | ||||
| Node: LIMITATIONS132418 | ||||
| Ref: #limitations132537 | ||||
| Node: TROUBLESHOOTING133279 | ||||
| Ref: #troubleshooting133392 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -1190,17 +1190,11 @@ OPTIONS | ||||
| 
 | ||||
|    Valuation | ||||
|        Instead of reporting amounts in their original commodity,  hledger  can | ||||
|        convert them to: | ||||
| 
 | ||||
|        o cost  (or sale amount), using the conversion rate recorded as part of | ||||
|          the transaction (transaction price). | ||||
| 
 | ||||
|        o value, using the market prices in effect on certain date(s). | ||||
| 
 | ||||
|        We call  this  "valuation",  and  it  is  controlled  in  full  by  the | ||||
|        --value=VALUATIONTYPE[,COMMODITY] option.  But we also provide simpler, | ||||
|        Ledger-compatible -B/-V/-X flags, and usually one of these is  all  you | ||||
|        need: | ||||
|        convert them to cost/sale amount (using the conversion rate recorded in | ||||
|        the transaction), or to market value (using some market price on a cer- | ||||
|        tain date).  This is controlled by the --value=TYPE[,COMMODITY] option, | ||||
|        but we also provide the simpler -B/-V/-X  flags,  and  usually  one  of | ||||
|        those is all you need. | ||||
| 
 | ||||
|    -B: Cost | ||||
|        The  -B/--cost  flag  converts  amounts to their cost or sale amount at | ||||
| @ -1209,13 +1203,18 @@ OPTIONS | ||||
|    -V: Value | ||||
|        The -V/--market flag converts amounts to market value in their  default | ||||
|        valuation commodity, using the market prices in effect on the valuation | ||||
|        date(s), if any.  More on these things in a minute. | ||||
|        date(s), if any.  More on these in a minute. | ||||
| 
 | ||||
|    -X: Value in specified commodity | ||||
|        The -X/--exchange option is like -V except the desired  valuation  cur- | ||||
|        rency is specified explicitly. | ||||
|        The -X/--exchange=COMM option is like -V, except you tell it which cur- | ||||
|        rency  you  want  to  convert to, and it tries to convert everything to | ||||
|        that. | ||||
| 
 | ||||
|    Valuation date | ||||
|        Since market prices can change from day to day,  market  value  reports | ||||
|        have a valuation date (or more than one), which determines which market | ||||
|        prices will be used. | ||||
| 
 | ||||
|        For single period reports, if an explicit report end date is specified, | ||||
|        that  will  be used as the valuation date; otherwise the valuation date | ||||
|        is "today". | ||||
| @ -1259,10 +1258,10 @@ OPTIONS | ||||
|        for example, hledger bs -V --infer-value will get  market  prices  both | ||||
|        from P directives and from transactions. | ||||
| 
 | ||||
|        There is a downside to this: value reports can be affected  in  confus- | ||||
|        There is a downside: value reports can sometimes be affected in confus- | ||||
|        ing/undesired ways by your journal entries.  If this  happens  to  you, | ||||
|        read all of this Valuation section carefully, and try adding --debug or | ||||
|        --debug=2 to troubleshoot the reason. | ||||
|        --debug=2 to troubleshoot. | ||||
| 
 | ||||
|        --infer-value can infer market prices from: | ||||
| 
 | ||||
| @ -1298,18 +1297,16 @@ OPTIONS | ||||
|           --infer-value flag is used: the  price  commodity  from  the  latest | ||||
|           transaction-inferred price for A on or before valuation date. | ||||
| 
 | ||||
|        Amounts for which no valuation commodity can  be  found  are  not  con- | ||||
|        verted. | ||||
| 
 | ||||
|        This means: | ||||
| 
 | ||||
|        o If  you have any P directives, they alone determine which commodities | ||||
|          -V will convert, and to what. | ||||
|        o If  you  have  P directives, they determine which commodities -V will | ||||
|          convert, and to what. | ||||
| 
 | ||||
|        o If you have no P directives, and  you  add  the  --infer-value  flag, | ||||
|          transaction prices determine what -V converts. | ||||
|        o If you have no P directives, and use the --infer-value flag, transac- | ||||
|          tion prices determine it. | ||||
| 
 | ||||
|        o -X tries harder to convert everything to just one commodity. | ||||
|        Amounts  for  which  no  valuation  commodity can be found are not con- | ||||
|        verted. | ||||
| 
 | ||||
|    Simple valuation examples | ||||
|        Here are some quick examples of -V: | ||||
| @ -1557,9 +1554,6 @@ OPTIONS | ||||
|        ages   (with   played  val-   played  val-                   played  val-   values | ||||
|        report   in-   ues            ues                            ues | ||||
|        terval) | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|        column   to-   sums of dis-   sums of dis-   not supported   sums of dis-   sums of  dis- | ||||
|        tals           played  val-   played  val-                   played  val-   played values | ||||
|                       ues            ues                            ues | ||||
| @ -3285,4 +3279,4 @@ SEE ALSO | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
| hledger 1.18                       June 2020                        hledger(1) | ||||
| hledger 1.18.99                    June 2020                        hledger(1) | ||||
|  | ||||
		Loading…
	
		Reference in New Issue
	
	Block a user