doc: regen manuals
[ci skip]
This commit is contained in:
Simon Michael
parent
2364a53f49
commit
21fac53954
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger\-api" "1" "February 2019" "hledger\-api 1.13" "hledger User Manuals"
|
.TH "hledger\-api" "1" "February 2019" "hledger\-api 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -3,8 +3,8 @@ This is hledger-api.info, produced by makeinfo version 6.5 from stdin.
|
|||||||
|
|
||||||
File: hledger-api.info, Node: Top, Next: OPTIONS, Up: (dir)
|
File: hledger-api.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||||
|
|
||||||
hledger-api(1) hledger-api 1.13
|
hledger-api(1) hledger-api 1.13.99
|
||||||
*******************************
|
**********************************
|
||||||
|
|
||||||
hledger-api is a simple web API server, intended to support client-side
|
hledger-api is a simple web API server, intended to support client-side
|
||||||
web apps operating on hledger data. It comes with a series of simple
|
web apps operating on hledger data. It comes with a series of simple
|
||||||
@ -80,7 +80,7 @@ options as shown above.
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top72
|
Node: Top72
|
||||||
Node: OPTIONS1660
|
Node: OPTIONS1666
|
||||||
Ref: #options1745
|
Ref: #options1751
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -117,4 +117,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger-api 1.13 February 2019 hledger-api(1)
|
hledger-api 1.13.99 February 2019 hledger-api(1)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger_csv" "5" "February 2019" "hledger 1.13" "hledger User Manuals"
|
.TH "hledger_csv" "5" "February 2019" "hledger 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -3,8 +3,8 @@ This is hledger_csv.info, produced by makeinfo version 6.5 from stdin.
|
|||||||
|
|
||||||
File: hledger_csv.info, Node: Top, Next: CSV RULES, Up: (dir)
|
File: hledger_csv.info, Node: Top, Next: CSV RULES, Up: (dir)
|
||||||
|
|
||||||
hledger_csv(5) hledger 1.13
|
hledger_csv(5) hledger 1.13.99
|
||||||
***************************
|
******************************
|
||||||
|
|
||||||
hledger can read CSV (comma-separated value) files as if they were
|
hledger can read CSV (comma-separated value) files as if they were
|
||||||
journal files, automatically converting each CSV record into a
|
journal files, automatically converting each CSV record into a
|
||||||
@ -317,33 +317,33 @@ one rules file will be used for all the CSV files being read.
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top72
|
Node: Top72
|
||||||
Node: CSV RULES2163
|
Node: CSV RULES2169
|
||||||
Ref: #csv-rules2271
|
Ref: #csv-rules2277
|
||||||
Node: skip2533
|
Node: skip2539
|
||||||
Ref: #skip2627
|
Ref: #skip2633
|
||||||
Node: date-format2799
|
Node: date-format2805
|
||||||
Ref: #date-format2926
|
Ref: #date-format2932
|
||||||
Node: field list3476
|
Node: field list3482
|
||||||
Ref: #field-list3613
|
Ref: #field-list3619
|
||||||
Node: field assignment4318
|
Node: field assignment4324
|
||||||
Ref: #field-assignment4473
|
Ref: #field-assignment4479
|
||||||
Node: conditional block4977
|
Node: conditional block4983
|
||||||
Ref: #conditional-block5131
|
Ref: #conditional-block5137
|
||||||
Node: include6027
|
Node: include6033
|
||||||
Ref: #include6157
|
Ref: #include6163
|
||||||
Node: newest-first6388
|
Node: newest-first6394
|
||||||
Ref: #newest-first6502
|
Ref: #newest-first6508
|
||||||
Node: CSV TIPS6913
|
Node: CSV TIPS6919
|
||||||
Ref: #csv-tips7007
|
Ref: #csv-tips7013
|
||||||
Node: CSV ordering7125
|
Node: CSV ordering7131
|
||||||
Ref: #csv-ordering7243
|
Ref: #csv-ordering7249
|
||||||
Node: CSV accounts7424
|
Node: CSV accounts7430
|
||||||
Ref: #csv-accounts7562
|
Ref: #csv-accounts7568
|
||||||
Node: CSV amounts7816
|
Node: CSV amounts7822
|
||||||
Ref: #csv-amounts7962
|
Ref: #csv-amounts7968
|
||||||
Node: CSV balance assertions8737
|
Node: CSV balance assertions8743
|
||||||
Ref: #csv-balance-assertions8919
|
Ref: #csv-balance-assertions8925
|
||||||
Node: Reading multiple CSV files9124
|
Node: Reading multiple CSV files9130
|
||||||
Ref: #reading-multiple-csv-files9294
|
Ref: #reading-multiple-csv-files9300
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -249,4 +249,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger 1.13 February 2019 hledger_csv(5)
|
hledger 1.13.99 February 2019 hledger_csv(5)
|
||||||
|
|||||||
@ -1,6 +1,6 @@
|
|||||||
.\"t
|
.\"t
|
||||||
|
|
||||||
.TH "hledger_journal" "5" "February 2019" "hledger 1.13" "hledger User Manuals"
|
.TH "hledger_journal" "5" "February 2019" "hledger 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -4,8 +4,8 @@ stdin.
|
|||||||
|
|
||||||
File: hledger_journal.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
File: hledger_journal.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
||||||
|
|
||||||
hledger_journal(5) hledger 1.13
|
hledger_journal(5) hledger 1.13.99
|
||||||
*******************************
|
**********************************
|
||||||
|
|
||||||
hledger's usual data source is a plain text file containing journal
|
hledger's usual data source is a plain text file containing journal
|
||||||
entries in hledger journal format. This file represents a standard
|
entries in hledger journal format. This file represents a standard
|
||||||
@ -1605,109 +1605,109 @@ Code
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top76
|
Node: Top76
|
||||||
Node: FILE FORMAT2372
|
Node: FILE FORMAT2378
|
||||||
Ref: #file-format2496
|
Ref: #file-format2502
|
||||||
Node: Transactions2783
|
Node: Transactions2789
|
||||||
Ref: #transactions2904
|
Ref: #transactions2910
|
||||||
Node: Postings3588
|
Node: Postings3594
|
||||||
Ref: #postings3715
|
Ref: #postings3721
|
||||||
Node: Dates4710
|
Node: Dates4716
|
||||||
Ref: #dates4825
|
Ref: #dates4831
|
||||||
Node: Simple dates4890
|
Node: Simple dates4896
|
||||||
Ref: #simple-dates5016
|
Ref: #simple-dates5022
|
||||||
Node: Secondary dates5382
|
Node: Secondary dates5388
|
||||||
Ref: #secondary-dates5536
|
Ref: #secondary-dates5542
|
||||||
Node: Posting dates7099
|
Node: Posting dates7105
|
||||||
Ref: #posting-dates7228
|
Ref: #posting-dates7234
|
||||||
Node: Status8602
|
Node: Status8608
|
||||||
Ref: #status8722
|
Ref: #status8728
|
||||||
Node: Description10430
|
Node: Description10436
|
||||||
Ref: #description10568
|
Ref: #description10574
|
||||||
Node: Payee and note10887
|
Node: Payee and note10893
|
||||||
Ref: #payee-and-note11001
|
Ref: #payee-and-note11007
|
||||||
Node: Account names11243
|
Node: Account names11249
|
||||||
Ref: #account-names11386
|
Ref: #account-names11392
|
||||||
Node: Amounts11873
|
Node: Amounts11879
|
||||||
Ref: #amounts12009
|
Ref: #amounts12015
|
||||||
Node: Virtual Postings15026
|
Node: Virtual Postings15032
|
||||||
Ref: #virtual-postings15185
|
Ref: #virtual-postings15191
|
||||||
Node: Balance Assertions16405
|
Node: Balance Assertions16411
|
||||||
Ref: #balance-assertions16580
|
Ref: #balance-assertions16586
|
||||||
Node: Assertions and ordering17531
|
Node: Assertions and ordering17537
|
||||||
Ref: #assertions-and-ordering17717
|
Ref: #assertions-and-ordering17723
|
||||||
Node: Assertions and included files18417
|
Node: Assertions and included files18423
|
||||||
Ref: #assertions-and-included-files18658
|
Ref: #assertions-and-included-files18664
|
||||||
Node: Assertions and multiple -f options18991
|
Node: Assertions and multiple -f options18997
|
||||||
Ref: #assertions-and-multiple--f-options19245
|
Ref: #assertions-and-multiple--f-options19251
|
||||||
Node: Assertions and commodities19377
|
Node: Assertions and commodities19383
|
||||||
Ref: #assertions-and-commodities19607
|
Ref: #assertions-and-commodities19613
|
||||||
Node: Assertions and prices20795
|
Node: Assertions and prices20801
|
||||||
Ref: #assertions-and-prices21007
|
Ref: #assertions-and-prices21013
|
||||||
Node: Assertions and subaccounts21447
|
Node: Assertions and subaccounts21453
|
||||||
Ref: #assertions-and-subaccounts21674
|
Ref: #assertions-and-subaccounts21680
|
||||||
Node: Assertions and virtual postings22195
|
Node: Assertions and virtual postings22201
|
||||||
Ref: #assertions-and-virtual-postings22435
|
Ref: #assertions-and-virtual-postings22441
|
||||||
Node: Assertions and precision22577
|
Node: Assertions and precision22583
|
||||||
Ref: #assertions-and-precision22768
|
Ref: #assertions-and-precision22774
|
||||||
Node: Balance Assignments23035
|
Node: Balance Assignments23041
|
||||||
Ref: #balance-assignments23216
|
Ref: #balance-assignments23222
|
||||||
Node: Balance assignments and prices24380
|
Node: Balance assignments and prices24386
|
||||||
Ref: #balance-assignments-and-prices24552
|
Ref: #balance-assignments-and-prices24558
|
||||||
Node: Transaction prices24776
|
Node: Transaction prices24782
|
||||||
Ref: #transaction-prices24945
|
Ref: #transaction-prices24951
|
||||||
Node: Comments27213
|
Node: Comments27219
|
||||||
Ref: #comments27347
|
Ref: #comments27353
|
||||||
Node: Tags28517
|
Node: Tags28523
|
||||||
Ref: #tags28635
|
Ref: #tags28641
|
||||||
Node: Directives30037
|
Node: Directives30043
|
||||||
Ref: #directives30180
|
Ref: #directives30186
|
||||||
Node: Comment blocks35787
|
Node: Comment blocks35793
|
||||||
Ref: #comment-blocks35932
|
Ref: #comment-blocks35938
|
||||||
Node: Including other files36108
|
Node: Including other files36114
|
||||||
Ref: #including-other-files36288
|
Ref: #including-other-files36294
|
||||||
Node: Default year36696
|
Node: Default year36702
|
||||||
Ref: #default-year36865
|
Ref: #default-year36871
|
||||||
Node: Declaring commodities37288
|
Node: Declaring commodities37294
|
||||||
Ref: #declaring-commodities37471
|
Ref: #declaring-commodities37477
|
||||||
Node: Default commodity38698
|
Node: Default commodity38704
|
||||||
Ref: #default-commodity38874
|
Ref: #default-commodity38880
|
||||||
Node: Market prices39510
|
Node: Market prices39516
|
||||||
Ref: #market-prices39675
|
Ref: #market-prices39681
|
||||||
Node: Declaring accounts40516
|
Node: Declaring accounts40522
|
||||||
Ref: #declaring-accounts40692
|
Ref: #declaring-accounts40698
|
||||||
Node: Account comments41617
|
Node: Account comments41623
|
||||||
Ref: #account-comments41780
|
Ref: #account-comments41786
|
||||||
Node: Account subdirectives42175
|
Node: Account subdirectives42181
|
||||||
Ref: #account-subdirectives42370
|
Ref: #account-subdirectives42376
|
||||||
Node: Account types42683
|
Node: Account types42689
|
||||||
Ref: #account-types42867
|
Ref: #account-types42873
|
||||||
Node: Account display order44511
|
Node: Account display order44517
|
||||||
Ref: #account-display-order44681
|
Ref: #account-display-order44687
|
||||||
Node: Rewriting accounts45810
|
Node: Rewriting accounts45816
|
||||||
Ref: #rewriting-accounts45995
|
Ref: #rewriting-accounts46001
|
||||||
Node: Basic aliases46729
|
Node: Basic aliases46735
|
||||||
Ref: #basic-aliases46875
|
Ref: #basic-aliases46881
|
||||||
Node: Regex aliases47579
|
Node: Regex aliases47585
|
||||||
Ref: #regex-aliases47750
|
Ref: #regex-aliases47756
|
||||||
Node: Multiple aliases48468
|
Node: Multiple aliases48474
|
||||||
Ref: #multiple-aliases48643
|
Ref: #multiple-aliases48649
|
||||||
Node: end aliases49141
|
Node: end aliases49147
|
||||||
Ref: #end-aliases49288
|
Ref: #end-aliases49294
|
||||||
Node: Default parent account49389
|
Node: Default parent account49395
|
||||||
Ref: #default-parent-account49555
|
Ref: #default-parent-account49561
|
||||||
Node: Periodic transactions50439
|
Node: Periodic transactions50445
|
||||||
Ref: #periodic-transactions50621
|
Ref: #periodic-transactions50627
|
||||||
Node: Two spaces after the period expression51746
|
Node: Two spaces after the period expression51752
|
||||||
Ref: #two-spaces-after-the-period-expression51991
|
Ref: #two-spaces-after-the-period-expression51997
|
||||||
Node: Forecasting with periodic transactions52476
|
Node: Forecasting with periodic transactions52482
|
||||||
Ref: #forecasting-with-periodic-transactions52766
|
Ref: #forecasting-with-periodic-transactions52772
|
||||||
Node: Budgeting with periodic transactions54453
|
Node: Budgeting with periodic transactions54459
|
||||||
Ref: #budgeting-with-periodic-transactions54692
|
Ref: #budgeting-with-periodic-transactions54698
|
||||||
Node: Transaction modifiers55151
|
Node: Transaction modifiers55157
|
||||||
Ref: #transaction-modifiers55314
|
Ref: #transaction-modifiers55320
|
||||||
Node: Auto postings and transaction balancing / inferred amounts / balance assertions57298
|
Node: Auto postings and transaction balancing / inferred amounts / balance assertions57304
|
||||||
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions57599
|
Ref: #auto-postings-and-transaction-balancing-inferred-amounts-balance-assertions57605
|
||||||
Node: EDITOR SUPPORT57977
|
Node: EDITOR SUPPORT57983
|
||||||
Ref: #editor-support58095
|
Ref: #editor-support58101
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -1322,4 +1322,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger 1.13 February 2019 hledger_journal(5)
|
hledger 1.13.99 February 2019 hledger_journal(5)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger_timeclock" "5" "February 2019" "hledger 1.13" "hledger User Manuals"
|
.TH "hledger_timeclock" "5" "February 2019" "hledger 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -4,8 +4,8 @@ stdin.
|
|||||||
|
|
||||||
File: hledger_timeclock.info, Node: Top, Up: (dir)
|
File: hledger_timeclock.info, Node: Top, Up: (dir)
|
||||||
|
|
||||||
hledger_timeclock(5) hledger 1.13
|
hledger_timeclock(5) hledger 1.13.99
|
||||||
*********************************
|
************************************
|
||||||
|
|
||||||
hledger can read timeclock files. As with Ledger, these are (a subset
|
hledger can read timeclock files. As with Ledger, these are (a subset
|
||||||
of) timeclock.el's format, containing clock-in and clock-out entries as
|
of) timeclock.el's format, containing clock-in and clock-out entries as
|
||||||
|
|||||||
@ -77,4 +77,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger 1.13 February 2019 hledger_timeclock(5)
|
hledger 1.13.99 February 2019 hledger_timeclock(5)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger_timedot" "5" "February 2019" "hledger 1.13" "hledger User Manuals"
|
.TH "hledger_timedot" "5" "February 2019" "hledger 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -4,8 +4,8 @@ stdin.
|
|||||||
|
|
||||||
File: hledger_timedot.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
File: hledger_timedot.info, Node: Top, Next: FILE FORMAT, Up: (dir)
|
||||||
|
|
||||||
hledger_timedot(5) hledger 1.13
|
hledger_timedot(5) hledger 1.13.99
|
||||||
*******************************
|
**********************************
|
||||||
|
|
||||||
Timedot is a plain text format for logging dated, categorised quantities
|
Timedot is a plain text format for logging dated, categorised quantities
|
||||||
(of time, usually), supported by hledger. It is convenient for
|
(of time, usually), supported by hledger. It is convenient for
|
||||||
@ -110,7 +110,7 @@ $ hledger -f t.timedot --alias /\\./=: bal date:2016/2/4
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top76
|
Node: Top76
|
||||||
Node: FILE FORMAT807
|
Node: FILE FORMAT813
|
||||||
Ref: #file-format908
|
Ref: #file-format914
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -124,4 +124,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger 1.13 February 2019 hledger_timedot(5)
|
hledger 1.13.99 February 2019 hledger_timedot(5)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger\-ui" "1" "February 2019" "hledger\-ui 1.13" "hledger User Manuals"
|
.TH "hledger\-ui" "1" "February 2019" "hledger\-ui 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -3,8 +3,8 @@ This is hledger-ui.info, produced by makeinfo version 6.5 from stdin.
|
|||||||
|
|
||||||
File: hledger-ui.info, Node: Top, Next: OPTIONS, Up: (dir)
|
File: hledger-ui.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||||
|
|
||||||
hledger-ui(1) hledger-ui 1.13
|
hledger-ui(1) hledger-ui 1.13.99
|
||||||
*****************************
|
********************************
|
||||||
|
|
||||||
hledger-ui is hledger's curses-style interface, providing an efficient
|
hledger-ui is hledger's curses-style interface, providing an efficient
|
||||||
full-window text UI for viewing accounts and transactions, and some
|
full-window text UI for viewing accounts and transactions, and some
|
||||||
@ -398,19 +398,19 @@ to cancel the reload attempt.)
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top71
|
Node: Top71
|
||||||
Node: OPTIONS1100
|
Node: OPTIONS1106
|
||||||
Ref: #options1197
|
Ref: #options1203
|
||||||
Node: KEYS4616
|
Node: KEYS4622
|
||||||
Ref: #keys4711
|
Ref: #keys4717
|
||||||
Node: SCREENS7967
|
Node: SCREENS7973
|
||||||
Ref: #screens8052
|
Ref: #screens8058
|
||||||
Node: Accounts screen8142
|
Node: Accounts screen8148
|
||||||
Ref: #accounts-screen8270
|
Ref: #accounts-screen8276
|
||||||
Node: Register screen10486
|
Node: Register screen10492
|
||||||
Ref: #register-screen10641
|
Ref: #register-screen10647
|
||||||
Node: Transaction screen12637
|
Node: Transaction screen12643
|
||||||
Ref: #transaction-screen12795
|
Ref: #transaction-screen12801
|
||||||
Node: Error screen13665
|
Node: Error screen13671
|
||||||
Ref: #error-screen13787
|
Ref: #error-screen13793
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -406,4 +406,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger-ui 1.13 February 2019 hledger-ui(1)
|
hledger-ui 1.13.99 February 2019 hledger-ui(1)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
|
|
||||||
.TH "hledger\-web" "1" "February 2019" "hledger\-web 1.13" "hledger User Manuals"
|
.TH "hledger\-web" "1" "February 2019" "hledger\-web 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -3,8 +3,8 @@ This is hledger-web.info, produced by makeinfo version 6.5 from stdin.
|
|||||||
|
|
||||||
File: hledger-web.info, Node: Top, Next: OPTIONS, Up: (dir)
|
File: hledger-web.info, Node: Top, Next: OPTIONS, Up: (dir)
|
||||||
|
|
||||||
hledger-web(1) hledger-web 1.13
|
hledger-web(1) hledger-web 1.13.99
|
||||||
*******************************
|
**********************************
|
||||||
|
|
||||||
hledger-web is hledger's web interface. It starts a simple web
|
hledger-web is hledger's web interface. It starts a simple web
|
||||||
application for browsing and adding transactions, and optionally opens
|
application for browsing and adding transactions, and optionally opens
|
||||||
@ -212,7 +212,7 @@ this, insert a '--' argument before.)
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top72
|
Node: Top72
|
||||||
Node: OPTIONS3154
|
Node: OPTIONS3160
|
||||||
Ref: #options3239
|
Ref: #options3245
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -87,20 +87,19 @@ web app detects changes made by other means and will show the new data
|
|||||||
on the next request. If a change makes the file unparseable,
|
on the next request. If a change makes the file unparseable,
|
||||||
hledger-web will show an error until the file has been fixed.
|
hledger-web will show an error until the file has been fixed.
|
||||||
|
|
||||||
---
|
<!--
|
||||||
# disabled
|
edit form
|
||||||
# edit form
|
Note: unlike any other hledger command, `web` can alter existing journal
|
||||||
# Note: unlike any other hledger command, `web` can alter existing journal
|
data, via the edit form. A numbered backup of the file is saved on
|
||||||
# data, via the edit form. A numbered backup of the file is saved on
|
each edit, normally (ie if file permissions allow, disk is not full, etc.)
|
||||||
# each edit, normally (ie if file permissions allow, disk is not full, etc.)
|
Also, there is no built-in access control. So unless you run it behind an
|
||||||
# Also, there is no built-in access control. So unless you run it behind an
|
authenticating proxy, any visitor to your server will be able to see and
|
||||||
# authenticating proxy, any visitor to your server will be able to see and
|
overwrite the journal file (and included files.)
|
||||||
# overwrite the journal file (and included files.)
|
hledger-web disallows edits which would leave the journal file not in
|
||||||
# hledger-web disallows edits which would leave the journal file not in
|
valid [journal format](#journal). If the file becomes unparseable
|
||||||
# valid [journal format](#journal). If the file becomes unparseable
|
by other means, hledger-web will show an error until the file has been
|
||||||
# by other means, hledger-web will show an error until the file has been
|
fixed.
|
||||||
# fixed.
|
-->
|
||||||
...
|
|
||||||
|
|
||||||
# OPTIONS
|
# OPTIONS
|
||||||
|
|
||||||
|
|||||||
@ -251,4 +251,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger-web 1.13 February 2019 hledger-web(1)
|
hledger-web 1.13.99 February 2019 hledger-web(1)
|
||||||
|
|||||||
@ -1,6 +1,6 @@
|
|||||||
.\"t
|
.\"t
|
||||||
|
|
||||||
.TH "hledger" "1" "February 2019" "hledger 1.13" "hledger User Manuals"
|
.TH "hledger" "1" "February 2019" "hledger 1.13.99" "hledger User Manuals"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@ -2659,6 +2659,18 @@ The \f[C]\-\-related\f[]/\f[C]\-r\f[] flag shows the \f[I]other\f[]
|
|||||||
postings in the transactions of the postings which would normally be
|
postings in the transactions of the postings which would normally be
|
||||||
shown.
|
shown.
|
||||||
.PP
|
.PP
|
||||||
|
The \f[C]\-\-invert\f[] flag negates all amounts.
|
||||||
|
For example, it can be used on an income account where amounts are
|
||||||
|
normally displayed as negative numbers.
|
||||||
|
It\[aq]s also useful to show postings on the checking account together
|
||||||
|
with the related account:
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
\f[C]
|
||||||
|
$\ hledger\ register\ \-\-related\ \-\-invert\ assets:checking
|
||||||
|
\f[]
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
With a reporting interval, register shows summary postings, one per
|
With a reporting interval, register shows summary postings, one per
|
||||||
interval, aggregating the postings to each account:
|
interval, aggregating the postings to each account:
|
||||||
.IP
|
.IP
|
||||||
|
|||||||
@ -3,8 +3,8 @@ This is hledger.info, produced by makeinfo version 6.5 from stdin.
|
|||||||
|
|
||||||
File: hledger.info, Node: Top, Next: EXAMPLES, Up: (dir)
|
File: hledger.info, Node: Top, Next: EXAMPLES, Up: (dir)
|
||||||
|
|
||||||
hledger(1) hledger 1.13
|
hledger(1) hledger 1.13.99
|
||||||
***********************
|
**************************
|
||||||
|
|
||||||
This is hledger's command-line interface (there are also curses and web
|
This is hledger's command-line interface (there are also curses and web
|
||||||
interfaces). Its basic function is to read a plain text file describing
|
interfaces). Its basic function is to read a plain text file describing
|
||||||
@ -2170,6 +2170,13 @@ just one account and one commodity.
|
|||||||
The '--related'/'-r' flag shows the _other_ postings in the
|
The '--related'/'-r' flag shows the _other_ postings in the
|
||||||
transactions of the postings which would normally be shown.
|
transactions of the postings which would normally be shown.
|
||||||
|
|
||||||
|
The '--invert' flag negates all amounts. For example, it can be used
|
||||||
|
on an income account where amounts are normally displayed as negative
|
||||||
|
numbers. It's also useful to show postings on the checking account
|
||||||
|
together with the related account:
|
||||||
|
|
||||||
|
$ hledger register --related --invert assets:checking
|
||||||
|
|
||||||
With a reporting interval, register shows summary postings, one per
|
With a reporting interval, register shows summary postings, one per
|
||||||
interval, aggregating the postings to each account:
|
interval, aggregating the postings to each account:
|
||||||
|
|
||||||
@ -2678,160 +2685,160 @@ hledger-check.hs checks more powerful account balance assertions.
|
|||||||
|
|
||||||
Tag Table:
|
Tag Table:
|
||||||
Node: Top68
|
Node: Top68
|
||||||
Node: EXAMPLES1884
|
Node: EXAMPLES1890
|
||||||
Ref: #examples1984
|
Ref: #examples1990
|
||||||
Node: OPTIONS3630
|
Node: OPTIONS3636
|
||||||
Ref: #options3732
|
Ref: #options3738
|
||||||
Node: General options4167
|
Node: General options4173
|
||||||
Ref: #general-options4292
|
Ref: #general-options4298
|
||||||
Node: Command options6974
|
Node: Command options6980
|
||||||
Ref: #command-options7125
|
Ref: #command-options7131
|
||||||
Node: Command arguments7523
|
Node: Command arguments7529
|
||||||
Ref: #command-arguments7677
|
Ref: #command-arguments7683
|
||||||
Node: Argument files7798
|
Node: Argument files7804
|
||||||
Ref: #argument-files7974
|
Ref: #argument-files7980
|
||||||
Node: Special characters in arguments and queries8240
|
Node: Special characters in arguments and queries8246
|
||||||
Ref: #special-characters-in-arguments-and-queries8474
|
Ref: #special-characters-in-arguments-and-queries8480
|
||||||
Node: More escaping8924
|
Node: More escaping8930
|
||||||
Ref: #more-escaping9086
|
Ref: #more-escaping9092
|
||||||
Node: Even more escaping9382
|
Node: Even more escaping9388
|
||||||
Ref: #even-more-escaping9576
|
Ref: #even-more-escaping9582
|
||||||
Node: Less escaping10247
|
Node: Less escaping10253
|
||||||
Ref: #less-escaping10409
|
Ref: #less-escaping10415
|
||||||
Node: Command line tips10654
|
Node: Command line tips10660
|
||||||
Ref: #command-line-tips10840
|
Ref: #command-line-tips10846
|
||||||
Node: Unicode characters11217
|
Node: Unicode characters11223
|
||||||
Ref: #unicode-characters11373
|
Ref: #unicode-characters11379
|
||||||
Node: Input files12098
|
Node: Input files12104
|
||||||
Ref: #input-files12234
|
Ref: #input-files12240
|
||||||
Node: Smart dates14204
|
Node: Smart dates14210
|
||||||
Ref: #smart-dates14345
|
Ref: #smart-dates14351
|
||||||
Node: Report start & end date15751
|
Node: Report start & end date15757
|
||||||
Ref: #report-start-end-date15923
|
Ref: #report-start-end-date15929
|
||||||
Node: Report intervals16989
|
Node: Report intervals16995
|
||||||
Ref: #report-intervals17154
|
Ref: #report-intervals17160
|
||||||
Node: Period expressions17555
|
Node: Period expressions17561
|
||||||
Ref: #period-expressions17715
|
Ref: #period-expressions17721
|
||||||
Node: Depth limiting21672
|
Node: Depth limiting21678
|
||||||
Ref: #depth-limiting21816
|
Ref: #depth-limiting21822
|
||||||
Node: Pivoting22158
|
Node: Pivoting22164
|
||||||
Ref: #pivoting22276
|
Ref: #pivoting22282
|
||||||
Node: Cost23952
|
Node: Cost23958
|
||||||
Ref: #cost24060
|
Ref: #cost24066
|
||||||
Node: Market value24178
|
Node: Market value24184
|
||||||
Ref: #market-value24313
|
Ref: #market-value24319
|
||||||
Node: Combining -B and -V25679
|
Node: Combining -B and -V25685
|
||||||
Ref: #combining--b-and--v25842
|
Ref: #combining--b-and--v25848
|
||||||
Node: Output destination25989
|
Node: Output destination25995
|
||||||
Ref: #output-destination26151
|
Ref: #output-destination26157
|
||||||
Node: Output format26434
|
Node: Output format26440
|
||||||
Ref: #output-format26586
|
Ref: #output-format26592
|
||||||
Node: Regular expressions26971
|
Node: Regular expressions26977
|
||||||
Ref: #regular-expressions27108
|
Ref: #regular-expressions27114
|
||||||
Node: QUERIES28469
|
Node: QUERIES28475
|
||||||
Ref: #queries28571
|
Ref: #queries28577
|
||||||
Node: COMMANDS32533
|
Node: COMMANDS32539
|
||||||
Ref: #commands32645
|
Ref: #commands32651
|
||||||
Node: accounts33645
|
Node: accounts33651
|
||||||
Ref: #accounts33743
|
Ref: #accounts33749
|
||||||
Node: activity34442
|
Node: activity34448
|
||||||
Ref: #activity34552
|
Ref: #activity34558
|
||||||
Node: add34935
|
Node: add34941
|
||||||
Ref: #add35034
|
Ref: #add35040
|
||||||
Node: balance37621
|
Node: balance37627
|
||||||
Ref: #balance37732
|
Ref: #balance37738
|
||||||
Node: Classic balance report39173
|
Node: Classic balance report39179
|
||||||
Ref: #classic-balance-report39346
|
Ref: #classic-balance-report39352
|
||||||
Node: Customising the classic balance report40715
|
Node: Customising the classic balance report40721
|
||||||
Ref: #customising-the-classic-balance-report40943
|
Ref: #customising-the-classic-balance-report40949
|
||||||
Node: Colour support43017
|
Node: Colour support43023
|
||||||
Ref: #colour-support43184
|
Ref: #colour-support43190
|
||||||
Node: Flat mode43357
|
Node: Flat mode43363
|
||||||
Ref: #flat-mode43505
|
Ref: #flat-mode43511
|
||||||
Node: Depth limited balance reports43918
|
Node: Depth limited balance reports43924
|
||||||
Ref: #depth-limited-balance-reports44118
|
Ref: #depth-limited-balance-reports44124
|
||||||
Node: Multicolumn balance report44574
|
Node: Multicolumn balance report44580
|
||||||
Ref: #multicolumn-balance-report44772
|
Ref: #multicolumn-balance-report44778
|
||||||
Node: Budget report50012
|
Node: Budget report50018
|
||||||
Ref: #budget-report50155
|
Ref: #budget-report50161
|
||||||
Node: Nested budgets54839
|
Node: Nested budgets54845
|
||||||
Ref: #nested-budgets54951
|
Ref: #nested-budgets54957
|
||||||
Ref: #output-format-158431
|
Ref: #output-format-158437
|
||||||
Node: balancesheet58509
|
Node: balancesheet58515
|
||||||
Ref: #balancesheet58645
|
Ref: #balancesheet58651
|
||||||
Node: balancesheetequity59879
|
Node: balancesheetequity59885
|
||||||
Ref: #balancesheetequity60028
|
Ref: #balancesheetequity60034
|
||||||
Node: cashflow60589
|
Node: cashflow60595
|
||||||
Ref: #cashflow60717
|
Ref: #cashflow60723
|
||||||
Node: check-dates61745
|
Node: check-dates61751
|
||||||
Ref: #check-dates61872
|
Ref: #check-dates61878
|
||||||
Node: check-dupes62151
|
Node: check-dupes62157
|
||||||
Ref: #check-dupes62275
|
Ref: #check-dupes62281
|
||||||
Node: close62568
|
Node: close62574
|
||||||
Ref: #close62676
|
Ref: #close62682
|
||||||
Node: files66089
|
Node: files66095
|
||||||
Ref: #files66190
|
Ref: #files66196
|
||||||
Node: help66337
|
Node: help66343
|
||||||
Ref: #help66437
|
Ref: #help66443
|
||||||
Node: import67530
|
Node: import67536
|
||||||
Ref: #import67644
|
Ref: #import67650
|
||||||
Node: incomestatement68388
|
Node: incomestatement68394
|
||||||
Ref: #incomestatement68522
|
Ref: #incomestatement68528
|
||||||
Node: prices69858
|
Node: prices69864
|
||||||
Ref: #prices69973
|
Ref: #prices69979
|
||||||
Node: print70252
|
Node: print70258
|
||||||
Ref: #print70362
|
Ref: #print70368
|
||||||
Node: print-unique74855
|
Node: print-unique74861
|
||||||
Ref: #print-unique74981
|
Ref: #print-unique74987
|
||||||
Node: register75266
|
Node: register75272
|
||||||
Ref: #register75393
|
Ref: #register75399
|
||||||
Node: Custom register output79262
|
Node: Custom register output79570
|
||||||
Ref: #custom-register-output79391
|
Ref: #custom-register-output79699
|
||||||
Node: register-match80653
|
Node: register-match80961
|
||||||
Ref: #register-match80787
|
Ref: #register-match81095
|
||||||
Node: rewrite81138
|
Node: rewrite81446
|
||||||
Ref: #rewrite81253
|
Ref: #rewrite81561
|
||||||
Node: Re-write rules in a file83102
|
Node: Re-write rules in a file83410
|
||||||
Ref: #re-write-rules-in-a-file83236
|
Ref: #re-write-rules-in-a-file83544
|
||||||
Node: Diff output format84446
|
Node: Diff output format84754
|
||||||
Ref: #diff-output-format84615
|
Ref: #diff-output-format84923
|
||||||
Node: rewrite vs print --auto85707
|
Node: rewrite vs print --auto86015
|
||||||
Ref: #rewrite-vs.-print---auto85886
|
Ref: #rewrite-vs.-print---auto86194
|
||||||
Node: roi86442
|
Node: roi86750
|
||||||
Ref: #roi86540
|
Ref: #roi86848
|
||||||
Node: stats87552
|
Node: stats87860
|
||||||
Ref: #stats87651
|
Ref: #stats87959
|
||||||
Node: tags88405
|
Node: tags88713
|
||||||
Ref: #tags88503
|
Ref: #tags88811
|
||||||
Node: test88733
|
Node: test89041
|
||||||
Ref: #test88817
|
Ref: #test89125
|
||||||
Node: ADD-ON COMMANDS89578
|
Node: ADD-ON COMMANDS89886
|
||||||
Ref: #add-on-commands89688
|
Ref: #add-on-commands89996
|
||||||
Node: Official add-ons90975
|
Node: Official add-ons91283
|
||||||
Ref: #official-add-ons91115
|
Ref: #official-add-ons91423
|
||||||
Node: api91202
|
Node: api91510
|
||||||
Ref: #api91291
|
Ref: #api91599
|
||||||
Node: ui91343
|
Node: ui91651
|
||||||
Ref: #ui91442
|
Ref: #ui91750
|
||||||
Node: web91500
|
Node: web91808
|
||||||
Ref: #web91589
|
Ref: #web91897
|
||||||
Node: Third party add-ons91635
|
Node: Third party add-ons91943
|
||||||
Ref: #third-party-add-ons91810
|
Ref: #third-party-add-ons92118
|
||||||
Node: diff91945
|
Node: diff92253
|
||||||
Ref: #diff92042
|
Ref: #diff92350
|
||||||
Node: iadd92141
|
Node: iadd92449
|
||||||
Ref: #iadd92255
|
Ref: #iadd92563
|
||||||
Node: interest92338
|
Node: interest92646
|
||||||
Ref: #interest92459
|
Ref: #interest92767
|
||||||
Node: irr92554
|
Node: irr92862
|
||||||
Ref: #irr92652
|
Ref: #irr92960
|
||||||
Node: Experimental add-ons92783
|
Node: Experimental add-ons93091
|
||||||
Ref: #experimental-add-ons92935
|
Ref: #experimental-add-ons93243
|
||||||
Node: autosync93215
|
Node: autosync93523
|
||||||
Ref: #autosync93326
|
Ref: #autosync93634
|
||||||
Node: chart93565
|
Node: chart93873
|
||||||
Ref: #chart93684
|
Ref: #chart93992
|
||||||
Node: check93755
|
Node: check94063
|
||||||
Ref: #check93857
|
Ref: #check94165
|
||||||
|
|
||||||
End Tag Table
|
End Tag Table
|
||||||
|
|||||||
@ -1935,14 +1935,21 @@ COMMANDS
|
|||||||
The --related/-r flag shows the other postings in the transactions of
|
The --related/-r flag shows the other postings in the transactions of
|
||||||
the postings which would normally be shown.
|
the postings which would normally be shown.
|
||||||
|
|
||||||
With a reporting interval, register shows summary postings, one per
|
The --invert flag negates all amounts. For example, it can be used on
|
||||||
|
an income account where amounts are normally displayed as negative num-
|
||||||
|
bers. It's also useful to show postings on the checking account
|
||||||
|
together with the related account:
|
||||||
|
|
||||||
|
$ hledger register --related --invert assets:checking
|
||||||
|
|
||||||
|
With a reporting interval, register shows summary postings, one per
|
||||||
interval, aggregating the postings to each account:
|
interval, aggregating the postings to each account:
|
||||||
|
|
||||||
$ hledger register --monthly income
|
$ hledger register --monthly income
|
||||||
2008/01 income:salary $-1 $-1
|
2008/01 income:salary $-1 $-1
|
||||||
2008/06 income:gifts $-1 $-2
|
2008/06 income:gifts $-1 $-2
|
||||||
|
|
||||||
Periods with no activity, and summary postings with a zero amount, are
|
Periods with no activity, and summary postings with a zero amount, are
|
||||||
not shown by default; use the --empty/-E flag to see them:
|
not shown by default; use the --empty/-E flag to see them:
|
||||||
|
|
||||||
$ hledger register --monthly income -E
|
$ hledger register --monthly income -E
|
||||||
@ -1959,7 +1966,7 @@ COMMANDS
|
|||||||
2008/11 0 $-2
|
2008/11 0 $-2
|
||||||
2008/12 0 $-2
|
2008/12 0 $-2
|
||||||
|
|
||||||
Often, you'll want to see just one line per interval. The --depth
|
Often, you'll want to see just one line per interval. The --depth
|
||||||
option helps with this, causing subaccounts to be aggregated:
|
option helps with this, causing subaccounts to be aggregated:
|
||||||
|
|
||||||
$ hledger register --monthly assets --depth 1h
|
$ hledger register --monthly assets --depth 1h
|
||||||
@ -1967,19 +1974,19 @@ COMMANDS
|
|||||||
2008/06 assets $-1 0
|
2008/06 assets $-1 0
|
||||||
2008/12 assets $-1 $-1
|
2008/12 assets $-1 $-1
|
||||||
|
|
||||||
Note when using report intervals, if you specify start/end dates these
|
Note when using report intervals, if you specify start/end dates these
|
||||||
will be adjusted outward if necessary to contain a whole number of
|
will be adjusted outward if necessary to contain a whole number of
|
||||||
intervals. This ensures that the first and last intervals are full
|
intervals. This ensures that the first and last intervals are full
|
||||||
length and comparable to the others in the report.
|
length and comparable to the others in the report.
|
||||||
|
|
||||||
Custom register output
|
Custom register output
|
||||||
register uses the full terminal width by default, except on windows.
|
register uses the full terminal width by default, except on windows.
|
||||||
You can override this by setting the COLUMNS environment variable (not
|
You can override this by setting the COLUMNS environment variable (not
|
||||||
a bash shell variable) or by using the --width/-w option.
|
a bash shell variable) or by using the --width/-w option.
|
||||||
|
|
||||||
The description and account columns normally share the space equally
|
The description and account columns normally share the space equally
|
||||||
(about half of (width - 40) each). You can adjust this by adding a
|
(about half of (width - 40) each). You can adjust this by adding a
|
||||||
description width as part of --width's argument, comma-separated:
|
description width as part of --width's argument, comma-separated:
|
||||||
--width W,D . Here's a diagram (won't display correctly in --help):
|
--width W,D . Here's a diagram (won't display correctly in --help):
|
||||||
|
|
||||||
<--------------------------------- width (W) ---------------------------------->
|
<--------------------------------- width (W) ---------------------------------->
|
||||||
@ -1995,27 +2002,27 @@ COMMANDS
|
|||||||
$ hledger reg -w 100,40 # set overall width 100, description width 40
|
$ hledger reg -w 100,40 # set overall width 100, description width 40
|
||||||
$ hledger reg -w $COLUMNS,40 # use terminal width, & description width 40
|
$ hledger reg -w $COLUMNS,40 # use terminal width, & description width 40
|
||||||
|
|
||||||
This command also supports output destination and output format selec-
|
This command also supports output destination and output format selec-
|
||||||
tion.
|
tion.
|
||||||
|
|
||||||
register-match
|
register-match
|
||||||
register-match
|
register-match
|
||||||
Print the one posting whose transaction description is closest to DESC,
|
Print the one posting whose transaction description is closest to DESC,
|
||||||
in the style of the register command. If there are multiple equally
|
in the style of the register command. If there are multiple equally
|
||||||
good matches, it shows the most recent. Query options (options, not
|
good matches, it shows the most recent. Query options (options, not
|
||||||
arguments) can be used to restrict the search space. Helps
|
arguments) can be used to restrict the search space. Helps
|
||||||
ledger-autosync detect already-seen transactions when importing.
|
ledger-autosync detect already-seen transactions when importing.
|
||||||
|
|
||||||
rewrite
|
rewrite
|
||||||
rewrite
|
rewrite
|
||||||
Print all transactions, rewriting the postings of matched transactions.
|
Print all transactions, rewriting the postings of matched transactions.
|
||||||
For now the only rewrite available is adding new postings, like print
|
For now the only rewrite available is adding new postings, like print
|
||||||
--auto.
|
--auto.
|
||||||
|
|
||||||
This is a start at a generic rewriter of transaction entries. It reads
|
This is a start at a generic rewriter of transaction entries. It reads
|
||||||
the default journal and prints the transactions, like print, but adds
|
the default journal and prints the transactions, like print, but adds
|
||||||
one or more specified postings to any transactions matching QUERY. The
|
one or more specified postings to any transactions matching QUERY. The
|
||||||
posting amounts can be fixed, or a multiplier of the existing transac-
|
posting amounts can be fixed, or a multiplier of the existing transac-
|
||||||
tion's first posting amount.
|
tion's first posting amount.
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
@ -2031,7 +2038,7 @@ COMMANDS
|
|||||||
(reserve:grocery) *0.25 ; reserve 25% for grocery
|
(reserve:grocery) *0.25 ; reserve 25% for grocery
|
||||||
(reserve:) *0.25 ; reserve 25% for grocery
|
(reserve:) *0.25 ; reserve 25% for grocery
|
||||||
|
|
||||||
Note the single quotes to protect the dollar sign from bash, and the
|
Note the single quotes to protect the dollar sign from bash, and the
|
||||||
two spaces between account and amount.
|
two spaces between account and amount.
|
||||||
|
|
||||||
More:
|
More:
|
||||||
@ -2041,16 +2048,16 @@ COMMANDS
|
|||||||
$ hledger rewrite -- expenses:gifts --add-posting '(budget:gifts) *-1"'
|
$ hledger rewrite -- expenses:gifts --add-posting '(budget:gifts) *-1"'
|
||||||
$ hledger rewrite -- ^income --add-posting '(budget:foreign currency) *0.25 JPY; diversify'
|
$ hledger rewrite -- ^income --add-posting '(budget:foreign currency) *0.25 JPY; diversify'
|
||||||
|
|
||||||
Argument for --add-posting option is a usual posting of transaction
|
Argument for --add-posting option is a usual posting of transaction
|
||||||
with an exception for amount specification. More precisely, you can
|
with an exception for amount specification. More precisely, you can
|
||||||
use '*' (star symbol) before the amount to indicate that that this is a
|
use '*' (star symbol) before the amount to indicate that that this is a
|
||||||
factor for an amount of original matched posting. If the amount
|
factor for an amount of original matched posting. If the amount
|
||||||
includes a commodity name, the new posting amount will be in the new
|
includes a commodity name, the new posting amount will be in the new
|
||||||
commodity; otherwise, it will be in the matched posting amount's com-
|
commodity; otherwise, it will be in the matched posting amount's com-
|
||||||
modity.
|
modity.
|
||||||
|
|
||||||
Re-write rules in a file
|
Re-write rules in a file
|
||||||
During the run this tool will execute so called "Automated Transac-
|
During the run this tool will execute so called "Automated Transac-
|
||||||
tions" found in any journal it process. I.e instead of specifying this
|
tions" found in any journal it process. I.e instead of specifying this
|
||||||
operations in command line you can put them in a journal file.
|
operations in command line you can put them in a journal file.
|
||||||
|
|
||||||
@ -2065,7 +2072,7 @@ COMMANDS
|
|||||||
budget:gifts *-1
|
budget:gifts *-1
|
||||||
assets:budget *1
|
assets:budget *1
|
||||||
|
|
||||||
Note that '=' (equality symbol) that is used instead of date in trans-
|
Note that '=' (equality symbol) that is used instead of date in trans-
|
||||||
actions you usually write. It indicates the query by which you want to
|
actions you usually write. It indicates the query by which you want to
|
||||||
match the posting to add new ones.
|
match the posting to add new ones.
|
||||||
|
|
||||||
@ -2078,12 +2085,12 @@ COMMANDS
|
|||||||
--add-posting 'assets:budget *1' \
|
--add-posting 'assets:budget *1' \
|
||||||
> rewritten-tidy-output.journal
|
> rewritten-tidy-output.journal
|
||||||
|
|
||||||
It is important to understand that relative order of such entries in
|
It is important to understand that relative order of such entries in
|
||||||
journal is important. You can re-use result of previously added post-
|
journal is important. You can re-use result of previously added post-
|
||||||
ings.
|
ings.
|
||||||
|
|
||||||
Diff output format
|
Diff output format
|
||||||
To use this tool for batch modification of your journal files you may
|
To use this tool for batch modification of your journal files you may
|
||||||
find useful output in form of unified diff.
|
find useful output in form of unified diff.
|
||||||
|
|
||||||
$ hledger rewrite -- --diff -f examples/sample.journal '^income' --add-posting '(liabilities:tax) *.33'
|
$ hledger rewrite -- --diff -f examples/sample.journal '^income' --add-posting '(liabilities:tax) *.33'
|
||||||
@ -2107,10 +2114,10 @@ COMMANDS
|
|||||||
|
|
||||||
If you'll pass this through patch tool you'll get transactions contain-
|
If you'll pass this through patch tool you'll get transactions contain-
|
||||||
ing the posting that matches your query be updated. Note that multiple
|
ing the posting that matches your query be updated. Note that multiple
|
||||||
files might be update according to list of input files specified via
|
files might be update according to list of input files specified via
|
||||||
--file options and include directives inside of these files.
|
--file options and include directives inside of these files.
|
||||||
|
|
||||||
Be careful. Whole transaction being re-formatted in a style of output
|
Be careful. Whole transaction being re-formatted in a style of output
|
||||||
from hledger print.
|
from hledger print.
|
||||||
|
|
||||||
See also:
|
See also:
|
||||||
@ -2118,48 +2125,48 @@ COMMANDS
|
|||||||
https://github.com/simonmichael/hledger/issues/99
|
https://github.com/simonmichael/hledger/issues/99
|
||||||
|
|
||||||
rewrite vs. print --auto
|
rewrite vs. print --auto
|
||||||
This command predates print --auto, and currently does much the same
|
This command predates print --auto, and currently does much the same
|
||||||
thing, but with these differences:
|
thing, but with these differences:
|
||||||
|
|
||||||
o with multiple files, rewrite lets rules in any file affect all other
|
o with multiple files, rewrite lets rules in any file affect all other
|
||||||
files. print --auto uses standard directive scoping; rules affect
|
files. print --auto uses standard directive scoping; rules affect
|
||||||
only child files.
|
only child files.
|
||||||
|
|
||||||
o rewrite's query limits which transactions can be rewritten; all are
|
o rewrite's query limits which transactions can be rewritten; all are
|
||||||
printed. print --auto's query limits which transactions are printed.
|
printed. print --auto's query limits which transactions are printed.
|
||||||
|
|
||||||
o rewrite applies rules specified on command line or in the journal.
|
o rewrite applies rules specified on command line or in the journal.
|
||||||
print --auto applies rules specified in the journal.
|
print --auto applies rules specified in the journal.
|
||||||
|
|
||||||
roi
|
roi
|
||||||
roi
|
roi
|
||||||
Shows the time-weighted (TWR) and money-weighted (IRR) rate of return
|
Shows the time-weighted (TWR) and money-weighted (IRR) rate of return
|
||||||
on your investments.
|
on your investments.
|
||||||
|
|
||||||
This command assumes that you have account(s) that hold nothing but
|
This command assumes that you have account(s) that hold nothing but
|
||||||
your investments and whenever you record current appraisal/valuation of
|
your investments and whenever you record current appraisal/valuation of
|
||||||
these investments you offset unrealized profit and loss into account(s)
|
these investments you offset unrealized profit and loss into account(s)
|
||||||
that, again, hold nothing but unrealized profit and loss.
|
that, again, hold nothing but unrealized profit and loss.
|
||||||
|
|
||||||
Any transactions affecting balance of investment account(s) and not
|
Any transactions affecting balance of investment account(s) and not
|
||||||
originating from unrealized profit and loss account(s) are assumed to
|
originating from unrealized profit and loss account(s) are assumed to
|
||||||
be your investments or withdrawals.
|
be your investments or withdrawals.
|
||||||
|
|
||||||
At a minimum, you need to supply a query (which could be just an
|
At a minimum, you need to supply a query (which could be just an
|
||||||
account name) to select your investments with --inv, and another query
|
account name) to select your investments with --inv, and another query
|
||||||
to identify your profit and loss transactions with --pnl.
|
to identify your profit and loss transactions with --pnl.
|
||||||
|
|
||||||
It will compute and display the internalized rate of return (IRR) and
|
It will compute and display the internalized rate of return (IRR) and
|
||||||
time-weighted rate of return (TWR) for your investments for the time
|
time-weighted rate of return (TWR) for your investments for the time
|
||||||
period requested. Both rates of return are annualized before display,
|
period requested. Both rates of return are annualized before display,
|
||||||
regardless of the length of reporting interval.
|
regardless of the length of reporting interval.
|
||||||
|
|
||||||
stats
|
stats
|
||||||
stats
|
stats
|
||||||
Show some journal statistics.
|
Show some journal statistics.
|
||||||
|
|
||||||
The stats command displays summary information for the whole journal,
|
The stats command displays summary information for the whole journal,
|
||||||
or a matched part of it. With a reporting interval, it shows a report
|
or a matched part of it. With a reporting interval, it shows a report
|
||||||
for each report period.
|
for each report period.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
@ -2176,60 +2183,60 @@ COMMANDS
|
|||||||
Accounts : 8 (depth 3)
|
Accounts : 8 (depth 3)
|
||||||
Commodities : 1 ($)
|
Commodities : 1 ($)
|
||||||
|
|
||||||
This command also supports output destination and output format selec-
|
This command also supports output destination and output format selec-
|
||||||
tion.
|
tion.
|
||||||
|
|
||||||
tags
|
tags
|
||||||
tags
|
tags
|
||||||
List all the tag names used in the journal. With a TAGREGEX argument,
|
List all the tag names used in the journal. With a TAGREGEX argument,
|
||||||
only tag names matching the regular expression (case insensitive) are
|
only tag names matching the regular expression (case insensitive) are
|
||||||
shown. With QUERY arguments, only transactions matching the query are
|
shown. With QUERY arguments, only transactions matching the query are
|
||||||
considered.
|
considered.
|
||||||
|
|
||||||
test
|
test
|
||||||
test
|
test
|
||||||
Run built-in unit tests.
|
Run built-in unit tests.
|
||||||
|
|
||||||
This command runs the unit tests built in to hledger-lib and hledger,
|
This command runs the unit tests built in to hledger-lib and hledger,
|
||||||
printing test names and results on stdout. If any test fails, the exit
|
printing test names and results on stdout. If any test fails, the exit
|
||||||
code will be non-zero.
|
code will be non-zero.
|
||||||
|
|
||||||
Test names include a group prefix. If a (exact, case sensitive) group
|
Test names include a group prefix. If a (exact, case sensitive) group
|
||||||
prefix, or a full test name is provided as the first argument, only
|
prefix, or a full test name is provided as the first argument, only
|
||||||
that group or test is run.
|
that group or test is run.
|
||||||
|
|
||||||
If a numeric second argument is provided, it will set the randomness
|
If a numeric second argument is provided, it will set the randomness
|
||||||
seed, for repeatable results from tests using randomness (currently
|
seed, for repeatable results from tests using randomness (currently
|
||||||
none of them).
|
none of them).
|
||||||
|
|
||||||
This is mainly used by developers, but it's nice to be able to san-
|
This is mainly used by developers, but it's nice to be able to san-
|
||||||
ity-check your installed hledger executable at any time. All tests are
|
ity-check your installed hledger executable at any time. All tests are
|
||||||
expected to pass - if you ever see otherwise, something has gone wrong,
|
expected to pass - if you ever see otherwise, something has gone wrong,
|
||||||
please report a bug!
|
please report a bug!
|
||||||
|
|
||||||
ADD-ON COMMANDS
|
ADD-ON COMMANDS
|
||||||
hledger also searches for external add-on commands, and will include
|
hledger also searches for external add-on commands, and will include
|
||||||
these in the commands list. These are programs or scripts in your PATH
|
these in the commands list. These are programs or scripts in your PATH
|
||||||
whose name starts with hledger- and ends with a recognised file exten-
|
whose name starts with hledger- and ends with a recognised file exten-
|
||||||
sion (currently: no extension, bat,com,exe, hs,lhs,pl,py,rb,rkt,sh).
|
sion (currently: no extension, bat,com,exe, hs,lhs,pl,py,rb,rkt,sh).
|
||||||
|
|
||||||
Add-ons can be invoked like any hledger command, but there are a few
|
Add-ons can be invoked like any hledger command, but there are a few
|
||||||
things to be aware of. Eg if the hledger-web add-on is installed,
|
things to be aware of. Eg if the hledger-web add-on is installed,
|
||||||
|
|
||||||
o hledger -h web shows hledger's help, while hledger web -h shows
|
o hledger -h web shows hledger's help, while hledger web -h shows
|
||||||
hledger-web's help.
|
hledger-web's help.
|
||||||
|
|
||||||
o Flags specific to the add-on must have a preceding -- to hide them
|
o Flags specific to the add-on must have a preceding -- to hide them
|
||||||
from hledger. So hledger web --serve --port 9000 will be rejected;
|
from hledger. So hledger web --serve --port 9000 will be rejected;
|
||||||
you must use hledger web -- --serve --port 9000.
|
you must use hledger web -- --serve --port 9000.
|
||||||
|
|
||||||
o You can always run add-ons directly if preferred:
|
o You can always run add-ons directly if preferred:
|
||||||
hledger-web --serve --port 9000.
|
hledger-web --serve --port 9000.
|
||||||
|
|
||||||
Add-ons are a relatively easy way to add local features or experiment
|
Add-ons are a relatively easy way to add local features or experiment
|
||||||
with new ideas. They can be written in any language, but haskell
|
with new ideas. They can be written in any language, but haskell
|
||||||
scripts have a big advantage: they can use the same hledger (and
|
scripts have a big advantage: they can use the same hledger (and
|
||||||
haskell) library functions that built-in commands do, for command-line
|
haskell) library functions that built-in commands do, for command-line
|
||||||
options, journal parsing, reporting, etc.
|
options, journal parsing, reporting, etc.
|
||||||
|
|
||||||
Here are some hledger add-ons available:
|
Here are some hledger add-ons available:
|
||||||
@ -2247,7 +2254,7 @@ ADD-ON COMMANDS
|
|||||||
hledger-web provides a simple web interface.
|
hledger-web provides a simple web interface.
|
||||||
|
|
||||||
Third party add-ons
|
Third party add-ons
|
||||||
These are maintained separately, and usually updated shortly after a
|
These are maintained separately, and usually updated shortly after a
|
||||||
hledger release.
|
hledger release.
|
||||||
|
|
||||||
diff
|
diff
|
||||||
@ -2255,7 +2262,7 @@ ADD-ON COMMANDS
|
|||||||
journal file and another.
|
journal file and another.
|
||||||
|
|
||||||
iadd
|
iadd
|
||||||
hledger-iadd is a curses-style, more interactive replacement for the
|
hledger-iadd is a curses-style, more interactive replacement for the
|
||||||
add command.
|
add command.
|
||||||
|
|
||||||
interest
|
interest
|
||||||
@ -2263,19 +2270,19 @@ ADD-ON COMMANDS
|
|||||||
ing to various schemes.
|
ing to various schemes.
|
||||||
|
|
||||||
irr
|
irr
|
||||||
hledger-irr calculates the internal rate of return of an investment
|
hledger-irr calculates the internal rate of return of an investment
|
||||||
account, but it's superseded now by the built-in roi command.
|
account, but it's superseded now by the built-in roi command.
|
||||||
|
|
||||||
Experimental add-ons
|
Experimental add-ons
|
||||||
These are available in source form in the hledger repo's bin/ direc-
|
These are available in source form in the hledger repo's bin/ direc-
|
||||||
tory; installing them is pretty easy. They may be less mature and doc-
|
tory; installing them is pretty easy. They may be less mature and doc-
|
||||||
umented than built-in commands. Reading and tweaking these is a good
|
umented than built-in commands. Reading and tweaking these is a good
|
||||||
way to start making your own!
|
way to start making your own!
|
||||||
|
|
||||||
autosync
|
autosync
|
||||||
hledger-autosync is a symbolic link for easily running ledger-autosync,
|
hledger-autosync is a symbolic link for easily running ledger-autosync,
|
||||||
if installed. ledger-autosync does deduplicating conversion of OFX
|
if installed. ledger-autosync does deduplicating conversion of OFX
|
||||||
data and some CSV formats, and can also download the data if your bank
|
data and some CSV formats, and can also download the data if your bank
|
||||||
offers OFX Direct Connect.
|
offers OFX Direct Connect.
|
||||||
|
|
||||||
chart
|
chart
|
||||||
@ -2285,21 +2292,21 @@ ADD-ON COMMANDS
|
|||||||
hledger-check.hs checks more powerful account balance assertions.
|
hledger-check.hs checks more powerful account balance assertions.
|
||||||
|
|
||||||
ENVIRONMENT
|
ENVIRONMENT
|
||||||
COLUMNS The screen width used by the register command. Default: the
|
COLUMNS The screen width used by the register command. Default: the
|
||||||
full terminal width.
|
full terminal width.
|
||||||
|
|
||||||
LEDGER_FILE The journal file path when not specified with -f. Default:
|
LEDGER_FILE The journal file path when not specified with -f. Default:
|
||||||
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
|
~/.hledger.journal (on windows, perhaps C:/Users/USER/.hledger.jour-
|
||||||
nal).
|
nal).
|
||||||
|
|
||||||
FILES
|
FILES
|
||||||
Reads data from one or more files in hledger journal, timeclock, time-
|
Reads data from one or more files in hledger journal, timeclock, time-
|
||||||
dot, or CSV format specified with -f, or $LEDGER_FILE, or
|
dot, or CSV format specified with -f, or $LEDGER_FILE, or
|
||||||
$HOME/.hledger.journal (on windows, perhaps
|
$HOME/.hledger.journal (on windows, perhaps
|
||||||
C:/Users/USER/.hledger.journal).
|
C:/Users/USER/.hledger.journal).
|
||||||
|
|
||||||
BUGS
|
BUGS
|
||||||
The need to precede addon command options with -- when invoked from
|
The need to precede addon command options with -- when invoked from
|
||||||
hledger is awkward.
|
hledger is awkward.
|
||||||
|
|
||||||
When input data contains non-ascii characters, a suitable system locale
|
When input data contains non-ascii characters, a suitable system locale
|
||||||
@ -2312,33 +2319,33 @@ BUGS
|
|||||||
In a Cygwin/MSYS/Mintty window, the tab key is not supported in hledger
|
In a Cygwin/MSYS/Mintty window, the tab key is not supported in hledger
|
||||||
add.
|
add.
|
||||||
|
|
||||||
Not all of Ledger's journal file syntax is supported. See file format
|
Not all of Ledger's journal file syntax is supported. See file format
|
||||||
differences.
|
differences.
|
||||||
|
|
||||||
On large data files, hledger is slower and uses more memory than
|
On large data files, hledger is slower and uses more memory than
|
||||||
Ledger.
|
Ledger.
|
||||||
|
|
||||||
TROUBLESHOOTING
|
TROUBLESHOOTING
|
||||||
Here are some issues you might encounter when you run hledger (and
|
Here are some issues you might encounter when you run hledger (and
|
||||||
remember you can also seek help from the IRC channel, mail list or bug
|
remember you can also seek help from the IRC channel, mail list or bug
|
||||||
tracker):
|
tracker):
|
||||||
|
|
||||||
Successfully installed, but "No command 'hledger' found"
|
Successfully installed, but "No command 'hledger' found"
|
||||||
stack and cabal install binaries into a special directory, which should
|
stack and cabal install binaries into a special directory, which should
|
||||||
be added to your PATH environment variable. Eg on unix-like systems,
|
be added to your PATH environment variable. Eg on unix-like systems,
|
||||||
that is ~/.local/bin and ~/.cabal/bin respectively.
|
that is ~/.local/bin and ~/.cabal/bin respectively.
|
||||||
|
|
||||||
I set a custom LEDGER_FILE, but hledger is still using the default file
|
I set a custom LEDGER_FILE, but hledger is still using the default file
|
||||||
LEDGER_FILE should be a real environment variable, not just a shell
|
LEDGER_FILE should be a real environment variable, not just a shell
|
||||||
variable. The command env | grep LEDGER_FILE should show it. You may
|
variable. The command env | grep LEDGER_FILE should show it. You may
|
||||||
need to use export. Here's an explanation.
|
need to use export. Here's an explanation.
|
||||||
|
|
||||||
"Illegal byte sequence" or "Invalid or incomplete multibyte or wide
|
"Illegal byte sequence" or "Invalid or incomplete multibyte or wide
|
||||||
character" errors
|
character" errors
|
||||||
In order to handle non-ascii letters and symbols (like ), hledger needs
|
In order to handle non-ascii letters and symbols (like ), hledger needs
|
||||||
an appropriate locale. This is usually configured system-wide; you can
|
an appropriate locale. This is usually configured system-wide; you can
|
||||||
also configure it temporarily. The locale may need to be one that sup-
|
also configure it temporarily. The locale may need to be one that sup-
|
||||||
ports UTF-8, if you built hledger with GHC < 7.2 (or possibly always,
|
ports UTF-8, if you built hledger with GHC < 7.2 (or possibly always,
|
||||||
I'm not sure yet).
|
I'm not sure yet).
|
||||||
|
|
||||||
Here's an example of setting the locale temporarily, on ubuntu
|
Here's an example of setting the locale temporarily, on ubuntu
|
||||||
@ -2357,7 +2364,7 @@ TROUBLESHOOTING
|
|||||||
$ echo "export LANG=en_US.UTF-8" >>~/.bash_profile
|
$ echo "export LANG=en_US.UTF-8" >>~/.bash_profile
|
||||||
$ bash --login
|
$ bash --login
|
||||||
|
|
||||||
If we preferred to use eg fr_FR.utf8, we might have to install that
|
If we preferred to use eg fr_FR.utf8, we might have to install that
|
||||||
first:
|
first:
|
||||||
|
|
||||||
$ apt-get install language-pack-fr
|
$ apt-get install language-pack-fr
|
||||||
@ -2378,7 +2385,7 @@ TROUBLESHOOTING
|
|||||||
|
|
||||||
|
|
||||||
REPORTING BUGS
|
REPORTING BUGS
|
||||||
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
Report bugs at http://bugs.hledger.org (or on the #hledger IRC channel
|
||||||
or hledger mail list)
|
or hledger mail list)
|
||||||
|
|
||||||
|
|
||||||
@ -2392,7 +2399,7 @@ COPYRIGHT
|
|||||||
|
|
||||||
|
|
||||||
SEE ALSO
|
SEE ALSO
|
||||||
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
hledger(1), hledger-ui(1), hledger-web(1), hledger-api(1),
|
||||||
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
|
hledger_csv(5), hledger_journal(5), hledger_timeclock(5), hledger_time-
|
||||||
dot(5), ledger(1)
|
dot(5), ledger(1)
|
||||||
|
|
||||||
@ -2400,4 +2407,4 @@ SEE ALSO
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
hledger 1.13 February 2019 hledger(1)
|
hledger 1.13.99 February 2019 hledger(1)
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user