;doc: update embedded manuals

This commit is contained in:
Simon Michael 2024-12-20 10:37:38 -10:00
parent 9de9fe7656
commit c2ae02adb6
3 changed files with 368 additions and 377 deletions

View File

@ -1231,6 +1231,13 @@ top level account names must be \f[CR]Assets\f[R],
\f[CR]Expenses\f[R]. \f[CR]Expenses\f[R].
You can use account aliases to rewrite your account names temporarily, You can use account aliases to rewrite your account names temporarily,
if needed, as in this hledger2beancount.conf config file. if needed, as in this hledger2beancount.conf config file.
.PP
2024\-12\-20: Some more things not yet handled for you:
.IP \[bu] 2
P directives are not converted automatically \- convert those yourself
.IP \[bu] 2
Balance assignments are not converted (Beancount doesnt support them) \-
replace those with explicit amounts
.SS Beancount account names .SS Beancount account names
Aside from the top\-level names, hledger will adjust your account names Aside from the top\-level names, hledger will adjust your account names
to make valid Beancount account names, by capitalising each part, to make valid Beancount account names, by capitalising each part,
@ -9232,6 +9239,8 @@ Flags:
balance. balance.
\-\-no\-elide don\[aq]t show only 2 commodities per amount \-\-no\-elide don\[aq]t show only 2 commodities per amount
\-\-cumulative show running total from report start date \-\-cumulative show running total from report start date
\-H \-\-historical show historical running total/balance (includes
postings before report start date) (default)
\-\-invert display all amounts with reversed sign \-\-invert display all amounts with reversed sign
\-\-heading=YN show heading row above table: yes (default) or no \-\-heading=YN show heading row above table: yes (default) or no
\-w \-\-width=N set output width (default: terminal width or \-w \-\-width=N set output width (default: terminal width or
@ -9539,8 +9548,6 @@ Flags:
market price fluctuations) market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical \-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions
\-\-count show the count of postings \-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -9643,8 +9650,6 @@ Flags:
market price fluctuations) market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical \-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions
\-\-count show the count of postings \-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -9755,8 +9760,6 @@ Flags:
market price fluctuations) market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical \-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions
\-\-count show the count of postings \-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -9856,8 +9859,6 @@ Flags:
market price fluctuations) market price fluctuations)
\-\-gain show unrealised capital gain/loss (historical \-\-gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
\-\-budget show sum of posting amounts compared to budget
goals defined by periodic transactions
\-\-count show the count of postings \-\-count show the count of postings
\-\-change accumulate amounts from column start to column \-\-change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -11066,10 +11067,6 @@ if your \f[CR]hledger\-web\f[R] server is reachable at
You can also produce relative links, like You can also produce relative links, like
\f[CR]\-\-base\-url=\[dq]some/path\[dq]\f[R] or \f[CR]\-\-base\-url=\[dq]some/path\[dq]\f[R] or
\f[CR]\-\-base\-url=\[dq]\[dq]\f[R].) \f[CR]\-\-base\-url=\[dq]\[dq]\f[R].)
.PP
The balance reports\[aq] HTML output currently does not indent tree mode
reports properly (#1846).
So in HTML balance reports, use list mode for now (it is the default).
.SS Some useful balance reports .SS Some useful balance reports
Some frequently used \f[CR]balance\f[R] options/reports are: Some frequently used \f[CR]balance\f[R] options/reports are:
.IP \[bu] 2 .IP \[bu] 2

View File

@ -1153,6 +1153,13 @@ the top level account names must be 'Assets', 'Liabilities', 'Equity',
your account names temporarily, if needed, as in this your account names temporarily, if needed, as in this
hledger2beancount.conf config file. hledger2beancount.conf config file.
2024-12-20: Some more things not yet handled for you:
* P directives are not converted automatically - convert those
yourself
* Balance assignments are not converted (Beancount doesnt support
them) - replace those with explicit amounts
* Menu: * Menu:
* Beancount account names:: * Beancount account names::
@ -9034,6 +9041,8 @@ Flags:
balance. balance.
--no-elide don't show only 2 commodities per amount --no-elide don't show only 2 commodities per amount
--cumulative show running total from report start date --cumulative show running total from report start date
-H --historical show historical running total/balance (includes
postings before report start date) (default)
--invert display all amounts with reversed sign --invert display all amounts with reversed sign
--heading=YN show heading row above table: yes (default) or no --heading=YN show heading row above table: yes (default) or no
-w --width=N set output width (default: terminal width or -w --width=N set output width (default: terminal width or
@ -9329,8 +9338,6 @@ Flags:
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -9431,8 +9438,6 @@ Flags:
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -9541,8 +9546,6 @@ Flags:
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -9639,8 +9642,6 @@ Flags:
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -10803,10 +10804,6 @@ might run the 'balance' command with the extra option
'--base-url=http://localhost:5000'. You can also produce relative '--base-url=http://localhost:5000'. You can also produce relative
links, like '--base-url="some/path"' or '--base-url=""'.) links, like '--base-url="some/path"' or '--base-url=""'.)
The balance reports' HTML output currently does not indent tree mode
reports properly (#1846). So in HTML balance reports, use list mode for
now (it is the default).
 
File: hledger.info, Node: Some useful balance reports, Prev: Balance report output, Up: balance File: hledger.info, Node: Some useful balance reports, Prev: Balance report output, Up: balance
@ -12354,347 +12351,347 @@ Node: HTML output42433
Node: CSV / TSV output42887 Node: CSV / TSV output42887
Node: FODS output43141 Node: FODS output43141
Node: Beancount output43945 Node: Beancount output43945
Node: Beancount account names45143 Node: Beancount account names45400
Node: Beancount commodity names45684 Node: Beancount commodity names45941
Node: Beancount virtual postings46331 Node: Beancount virtual postings46588
Node: Beancount metadata46647 Node: Beancount metadata46904
Node: Beancount costs47427 Node: Beancount costs47684
Node: Beancount operating currency47843 Node: Beancount operating currency48100
Node: SQL output48293 Node: SQL output48550
Node: JSON output49084 Node: JSON output49341
Node: Commodity styles49901 Node: Commodity styles50158
Node: Debug output50785 Node: Debug output51042
Node: Environment51617 Node: Environment51874
Node: PART 2 DATA FORMATS52466 Node: PART 2 DATA FORMATS52723
Node: Journal52609 Node: Journal52866
Node: Journal cheatsheet55087 Node: Journal cheatsheet55344
Node: Comments61301 Node: Comments61558
Node: Transactions62245 Node: Transactions62502
Node: Dates63382 Node: Dates63639
Node: Simple dates63534 Node: Simple dates63791
Node: Posting dates64150 Node: Posting dates64407
Node: Status65237 Node: Status65494
Node: Code67003 Node: Code67260
Node: Description67338 Node: Description67595
Node: Payee and note68025 Node: Payee and note68282
Node: Transaction comments69116 Node: Transaction comments69373
Node: Postings69632 Node: Postings69889
Node: Debits and credits70795 Node: Debits and credits71052
Node: The two space delimiter71405 Node: The two space delimiter71662
Node: Account names71970 Node: Account names72227
Node: Amounts73774 Node: Amounts74031
Node: Decimal marks74803 Node: Decimal marks75060
Node: Digit group marks75907 Node: Digit group marks76164
Node: Commodity76542 Node: Commodity76799
Node: Costs77659 Node: Costs77916
Node: Balance assertions79911 Node: Balance assertions80168
Node: Assertions and ordering81174 Node: Assertions and ordering81431
Node: Assertions and multiple included files81902 Node: Assertions and multiple included files82159
Node: Assertions and multiple -f files82662 Node: Assertions and multiple -f files82919
Node: Assertions and costs83304 Node: Assertions and costs83561
Node: Assertions and commodities83954 Node: Assertions and commodities84211
Node: Assertions and subaccounts85613 Node: Assertions and subaccounts85870
Node: Assertions and status86273 Node: Assertions and status86530
Node: Assertions and virtual postings86693 Node: Assertions and virtual postings86950
Node: Assertions and auto postings87058 Node: Assertions and auto postings87315
Node: Assertions and precision87933 Node: Assertions and precision88190
Node: Posting comments88384 Node: Posting comments88641
Node: Transaction balancing88924 Node: Transaction balancing89181
Node: Tags90926 Node: Tags91183
Node: Querying with tags92220 Node: Querying with tags92477
Node: Displaying tags93019 Node: Displaying tags93276
Node: When to use tags ?93415 Node: When to use tags ?93672
Node: Tag names94079 Node: Tag names94336
Node: Special tags94632 Node: Special tags94889
Node: Directives96197 Node: Directives96454
Node: Directives and multiple files97654 Node: Directives and multiple files97911
Node: Directive effects98599 Node: Directive effects98856
Node: account directive101755 Node: account directive102012
Node: Account comments103205 Node: Account comments103462
Node: Account error checking103864 Node: Account error checking104121
Node: Account display order105401 Node: Account display order105658
Node: Account types106599 Node: Account types106856
Node: alias directive110373 Node: alias directive110630
Node: Basic aliases111584 Node: Basic aliases111841
Node: Regex aliases112459 Node: Regex aliases112716
Node: Combining aliases113506 Node: Combining aliases113763
Node: Aliases and multiple files114960 Node: Aliases and multiple files115217
Node: end aliases directive115743 Node: end aliases directive116000
Node: Aliases can generate bad account names116111 Node: Aliases can generate bad account names116368
Node: Aliases and account types116944 Node: Aliases and account types117201
Node: commodity directive117832 Node: commodity directive118089
Node: Commodity directive syntax119419 Node: Commodity directive syntax119676
Node: Commodity error checking121055 Node: Commodity error checking121312
Node: decimal-mark directive121530 Node: decimal-mark directive121787
Node: include directive122109 Node: include directive122366
Node: P directive123185 Node: P directive123442
Node: payee directive124219 Node: payee directive124476
Node: tag directive124841 Node: tag directive125098
Node: Periodic transactions125453 Node: Periodic transactions125710
Node: Periodic rule syntax127607 Node: Periodic rule syntax127864
Node: Periodic rules and relative dates128430 Node: Periodic rules and relative dates128687
Node: Two spaces between period expression and description!129207 Node: Two spaces between period expression and description!129464
Node: Auto postings130168 Node: Auto postings130425
Node: Auto postings and multiple files133328 Node: Auto postings and multiple files133585
Node: Auto postings and dates133733 Node: Auto postings and dates133990
Node: Auto postings and transaction balancing / inferred amounts / balance assertions134174 Node: Auto postings and transaction balancing / inferred amounts / balance assertions134431
Node: Auto posting tags135020 Node: Auto posting tags135277
Node: Auto postings on forecast transactions only135915 Node: Auto postings on forecast transactions only136172
Node: Other syntax136385 Node: Other syntax136642
Node: Balance assignments137157 Node: Balance assignments137414
Node: Balance assignments and costs138685 Node: Balance assignments and costs138942
Node: Balance assignments and multiple files139107 Node: Balance assignments and multiple files139364
Node: Bracketed posting dates139530 Node: Bracketed posting dates139787
Node: D directive140228 Node: D directive140485
Node: apply account directive142001 Node: apply account directive142258
Node: Y directive142868 Node: Y directive143125
Node: Secondary dates143856 Node: Secondary dates144113
Node: Star comments145341 Node: Star comments145598
Node: Valuation expressions146033 Node: Valuation expressions146290
Node: Virtual postings146332 Node: Virtual postings146589
Node: Other Ledger directives147956 Node: Other Ledger directives148213
Node: Other cost/lot notations148718 Node: Other cost/lot notations148975
Node: CSV151480 Node: CSV151737
Node: CSV rules cheatsheet153563 Node: CSV rules cheatsheet153820
Node: source155488 Node: source155745
Node: separator156489 Node: separator156746
Node: skip157140 Node: skip157397
Node: date-format157790 Node: date-format158047
Node: timezone158633 Node: timezone158890
Node: newest-first159759 Node: newest-first160016
Node: intra-day-reversed160472 Node: intra-day-reversed160729
Node: decimal-mark161072 Node: decimal-mark161329
Node: fields list161550 Node: fields list161807
Node: Field assignment163358 Node: Field assignment163615
Node: Field names164577 Node: Field names164834
Node: date field165909 Node: date field166166
Node: date2 field166073 Node: date2 field166330
Node: status field166268 Node: status field166525
Node: code field166458 Node: code field166715
Node: description field166646 Node: description field166903
Node: comment field166863 Node: comment field167120
Node: account field167420 Node: account field167677
Node: amount field168138 Node: amount field168395
Node: currency field170977 Node: currency field171234
Node: balance field171385 Node: balance field171642
Node: if block171908 Node: if block172165
Node: Matchers173435 Node: Matchers173692
Node: Multiple matchers175425 Node: Multiple matchers175682
Node: Match groups175901 Node: Match groups176158
Node: if table176794 Node: if table177051
Node: balance-type178795 Node: balance-type179052
Node: include179622 Node: include179879
Node: Working with CSV180191 Node: Working with CSV180448
Node: Rapid feedback180743 Node: Rapid feedback181000
Node: Valid CSV181326 Node: Valid CSV181583
Node: File Extension182202 Node: File Extension182459
Node: Reading CSV from standard input182937 Node: Reading CSV from standard input183194
Node: Reading multiple CSV files183323 Node: Reading multiple CSV files183580
Node: Reading files specified by rule183799 Node: Reading files specified by rule184056
Node: Valid transactions185196 Node: Valid transactions185453
Node: Deduplicating importing186021 Node: Deduplicating importing186278
Node: Setting amounts187250 Node: Setting amounts187507
Node: Amount signs189777 Node: Amount signs190034
Node: Setting currency/commodity190842 Node: Setting currency/commodity191099
Node: Amount decimal places192218 Node: Amount decimal places192475
Node: Referencing other fields193475 Node: Referencing other fields193732
Node: How CSV rules are evaluated194583 Node: How CSV rules are evaluated194840
Node: Well factored rules196251 Node: Well factored rules196508
Node: CSV rules examples196741 Node: CSV rules examples196998
Node: Bank of Ireland196939 Node: Bank of Ireland197196
Node: Coinbase198536 Node: Coinbase198793
Node: Amazon199719 Node: Amazon199976
Node: Paypal201561 Node: Paypal201818
Node: Timeclock209311 Node: Timeclock209568
Node: Timedot211580 Node: Timedot211837
Node: Timedot examples215057 Node: Timedot examples215314
Node: PART 3 REPORTING CONCEPTS217334 Node: PART 3 REPORTING CONCEPTS217591
Node: Time periods217498 Node: Time periods217755
Node: Report start & end date217771 Node: Report start & end date218028
Node: Smart dates219247 Node: Smart dates219504
Node: Report intervals221190 Node: Report intervals221447
Node: Date adjustments221764 Node: Date adjustments222021
Node: Start date adjustment221984 Node: Start date adjustment222241
Node: End date adjustment222887 Node: End date adjustment223144
Node: Period headings223632 Node: Period headings223889
Node: Period expressions224565 Node: Period expressions224822
Node: Period expressions with a report interval226470 Node: Period expressions with a report interval226727
Node: More complex report intervals226918 Node: More complex report intervals227175
Node: Multiple weekday intervals229034 Node: Multiple weekday intervals229291
Node: Depth230045 Node: Depth230302
Node: Queries231880 Node: Queries232137
Node: Query types233578 Node: Query types233835
Node: acct query233995 Node: acct query234252
Node: amt query234306 Node: amt query234563
Node: code query234923 Node: code query235180
Node: cur query235118 Node: cur query235375
Node: desc query235724 Node: desc query235981
Node: date query235907 Node: date query236164
Node: date2 query236303 Node: date2 query236560
Node: depth query236594 Node: depth query236851
Node: expr query236930 Node: expr query237187
Node: not query237311 Node: not query237568
Node: note query237651 Node: note query237908
Node: payee query237917 Node: payee query238174
Node: real query238198 Node: real query238455
Node: status query238403 Node: status query238660
Node: type query238643 Node: type query238900
Node: tag query239176 Node: tag query239433
Node: Combining query terms239805 Node: Combining query terms240062
Node: Queries and command options241545 Node: Queries and command options241802
Node: Queries and account aliases241999 Node: Queries and account aliases242256
Node: Queries and valuation242324 Node: Queries and valuation242581
Node: Pivoting242686 Node: Pivoting242943
Node: Generating data244577 Node: Generating data244834
Node: Forecasting246377 Node: Forecasting246634
Node: --forecast247033 Node: --forecast247290
Node: Inspecting forecast transactions248134 Node: Inspecting forecast transactions248391
Node: Forecast reports249467 Node: Forecast reports249724
Node: Forecast tags250576 Node: Forecast tags250833
Node: Forecast period in detail251196 Node: Forecast period in detail251453
Node: Forecast troubleshooting252284 Node: Forecast troubleshooting252541
Node: Budgeting253355 Node: Budgeting253612
Node: Amount formatting253915 Node: Amount formatting254172
Node: Commodity display style254159 Node: Commodity display style254416
Node: Rounding256000 Node: Rounding256257
Node: Trailing decimal marks256605 Node: Trailing decimal marks256862
Node: Amount parseability257538 Node: Amount parseability257795
Node: Cost reporting259119 Node: Cost reporting259376
Node: Recording costs259922 Node: Recording costs260179
Node: Reporting at cost261649 Node: Reporting at cost261906
Node: Equity conversion postings262414 Node: Equity conversion postings262671
Node: Inferring equity conversion postings265059 Node: Inferring equity conversion postings265316
Node: Combining costs and equity conversion postings266201 Node: Combining costs and equity conversion postings266458
Node: Requirements for detecting equity conversion postings267426 Node: Requirements for detecting equity conversion postings267683
Node: Infer cost and equity by default ?268948 Node: Infer cost and equity by default ?269205
Node: Value reporting269385 Node: Value reporting269642
Node: -V Value270266 Node: -V Value270523
Node: -X Value in specified commodity270593 Node: -X Value in specified commodity270850
Node: Valuation date270943 Node: Valuation date271200
Node: Finding market price271903 Node: Finding market price272160
Node: --infer-market-prices market prices from transactions273283 Node: --infer-market-prices market prices from transactions273540
Node: Valuation commodity276327 Node: Valuation commodity276584
Node: --value Flexible valuation277760 Node: --value Flexible valuation278017
Node: Valuation examples279603 Node: Valuation examples279860
Node: Interaction of valuation and queries281735 Node: Interaction of valuation and queries281992
Node: Effect of valuation on reports282452 Node: Effect of valuation on reports282709
Node: PART 4 COMMANDS290350 Node: PART 4 COMMANDS290607
Node: Help commands292566 Node: Help commands292823
Node: help292739 Node: help292996
Node: demo294444 Node: demo294701
Node: User interface commands295591 Node: User interface commands295848
Node: ui295785 Node: ui296042
Node: web295910 Node: web296167
Node: Data entry commands296038 Node: Data entry commands296295
Node: add296236 Node: add296493
Node: import298691 Node: import298948
Node: Import preview299725 Node: Import preview299982
Node: Overlap detection300673 Node: Overlap detection300930
Node: First import303559 Node: First import303816
Node: Importing balance assignments304754 Node: Importing balance assignments305011
Node: Import and commodity styles305809 Node: Import and commodity styles306066
Node: Import special cases306247 Node: Import special cases306504
Node: Basic report commands307582 Node: Basic report commands307839
Node: accounts307883 Node: accounts308140
Node: codes310756 Node: codes311013
Node: commodities311778 Node: commodities312035
Node: descriptions312022 Node: descriptions312279
Node: files312489 Node: files312746
Node: notes312786 Node: notes313043
Node: payees313298 Node: payees313555
Node: prices314082 Node: prices314339
Node: stats314974 Node: stats315231
Node: tags316715 Node: tags316972
Node: Standard report commands318022 Node: Standard report commands318279
Node: print318327 Node: print318584
Node: print explicitness321001 Node: print explicitness321258
Node: print amount style321921 Node: print amount style322178
Node: print parseability323159 Node: print parseability323416
Node: print other features324078 Node: print other features324335
Node: print output format324776 Node: print output format325033
Node: aregister328061 Node: aregister328318
Node: aregister and posting dates332383 Node: aregister and posting dates332789
Node: register333284 Node: register333690
Node: Custom register output340471 Node: Custom register output340877
Node: balancesheet341947 Node: balancesheet342353
Node: balancesheetequity346859 Node: balancesheetequity347123
Node: cashflow352141 Node: cashflow352263
Node: incomestatement356845 Node: incomestatement356825
Node: Advanced report commands361585 Node: Advanced report commands361423
Node: balance361793 Node: balance361631
Node: balance features366963 Node: balance features366801
Node: Simple balance report369039 Node: Simple balance report368877
Node: Balance report line format370849 Node: Balance report line format370687
Node: Filtered balance report373209 Node: Filtered balance report373047
Node: List or tree mode373728 Node: List or tree mode373566
Node: Depth limiting375241 Node: Depth limiting375079
Node: Dropping top-level accounts376008 Node: Dropping top-level accounts375846
Node: Showing declared accounts376518 Node: Showing declared accounts376356
Node: Sorting by amount377248 Node: Sorting by amount377086
Node: Percentages378085 Node: Percentages377923
Node: Multi-period balance report378792 Node: Multi-period balance report378630
Node: Balance change end balance381544 Node: Balance change end balance381382
Node: Balance report types383181 Node: Balance report types383019
Node: Calculation type383860 Node: Calculation type383698
Node: Accumulation type384564 Node: Accumulation type384402
Node: Valuation type385665 Node: Valuation type385503
Node: Combining balance report types386854 Node: Combining balance report types386692
Node: Budget report388886 Node: Budget report388724
Node: Using the budget report391191 Node: Using the budget report391029
Node: Budget date surprises393467 Node: Budget date surprises393305
Node: Selecting budget goals394831 Node: Selecting budget goals394669
Node: Budgeting vs forecasting395779 Node: Budgeting vs forecasting395617
Node: Balance report layout397456 Node: Balance report layout397294
Node: Wide layout398661 Node: Wide layout398499
Node: Tall layout401066 Node: Tall layout400904
Node: Bare layout402372 Node: Bare layout402210
Node: Tidy layout404436 Node: Tidy layout404274
Node: Balance report output405980 Node: Balance report output405818
Node: Some useful balance reports406966 Node: Some useful balance reports406633
Node: roi408226 Node: roi407893
Node: Spaces and special characters in --inv and --pnl410473 Node: Spaces and special characters in --inv and --pnl410140
Node: Semantics of --inv and --pnl411199 Node: Semantics of --inv and --pnl410866
Node: IRR and TWR explained413286 Node: IRR and TWR explained412953
Node: Chart commands416697 Node: Chart commands416364
Node: activity416878 Node: activity416545
Node: Data generation commands417375 Node: Data generation commands417042
Node: close417581 Node: close417248
Node: close --migrate420173 Node: close --migrate419840
Node: close --close421937 Node: close --close421604
Node: close --open422315 Node: close --open421982
Node: close --assert422564 Node: close --assert422231
Node: close --assign422929 Node: close --assign422596
Node: close --retain423601 Node: close --retain423268
Node: close customisation424497 Node: close customisation424164
Node: close and balance assertions426141 Node: close and balance assertions425808
Node: close examples427663 Node: close examples427330
Node: Retain earnings427900 Node: Retain earnings427567
Node: Migrate balances to a new file428403 Node: Migrate balances to a new file428070
Node: More detailed close examples429755 Node: More detailed close examples429422
Node: rewrite429977 Node: rewrite429644
Node: Re-write rules in a file432549 Node: Re-write rules in a file432216
Node: Diff output format433859 Node: Diff output format433526
Node: rewrite vs print --auto435132 Node: rewrite vs print --auto434799
Node: Maintenance commands435846 Node: Maintenance commands435513
Node: check436055 Node: check435722
Node: Basic checks437137 Node: Basic checks436804
Node: Strict checks438090 Node: Strict checks437757
Node: Other checks438965 Node: Other checks438632
Node: Custom checks440820 Node: Custom checks440487
Node: diff441275 Node: diff440942
Node: test442482 Node: test442149
Node: PART 5 COMMON TASKS443354 Node: PART 5 COMMON TASKS443021
Node: Getting help443587 Node: Getting help443254
Node: Constructing command lines444496 Node: Constructing command lines444163
Node: Starting a journal file445334 Node: Starting a journal file445001
Node: Setting LEDGER_FILE446718 Node: Setting LEDGER_FILE446385
Node: Setting opening balances447976 Node: Setting opening balances447643
Node: Recording transactions451298 Node: Recording transactions450965
Node: Reconciling452023 Node: Reconciling451690
Node: Reporting454412 Node: Reporting454079
Node: Migrating to a new file458526 Node: Migrating to a new file458193
Node: BUGS458975 Node: BUGS458642
Node: Troubleshooting459940 Node: Troubleshooting459607
 
End Tag Table End Tag Table

View File

@ -882,6 +882,13 @@ Output
count names temporarily, if needed, as in this hledger2beancount.conf count names temporarily, if needed, as in this hledger2beancount.conf
config file. config file.
2024-12-20: Some more things not yet handled for you:
o P directives are not converted automatically - convert those yourself
o Balance assignments are not converted (Beancount doesnt support them)
- replace those with explicit amounts
Beancount account names Beancount account names
Aside from the top-level names, hledger will adjust your account names Aside from the top-level names, hledger will adjust your account names
to make valid Beancount account names, by capitalising each part, re- to make valid Beancount account names, by capitalising each part, re-
@ -7260,6 +7267,8 @@ Standard report commands
balance. balance.
--no-elide don't show only 2 commodities per amount --no-elide don't show only 2 commodities per amount
--cumulative show running total from report start date --cumulative show running total from report start date
-H --historical show historical running total/balance (includes
postings before report start date) (default)
--invert display all amounts with reversed sign --invert display all amounts with reversed sign
--heading=YN show heading row above table: yes (default) or no --heading=YN show heading row above table: yes (default) or no
-w --width=N set output width (default: terminal width or -w --width=N set output width (default: terminal width or
@ -7522,8 +7531,6 @@ Standard report commands
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -7619,8 +7626,6 @@ Standard report commands
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) end (in multicolumn reports)
@ -7722,8 +7727,6 @@ Standard report commands
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -7815,8 +7818,6 @@ Standard report commands
market price fluctuations) market price fluctuations)
--gain show unrealised capital gain/loss (historical --gain show unrealised capital gain/loss (historical
balance value minus cost basis) balance value minus cost basis)
--budget show sum of posting amounts compared to budget
goals defined by periodic transactions
--count show the count of postings --count show the count of postings
--change accumulate amounts from column start to column --change accumulate amounts from column start to column
end (in multicolumn reports) (default) end (in multicolumn reports) (default)
@ -8828,10 +8829,6 @@ Advanced report commands
host:5000. You can also produce relative links, like host:5000. You can also produce relative links, like
--base-url="some/path" or --base-url="".) --base-url="some/path" or --base-url="".)
The balance reports' HTML output currently does not indent tree mode
reports properly (#1846). So in HTML balance reports, use list mode
for now (it is the default).
Some useful balance reports Some useful balance reports
Some frequently used balance options/reports are: Some frequently used balance options/reports are: