diff --git a/hledger/hledger.1 b/hledger/hledger.1 index 40551e07e..47d5b5064 100644 --- a/hledger/hledger.1 +++ b/hledger/hledger.1 @@ -1984,6 +1984,11 @@ making it \f[V]\[Eu]100 \[at]\[at] $135\f[R], as in example 2: Amounts can be converted to cost at report time using the \f[V]-B/--cost\f[R] flag; this is discussed more in the \[u02DC]COST REPORTING section. +.PP +Note that the cost normally should be a positive amount, though it\[aq]s +not required to be. +This can be a little confusing, see discussion at --infer-market-prices: +market prices from transactions. .SS Other cost/lot notations .PP A slight digression for Ledger and Beancount users. diff --git a/hledger/hledger.info b/hledger/hledger.info index e1ae2533c..827ea862d 100644 --- a/hledger/hledger.info +++ b/hledger/hledger.info @@ -1777,6 +1777,10 @@ implicitly: Amounts can be converted to cost at report time using the ‘-B/--cost’ flag; this is discussed more in the ˜COST REPORTING section. + Note that the cost normally should be a positive amount, though it’s +not required to be. This can be a little confusing, see discussion at +–infer-market-prices: market prices from transactions. + * Menu: * Other cost/lot notations:: @@ -10503,502 +10507,502 @@ Node: Rounding59689 Ref: #rounding59809 Node: Costs60110 Ref: #costs60228 -Node: Other cost/lot notations62259 -Ref: #other-costlot-notations62393 -Node: Balance assertions65146 -Ref: #balance-assertions65299 -Node: Assertions and ordering66392 -Ref: #assertions-and-ordering66583 -Node: Assertions and multiple included files67285 -Ref: #assertions-and-multiple-included-files67547 -Node: Assertions and multiple -f files68055 -Ref: #assertions-and-multiple--f-files68308 -Node: Assertions and commodities68717 -Ref: #assertions-and-commodities68941 -Node: Assertions and prices70131 -Ref: #assertions-and-prices70339 -Node: Assertions and subaccounts70770 -Ref: #assertions-and-subaccounts70993 -Node: Assertions and virtual postings71335 -Ref: #assertions-and-virtual-postings71575 -Node: Assertions and auto postings71715 -Ref: #assertions-and-auto-postings71947 -Node: Assertions and precision72618 -Ref: #assertions-and-precision72802 -Node: Posting comments73069 -Ref: #posting-comments73217 -Node: Tags73602 -Ref: #tags73718 -Node: Tag values74923 -Ref: #tag-values75014 -Node: Directives75787 -Ref: #directives75916 -Node: Directive effects77784 -Ref: #directive-effects77940 -Node: Directives and multiple files81023 -Ref: #directives-and-multiple-files81203 -Node: account directive81913 -Ref: #account-directive82075 -Node: Account comments83495 -Ref: #account-comments83647 -Node: Account subdirectives84167 -Ref: #account-subdirectives84360 -Node: Account error checking84502 -Ref: #account-error-checking84702 -Node: Account display order85921 -Ref: #account-display-order86111 -Node: Account types87250 -Ref: #account-types87393 -Node: alias directive91128 -Ref: #alias-directive91295 -Node: Basic aliases92355 -Ref: #basic-aliases92488 -Node: Regex aliases93242 -Ref: #regex-aliases93401 -Node: Combining aliases94295 -Ref: #combining-aliases94475 -Node: Aliases and multiple files95769 -Ref: #aliases-and-multiple-files95975 -Node: end aliases directive96560 -Ref: #end-aliases-directive96785 -Node: Aliases can generate bad account names96934 -Ref: #aliases-can-generate-bad-account-names97184 -Node: Aliases and account types97781 -Ref: #aliases-and-account-types97975 -Node: commodity directive98677 -Ref: #commodity-directive98857 -Node: Commodity error checking101461 -Ref: #commodity-error-checking101609 -Node: decimal-mark directive102138 -Ref: #decimal-mark-directive102326 -Node: include directive102727 -Ref: #include-directive102897 -Node: P directive103845 -Ref: #p-directive103996 -Node: payee directive104895 -Ref: #payee-directive105050 -Node: tag directive105370 -Ref: #tag-directive105531 -Node: Periodic transactions106003 -Ref: #periodic-transactions106169 -Node: Periodic rule syntax107907 -Ref: #periodic-rule-syntax108087 -Node: Periodic rules and relative dates108742 -Ref: #periodic-rules-and-relative-dates109010 -Node: Two spaces between period expression and description!109549 -Ref: #two-spaces-between-period-expression-and-description109828 -Node: Other syntax110518 -Ref: #other-syntax110644 -Node: Auto postings111289 -Ref: #auto-postings111425 -Node: Auto postings and multiple files113936 -Ref: #auto-postings-and-multiple-files114138 -Node: Auto postings and dates114355 -Ref: #auto-postings-and-dates114627 -Node: Auto postings and transaction balancing / inferred amounts / balance assertions114802 -Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions115141 -Node: Auto posting tags115648 -Ref: #auto-posting-tags115861 -Node: Balance assignments116523 -Ref: #balance-assignments116703 -Node: Balance assignments and prices118037 -Ref: #balance-assignments-and-prices118207 -Node: Bracketed posting dates118418 -Ref: #bracketed-posting-dates118604 -Node: D directive119148 -Ref: #d-directive119322 -Node: apply account directive120990 -Ref: #apply-account-directive121176 -Node: Y directive121875 -Ref: #y-directive122041 -Node: Secondary dates122885 -Ref: #secondary-dates123041 -Node: Star comments123873 -Ref: #star-comments124035 -Node: Valuation expressions124575 -Ref: #valuation-expressions124754 -Node: Virtual postings124876 -Ref: #virtual-postings125057 -Node: Other Ledger directives126629 -Ref: #other-ledger-directives126794 -Node: CSV127364 -Ref: #csv127457 -Node: CSV rules cheatsheet129560 -Ref: #csv-rules-cheatsheet129692 -Node: separator131460 -Ref: #separator131591 -Node: skip132169 -Ref: #skip132281 -Node: date-format132864 -Ref: #date-format132989 -Node: timezone133735 -Ref: #timezone133862 -Node: newest-first134895 -Ref: #newest-first135037 -Node: intra-day-reversed135621 -Ref: #intra-day-reversed135779 -Node: decimal-mark136276 -Ref: #decimal-mark136421 -Node: fields list136760 -Ref: #fields-list136901 -Node: Field assignment138624 -Ref: #field-assignment138768 -Node: Field names139817 -Ref: #field-names139948 -Node: date field141169 -Ref: #date-field141287 -Node: date2 field141339 -Ref: #date2-field141480 -Node: status field141542 -Ref: #status-field141685 -Node: code field141740 -Ref: #code-field141885 -Node: description field141936 -Ref: #description-field142096 -Node: comment field142161 -Ref: #comment-field142316 -Node: account field142629 -Ref: #account-field142779 -Node: amount field143375 -Ref: #amount-field143524 -Node: currency field145629 -Ref: #currency-field145782 -Node: balance field146051 -Ref: #balance-field146183 -Node: if block146571 -Ref: #if-block146696 -Node: Matchers148120 -Ref: #matchers148234 -Node: if table149764 -Ref: #if-table149890 -Node: balance-type151326 -Ref: #balance-type151459 -Node: include152167 -Ref: #include152298 -Node: Working with CSV152748 -Ref: #working-with-csv152895 -Node: Rapid feedback153266 -Ref: #rapid-feedback153399 -Node: Valid CSV153855 -Ref: #valid-csv154001 -Node: File Extension154755 -Ref: #file-extension154928 -Node: Reading CSV from standard input155518 -Ref: #reading-csv-from-standard-input155742 -Node: Reading multiple CSV files155908 -Ref: #reading-multiple-csv-files156126 -Node: Valid transactions156375 -Ref: #valid-transactions156569 -Node: Deduplicating importing157197 -Ref: #deduplicating-importing157392 -Node: Setting amounts158438 -Ref: #setting-amounts158609 -Node: Amount signs161132 -Ref: #amount-signs161300 -Node: Setting currency/commodity162039 -Ref: #setting-currencycommodity162243 -Node: Amount decimal places163435 -Ref: #amount-decimal-places163641 -Node: Referencing other fields163959 -Ref: #referencing-other-fields164172 -Node: How CSV rules are evaluated165075 -Ref: #how-csv-rules-are-evaluated165292 -Node: Well factored rules166805 -Ref: #well-factored-rules166973 -Node: CSV rules examples167311 -Ref: #csv-rules-examples167446 -Node: Bank of Ireland167511 -Ref: #bank-of-ireland167648 -Node: Coinbase169116 -Ref: #coinbase169254 -Node: Amazon170307 -Ref: #amazon170432 -Node: Paypal172157 -Ref: #paypal172265 -Node: Timeclock179911 -Ref: #timeclock180016 -Node: Timedot182184 -Ref: #timedot182307 -Node: PART 3 REPORTING CONCEPTS187158 -Ref: #part-3-reporting-concepts187322 -Node: Time periods187322 -Ref: #time-periods187456 -Node: Report start & end date187574 -Ref: #report-start-end-date187726 -Node: Smart dates189459 -Ref: #smart-dates189612 -Node: Report intervals191572 -Ref: #report-intervals191727 -Node: Date adjustment192179 -Ref: #date-adjustment192339 -Node: Period expressions193671 -Ref: #period-expressions193812 -Node: Period expressions with a report interval195648 -Ref: #period-expressions-with-a-report-interval195882 -Node: More complex report intervals196112 -Ref: #more-complex-report-intervals196357 -Node: Multiple weekday intervals198286 -Ref: #multiple-weekday-intervals198475 -Node: Depth199339 -Ref: #depth199441 -Node: Queries199761 -Ref: #queries199863 -Node: Query types200808 -Ref: #query-types200929 -Node: Combining query terms204269 -Ref: #combining-query-terms204446 -Node: Queries and command options205784 -Ref: #queries-and-command-options205983 -Node: Queries and valuation206248 -Ref: #queries-and-valuation206443 -Node: Querying with account aliases206682 -Ref: #querying-with-account-aliases206893 -Node: Querying with cost or value207035 -Ref: #querying-with-cost-or-value207212 -Node: Pivoting207521 -Ref: #pivoting207635 -Node: Generating data209123 -Ref: #generating-data209255 -Node: Forecasting209753 -Ref: #forecasting209878 -Node: Budgeting212765 -Ref: #budgeting212885 -Node: Cost reporting213156 -Ref: #cost-reporting213284 -Node: -B Convert to cost214399 -Ref: #b-convert-to-cost214555 -Node: Equity conversion postings215963 -Ref: #equity-conversion-postings216177 -Node: Inferring equity postings from cost217072 -Ref: #inferring-equity-postings-from-cost217321 -Node: Inferring cost from equity postings218140 -Ref: #inferring-cost-from-equity-postings218388 -Node: When to infer cost/equity220197 -Ref: #when-to-infer-costequity220415 -Node: How to record conversions220823 -Ref: #how-to-record-conversions221015 -Node: Conversion with implicit cost221306 -Ref: #conversion-with-implicit-cost221511 -Node: Conversion with explicit cost222416 -Ref: #conversion-with-explicit-cost222661 -Node: Conversion with equity postings223088 -Ref: #conversion-with-equity-postings223357 -Node: Conversion with equity postings and explicit cost224194 -Ref: #conversion-with-equity-postings-and-explicit-cost224461 -Node: Cost tips224935 -Ref: #cost-tips225061 -Node: Valuation225797 -Ref: #valuation225921 -Node: -V Value226707 -Ref: #v-value226833 -Node: -X Value in specified commodity227032 -Ref: #x-value-in-specified-commodity227227 -Node: Valuation date227384 -Ref: #valuation-date227555 -Node: Finding market price227994 -Ref: #finding-market-price228199 -Node: --infer-market-prices market prices from transactions229379 -Ref: #infer-market-prices-market-prices-from-transactions229657 -Node: Valuation commodity232503 -Ref: #valuation-commodity232716 -Node: Simple valuation examples233961 -Ref: #simple-valuation-examples234159 -Node: --value Flexible valuation234822 -Ref: #value-flexible-valuation235028 -Node: More valuation examples236714 -Ref: #more-valuation-examples236923 -Node: Interaction of valuation and queries238934 -Ref: #interaction-of-valuation-and-queries239175 -Node: Effect of valuation on reports239655 -Ref: #effect-of-valuation-on-reports239852 -Node: PART 4 COMMANDS247611 -Ref: #part-4-commands247754 -Node: Commands overview248133 -Ref: #commands-overview248267 -Node: DATA ENTRY248446 -Ref: #data-entry248570 -Node: DATA CREATION248773 -Ref: #data-creation248927 -Node: DATA MANAGEMENT249051 -Ref: #data-management249216 -Node: REPORTS FINANCIAL249341 -Ref: #reports-financial249516 -Node: REPORTS VERSATILE249831 -Ref: #reports-versatile250004 -Node: REPORTS BASIC250265 -Ref: #reports-basic250417 -Node: HELP250950 -Ref: #help251072 -Node: ADD-ONS251186 -Ref: #add-ons251292 -Node: accounts251889 -Ref: #accounts252022 -Node: activity253997 -Ref: #activity254116 -Node: add254490 -Ref: #add254600 -Node: aregister257461 -Ref: #aregister257582 -Node: aregister and custom posting dates260558 -Ref: #aregister-and-custom-posting-dates260724 -Node: balance261292 -Ref: #balance261418 -Node: balance features262423 -Ref: #balance-features262563 -Node: Simple balance report264693 -Ref: #simple-balance-report264878 -Node: Balance report line format266523 -Ref: #balance-report-line-format266725 -Node: Filtered balance report268975 -Ref: #filtered-balance-report269167 -Node: List or tree mode269494 -Ref: #list-or-tree-mode269662 -Node: Depth limiting271037 -Ref: #depth-limiting271203 -Node: Dropping top-level accounts271820 -Ref: #dropping-top-level-accounts272020 -Node: Showing declared accounts272334 -Ref: #showing-declared-accounts272533 -Node: Sorting by amount273074 -Ref: #sorting-by-amount273241 -Node: Percentages273931 -Ref: #percentages274090 -Node: Multi-period balance report274660 -Ref: #multi-period-balance-report274860 -Node: Balance change end balance277253 -Ref: #balance-change-end-balance277462 -Node: Balance report types278910 -Ref: #balance-report-types279091 -Node: Calculation type279607 -Ref: #calculation-type279762 -Node: Accumulation type280293 -Ref: #accumulation-type280473 -Node: Valuation type281401 -Ref: #valuation-type281589 -Node: Combining balance report types282656 -Ref: #combining-balance-report-types282850 -Node: Budget report284754 -Ref: #budget-report284906 -Node: Budget report start date290640 -Ref: #budget-report-start-date290818 -Node: Budgets and subaccounts292180 -Ref: #budgets-and-subaccounts292387 -Node: Selecting budget goals295873 -Ref: #selecting-budget-goals296072 -Node: Budget vs forecast297119 -Ref: #budget-vs-forecast297278 -Node: Data layout298978 -Ref: #data-layout299128 -Node: Useful balance reports307069 -Ref: #useful-balance-reports307219 -Node: balancesheet308372 -Ref: #balancesheet308517 -Node: balancesheetequity309883 -Ref: #balancesheetequity310041 -Node: cashflow311484 -Ref: #cashflow311615 -Node: check313101 -Ref: #check313215 -Node: Basic checks314021 -Ref: #basic-checks314141 -Node: Strict checks314679 -Ref: #strict-checks314822 -Node: Other checks315263 -Ref: #other-checks315405 -Node: Custom checks315982 -Ref: #custom-checks316139 -Node: More about specific checks316560 -Ref: #more-about-specific-checks316722 -Node: close317454 -Ref: #close317565 -Node: close and costs319951 -Ref: #close-and-costs320095 -Node: close and balance assertions320384 -Ref: #close-and-balance-assertions320586 -Node: Example retain earnings321757 -Ref: #example-retain-earnings321974 -Node: Example migrate balances to a new file322332 -Ref: #example-migrate-balances-to-a-new-file322597 -Node: Example excluding closing/opening transactions323150 -Ref: #example-excluding-closingopening-transactions323399 -Node: codes324577 -Ref: #codes324694 -Node: commodities325570 -Ref: #commodities325698 -Node: demo325768 -Ref: #demo325889 -Node: descriptions326745 -Ref: #descriptions326875 -Node: diff327166 -Ref: #diff327281 -Node: files328327 -Ref: #files328436 -Node: help328577 -Ref: #help-1328686 -Node: import329676 -Ref: #import329799 -Node: Deduplication330907 -Ref: #deduplication331032 -Node: Import testing332954 -Ref: #import-testing333119 -Node: Importing balance assignments333970 -Ref: #importing-balance-assignments334176 -Node: Commodity display styles334833 -Ref: #commodity-display-styles335006 -Node: incomestatement335135 -Ref: #incomestatement335277 -Node: notes336644 -Ref: #notes336766 -Node: payees337128 -Ref: #payees337243 -Node: prices337768 -Ref: #prices337883 -Node: print338185 -Ref: #print338300 -Node: register343746 -Ref: #register343868 -Node: Custom register output348977 -Ref: #custom-register-output349108 -Node: rewrite350483 -Ref: #rewrite350601 -Node: Re-write rules in a file352513 -Ref: #re-write-rules-in-a-file352676 -Node: Diff output format353829 -Ref: #diff-output-format354012 -Node: rewrite vs print --auto355124 -Ref: #rewrite-vs.-print---auto355286 -Node: roi355860 -Ref: #roi355967 -Node: Spaces and special characters in --inv and --pnl357728 -Ref: #spaces-and-special-characters-in---inv-and---pnl357976 -Node: Semantics of --inv and --pnl358474 -Ref: #semantics-of---inv-and---pnl358721 -Node: IRR and TWR explained360599 -Ref: #irr-and-twr-explained360759 -Node: stats363871 -Ref: #stats363979 -Node: tags365376 -Ref: #tags-1365483 -Node: test366500 -Ref: #test366593 -Node: PART 5 COMMON TASKS367343 -Ref: #part-5-common-tasks367476 -Node: Getting help367750 -Ref: #getting-help367891 -Node: Constructing command lines368655 -Ref: #constructing-command-lines368856 -Node: Starting a journal file369537 -Ref: #starting-a-journal-file369744 -Node: Setting opening balances370942 -Ref: #setting-opening-balances371147 -Node: Recording transactions374300 -Ref: #recording-transactions374489 -Node: Reconciling375045 -Ref: #reconciling375197 -Node: Reporting377510 -Ref: #reporting377659 -Node: Migrating to a new file381648 -Ref: #migrating-to-a-new-file381805 +Node: Other cost/lot notations62462 +Ref: #other-costlot-notations62596 +Node: Balance assertions65349 +Ref: #balance-assertions65502 +Node: Assertions and ordering66595 +Ref: #assertions-and-ordering66786 +Node: Assertions and multiple included files67488 +Ref: #assertions-and-multiple-included-files67750 +Node: Assertions and multiple -f files68258 +Ref: #assertions-and-multiple--f-files68511 +Node: Assertions and commodities68920 +Ref: #assertions-and-commodities69144 +Node: Assertions and prices70334 +Ref: #assertions-and-prices70542 +Node: Assertions and subaccounts70973 +Ref: #assertions-and-subaccounts71196 +Node: Assertions and virtual postings71538 +Ref: #assertions-and-virtual-postings71778 +Node: Assertions and auto postings71918 +Ref: #assertions-and-auto-postings72150 +Node: Assertions and precision72821 +Ref: #assertions-and-precision73005 +Node: Posting comments73272 +Ref: #posting-comments73420 +Node: Tags73805 +Ref: #tags73921 +Node: Tag values75126 +Ref: #tag-values75217 +Node: Directives75990 +Ref: #directives76119 +Node: Directive effects77987 +Ref: #directive-effects78143 +Node: Directives and multiple files81226 +Ref: #directives-and-multiple-files81406 +Node: account directive82116 +Ref: #account-directive82278 +Node: Account comments83698 +Ref: #account-comments83850 +Node: Account subdirectives84370 +Ref: #account-subdirectives84563 +Node: Account error checking84705 +Ref: #account-error-checking84905 +Node: Account display order86124 +Ref: #account-display-order86314 +Node: Account types87453 +Ref: #account-types87596 +Node: alias directive91331 +Ref: #alias-directive91498 +Node: Basic aliases92558 +Ref: #basic-aliases92691 +Node: Regex aliases93445 +Ref: #regex-aliases93604 +Node: Combining aliases94498 +Ref: #combining-aliases94678 +Node: Aliases and multiple files95972 +Ref: #aliases-and-multiple-files96178 +Node: end aliases directive96763 +Ref: #end-aliases-directive96988 +Node: Aliases can generate bad account names97137 +Ref: #aliases-can-generate-bad-account-names97387 +Node: Aliases and account types97984 +Ref: #aliases-and-account-types98178 +Node: commodity directive98880 +Ref: #commodity-directive99060 +Node: Commodity error checking101664 +Ref: #commodity-error-checking101812 +Node: decimal-mark directive102341 +Ref: #decimal-mark-directive102529 +Node: include directive102930 +Ref: #include-directive103100 +Node: P directive104048 +Ref: #p-directive104199 +Node: payee directive105098 +Ref: #payee-directive105253 +Node: tag directive105573 +Ref: #tag-directive105734 +Node: Periodic transactions106206 +Ref: #periodic-transactions106372 +Node: Periodic rule syntax108110 +Ref: #periodic-rule-syntax108290 +Node: Periodic rules and relative dates108945 +Ref: #periodic-rules-and-relative-dates109213 +Node: Two spaces between period expression and description!109752 +Ref: #two-spaces-between-period-expression-and-description110031 +Node: Other syntax110721 +Ref: #other-syntax110847 +Node: Auto postings111492 +Ref: #auto-postings111628 +Node: Auto postings and multiple files114139 +Ref: #auto-postings-and-multiple-files114341 +Node: Auto postings and dates114558 +Ref: #auto-postings-and-dates114830 +Node: Auto postings and transaction balancing / inferred amounts / balance assertions115005 +Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions115344 +Node: Auto posting tags115851 +Ref: #auto-posting-tags116064 +Node: Balance assignments116726 +Ref: #balance-assignments116906 +Node: Balance assignments and prices118240 +Ref: #balance-assignments-and-prices118410 +Node: Bracketed posting dates118621 +Ref: #bracketed-posting-dates118807 +Node: D directive119351 +Ref: #d-directive119525 +Node: apply account directive121193 +Ref: #apply-account-directive121379 +Node: Y directive122078 +Ref: #y-directive122244 +Node: Secondary dates123088 +Ref: #secondary-dates123244 +Node: Star comments124076 +Ref: #star-comments124238 +Node: Valuation expressions124778 +Ref: #valuation-expressions124957 +Node: Virtual postings125079 +Ref: #virtual-postings125260 +Node: Other Ledger directives126832 +Ref: #other-ledger-directives126997 +Node: CSV127567 +Ref: #csv127660 +Node: CSV rules cheatsheet129763 +Ref: #csv-rules-cheatsheet129895 +Node: separator131663 +Ref: #separator131794 +Node: skip132372 +Ref: #skip132484 +Node: date-format133067 +Ref: #date-format133192 +Node: timezone133938 +Ref: #timezone134065 +Node: newest-first135098 +Ref: #newest-first135240 +Node: intra-day-reversed135824 +Ref: #intra-day-reversed135982 +Node: decimal-mark136479 +Ref: #decimal-mark136624 +Node: fields list136963 +Ref: #fields-list137104 +Node: Field assignment138827 +Ref: #field-assignment138971 +Node: Field names140020 +Ref: #field-names140151 +Node: date field141372 +Ref: #date-field141490 +Node: date2 field141542 +Ref: #date2-field141683 +Node: status field141745 +Ref: #status-field141888 +Node: code field141943 +Ref: #code-field142088 +Node: description field142139 +Ref: #description-field142299 +Node: comment field142364 +Ref: #comment-field142519 +Node: account field142832 +Ref: #account-field142982 +Node: amount field143578 +Ref: #amount-field143727 +Node: currency field145832 +Ref: #currency-field145985 +Node: balance field146254 +Ref: #balance-field146386 +Node: if block146774 +Ref: #if-block146899 +Node: Matchers148323 +Ref: #matchers148437 +Node: if table149967 +Ref: #if-table150093 +Node: balance-type151529 +Ref: #balance-type151662 +Node: include152370 +Ref: #include152501 +Node: Working with CSV152951 +Ref: #working-with-csv153098 +Node: Rapid feedback153469 +Ref: #rapid-feedback153602 +Node: Valid CSV154058 +Ref: #valid-csv154204 +Node: File Extension154958 +Ref: #file-extension155131 +Node: Reading CSV from standard input155721 +Ref: #reading-csv-from-standard-input155945 +Node: Reading multiple CSV files156111 +Ref: #reading-multiple-csv-files156329 +Node: Valid transactions156578 +Ref: #valid-transactions156772 +Node: Deduplicating importing157400 +Ref: #deduplicating-importing157595 +Node: Setting amounts158641 +Ref: #setting-amounts158812 +Node: Amount signs161335 +Ref: #amount-signs161503 +Node: Setting currency/commodity162242 +Ref: #setting-currencycommodity162446 +Node: Amount decimal places163638 +Ref: #amount-decimal-places163844 +Node: Referencing other fields164162 +Ref: #referencing-other-fields164375 +Node: How CSV rules are evaluated165278 +Ref: #how-csv-rules-are-evaluated165495 +Node: Well factored rules167008 +Ref: #well-factored-rules167176 +Node: CSV rules examples167514 +Ref: #csv-rules-examples167649 +Node: Bank of Ireland167714 +Ref: #bank-of-ireland167851 +Node: Coinbase169319 +Ref: #coinbase169457 +Node: Amazon170510 +Ref: #amazon170635 +Node: Paypal172360 +Ref: #paypal172468 +Node: Timeclock180114 +Ref: #timeclock180219 +Node: Timedot182387 +Ref: #timedot182510 +Node: PART 3 REPORTING CONCEPTS187361 +Ref: #part-3-reporting-concepts187525 +Node: Time periods187525 +Ref: #time-periods187659 +Node: Report start & end date187777 +Ref: #report-start-end-date187929 +Node: Smart dates189662 +Ref: #smart-dates189815 +Node: Report intervals191775 +Ref: #report-intervals191930 +Node: Date adjustment192382 +Ref: #date-adjustment192542 +Node: Period expressions193874 +Ref: #period-expressions194015 +Node: Period expressions with a report interval195851 +Ref: #period-expressions-with-a-report-interval196085 +Node: More complex report intervals196315 +Ref: #more-complex-report-intervals196560 +Node: Multiple weekday intervals198489 +Ref: #multiple-weekday-intervals198678 +Node: Depth199542 +Ref: #depth199644 +Node: Queries199964 +Ref: #queries200066 +Node: Query types201011 +Ref: #query-types201132 +Node: Combining query terms204472 +Ref: #combining-query-terms204649 +Node: Queries and command options205987 +Ref: #queries-and-command-options206186 +Node: Queries and valuation206451 +Ref: #queries-and-valuation206646 +Node: Querying with account aliases206885 +Ref: #querying-with-account-aliases207096 +Node: Querying with cost or value207238 +Ref: #querying-with-cost-or-value207415 +Node: Pivoting207724 +Ref: #pivoting207838 +Node: Generating data209326 +Ref: #generating-data209458 +Node: Forecasting209956 +Ref: #forecasting210081 +Node: Budgeting212968 +Ref: #budgeting213088 +Node: Cost reporting213359 +Ref: #cost-reporting213487 +Node: -B Convert to cost214602 +Ref: #b-convert-to-cost214758 +Node: Equity conversion postings216166 +Ref: #equity-conversion-postings216380 +Node: Inferring equity postings from cost217275 +Ref: #inferring-equity-postings-from-cost217524 +Node: Inferring cost from equity postings218343 +Ref: #inferring-cost-from-equity-postings218591 +Node: When to infer cost/equity220400 +Ref: #when-to-infer-costequity220618 +Node: How to record conversions221026 +Ref: #how-to-record-conversions221218 +Node: Conversion with implicit cost221509 +Ref: #conversion-with-implicit-cost221714 +Node: Conversion with explicit cost222619 +Ref: #conversion-with-explicit-cost222864 +Node: Conversion with equity postings223291 +Ref: #conversion-with-equity-postings223560 +Node: Conversion with equity postings and explicit cost224397 +Ref: #conversion-with-equity-postings-and-explicit-cost224664 +Node: Cost tips225138 +Ref: #cost-tips225264 +Node: Valuation226000 +Ref: #valuation226124 +Node: -V Value226910 +Ref: #v-value227036 +Node: -X Value in specified commodity227235 +Ref: #x-value-in-specified-commodity227430 +Node: Valuation date227587 +Ref: #valuation-date227758 +Node: Finding market price228197 +Ref: #finding-market-price228402 +Node: --infer-market-prices market prices from transactions229582 +Ref: #infer-market-prices-market-prices-from-transactions229860 +Node: Valuation commodity232706 +Ref: #valuation-commodity232919 +Node: Simple valuation examples234164 +Ref: #simple-valuation-examples234362 +Node: --value Flexible valuation235025 +Ref: #value-flexible-valuation235231 +Node: More valuation examples236917 +Ref: #more-valuation-examples237126 +Node: Interaction of valuation and queries239137 +Ref: #interaction-of-valuation-and-queries239378 +Node: Effect of valuation on reports239858 +Ref: #effect-of-valuation-on-reports240055 +Node: PART 4 COMMANDS247814 +Ref: #part-4-commands247957 +Node: Commands overview248336 +Ref: #commands-overview248470 +Node: DATA ENTRY248649 +Ref: #data-entry248773 +Node: DATA CREATION248976 +Ref: #data-creation249130 +Node: DATA MANAGEMENT249254 +Ref: #data-management249419 +Node: REPORTS FINANCIAL249544 +Ref: #reports-financial249719 +Node: REPORTS VERSATILE250034 +Ref: #reports-versatile250207 +Node: REPORTS BASIC250468 +Ref: #reports-basic250620 +Node: HELP251153 +Ref: #help251275 +Node: ADD-ONS251389 +Ref: #add-ons251495 +Node: accounts252092 +Ref: #accounts252225 +Node: activity254200 +Ref: #activity254319 +Node: add254693 +Ref: #add254803 +Node: aregister257664 +Ref: #aregister257785 +Node: aregister and custom posting dates260761 +Ref: #aregister-and-custom-posting-dates260927 +Node: balance261495 +Ref: #balance261621 +Node: balance features262626 +Ref: #balance-features262766 +Node: Simple balance report264896 +Ref: #simple-balance-report265081 +Node: Balance report line format266726 +Ref: #balance-report-line-format266928 +Node: Filtered balance report269178 +Ref: #filtered-balance-report269370 +Node: List or tree mode269697 +Ref: #list-or-tree-mode269865 +Node: Depth limiting271240 +Ref: #depth-limiting271406 +Node: Dropping top-level accounts272023 +Ref: #dropping-top-level-accounts272223 +Node: Showing declared accounts272537 +Ref: #showing-declared-accounts272736 +Node: Sorting by amount273277 +Ref: #sorting-by-amount273444 +Node: Percentages274134 +Ref: #percentages274293 +Node: Multi-period balance report274863 +Ref: #multi-period-balance-report275063 +Node: Balance change end balance277456 +Ref: #balance-change-end-balance277665 +Node: Balance report types279113 +Ref: #balance-report-types279294 +Node: Calculation type279810 +Ref: #calculation-type279965 +Node: Accumulation type280496 +Ref: #accumulation-type280676 +Node: Valuation type281604 +Ref: #valuation-type281792 +Node: Combining balance report types282859 +Ref: #combining-balance-report-types283053 +Node: Budget report284957 +Ref: #budget-report285109 +Node: Budget report start date290843 +Ref: #budget-report-start-date291021 +Node: Budgets and subaccounts292383 +Ref: #budgets-and-subaccounts292590 +Node: Selecting budget goals296076 +Ref: #selecting-budget-goals296275 +Node: Budget vs forecast297322 +Ref: #budget-vs-forecast297481 +Node: Data layout299181 +Ref: #data-layout299331 +Node: Useful balance reports307272 +Ref: #useful-balance-reports307422 +Node: balancesheet308575 +Ref: #balancesheet308720 +Node: balancesheetequity310086 +Ref: #balancesheetequity310244 +Node: cashflow311687 +Ref: #cashflow311818 +Node: check313304 +Ref: #check313418 +Node: Basic checks314224 +Ref: #basic-checks314344 +Node: Strict checks314882 +Ref: #strict-checks315025 +Node: Other checks315466 +Ref: #other-checks315608 +Node: Custom checks316185 +Ref: #custom-checks316342 +Node: More about specific checks316763 +Ref: #more-about-specific-checks316925 +Node: close317657 +Ref: #close317768 +Node: close and costs320154 +Ref: #close-and-costs320298 +Node: close and balance assertions320587 +Ref: #close-and-balance-assertions320789 +Node: Example retain earnings321960 +Ref: #example-retain-earnings322177 +Node: Example migrate balances to a new file322535 +Ref: #example-migrate-balances-to-a-new-file322800 +Node: Example excluding closing/opening transactions323353 +Ref: #example-excluding-closingopening-transactions323602 +Node: codes324780 +Ref: #codes324897 +Node: commodities325773 +Ref: #commodities325901 +Node: demo325971 +Ref: #demo326092 +Node: descriptions326948 +Ref: #descriptions327078 +Node: diff327369 +Ref: #diff327484 +Node: files328530 +Ref: #files328639 +Node: help328780 +Ref: #help-1328889 +Node: import329879 +Ref: #import330002 +Node: Deduplication331110 +Ref: #deduplication331235 +Node: Import testing333157 +Ref: #import-testing333322 +Node: Importing balance assignments334173 +Ref: #importing-balance-assignments334379 +Node: Commodity display styles335036 +Ref: #commodity-display-styles335209 +Node: incomestatement335338 +Ref: #incomestatement335480 +Node: notes336847 +Ref: #notes336969 +Node: payees337331 +Ref: #payees337446 +Node: prices337971 +Ref: #prices338086 +Node: print338388 +Ref: #print338503 +Node: register343949 +Ref: #register344071 +Node: Custom register output349180 +Ref: #custom-register-output349311 +Node: rewrite350686 +Ref: #rewrite350804 +Node: Re-write rules in a file352716 +Ref: #re-write-rules-in-a-file352879 +Node: Diff output format354032 +Ref: #diff-output-format354215 +Node: rewrite vs print --auto355327 +Ref: #rewrite-vs.-print---auto355489 +Node: roi356063 +Ref: #roi356170 +Node: Spaces and special characters in --inv and --pnl357931 +Ref: #spaces-and-special-characters-in---inv-and---pnl358179 +Node: Semantics of --inv and --pnl358677 +Ref: #semantics-of---inv-and---pnl358924 +Node: IRR and TWR explained360802 +Ref: #irr-and-twr-explained360962 +Node: stats364074 +Ref: #stats364182 +Node: tags365579 +Ref: #tags-1365686 +Node: test366703 +Ref: #test366796 +Node: PART 5 COMMON TASKS367546 +Ref: #part-5-common-tasks367679 +Node: Getting help367953 +Ref: #getting-help368094 +Node: Constructing command lines368858 +Ref: #constructing-command-lines369059 +Node: Starting a journal file369740 +Ref: #starting-a-journal-file369947 +Node: Setting opening balances371145 +Ref: #setting-opening-balances371350 +Node: Recording transactions374503 +Ref: #recording-transactions374692 +Node: Reconciling375248 +Ref: #reconciling375400 +Node: Reporting377713 +Ref: #reporting377862 +Node: Migrating to a new file381851 +Ref: #migrating-to-a-new-file382008  End Tag Table diff --git a/hledger/hledger.txt b/hledger/hledger.txt index 90c95678d..071677d34 100644 --- a/hledger/hledger.txt +++ b/hledger/hledger.txt @@ -1411,6 +1411,10 @@ Journal Amounts can be converted to cost at report time using the -B/--cost flag; this is discussed more in the COST REPORTING section. + Note that the cost normally should be a positive amount, though it's + not required to be. This can be a little confusing, see discussion at + --infer-market-prices: market prices from transactions. + Other cost/lot notations A slight digression for Ledger and Beancount users. Ledger has a num- ber of cost/lot-related notations: @@ -1744,8 +1748,6 @@ Journal entries (transactions) it affects: - - direc- what it does ends tive at file