;update manuals
This commit is contained in:
		
							parent
							
								
									7cf7bcbf96
								
							
						
					
					
						commit
						895783ebe0
					
				| @ -75,7 +75,12 @@ T} | ||||
| T{ | ||||
| \f[B]\f[CB]date-format\f[B]\f[R] | ||||
| T}@T{ | ||||
| describe the format of CSV dates | ||||
| how to parse dates in CSV records | ||||
| T} | ||||
| T{ | ||||
| \f[B]\f[CB]decimal-mark\f[B]\f[R] | ||||
| T}@T{ | ||||
| the decimal mark used in CSV amounts, if ambiguous | ||||
| T} | ||||
| T{ | ||||
| \f[B]\f[CB]newest-first\f[B]\f[R] | ||||
| @ -866,6 +871,27 @@ For the supported strptime syntax, see: | ||||
| .P | ||||
| .PD | ||||
| https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime | ||||
| .SS \f[C]decimal-mark\f[R] | ||||
| .IP | ||||
| .nf | ||||
| \f[C] | ||||
| decimal-mark . | ||||
| \f[R] | ||||
| .fi | ||||
| .PP | ||||
| or: | ||||
| .IP | ||||
| .nf | ||||
| \f[C] | ||||
| decimal-mark , | ||||
| \f[R] | ||||
| .fi | ||||
| .PP | ||||
| hledger automatically accepts either period or comma as a decimal mark | ||||
| when parsing numbers (cf Amounts). | ||||
| However if any numbers in the CSV contain digit group marks, such as | ||||
| thousand-separating commas, you should declare the decimal mark | ||||
| explicitly with this rule, to avoid misparsed numbers. | ||||
| .SS \f[C]newest-first\f[R] | ||||
| .PP | ||||
| hledger always sorts the generated transactions by date. | ||||
|  | ||||
| @ -42,7 +42,9 @@ after the examples: | ||||
| *'if' table*                    apply some rules to CSV records matched | ||||
|                                 by patterns, alternate syntax | ||||
| *'end'*                         skip the remaining CSV records | ||||
| *'date-format'*                 describe the format of CSV dates | ||||
| *'date-format'*                 how to parse dates in CSV records | ||||
| *'decimal-mark'*                the decimal mark used in CSV amounts, | ||||
|                                 if ambiguous | ||||
| *'newest-first'*                disambiguate record order when there's | ||||
|                                 only one date | ||||
| *'include'*                     inline another CSV rules file | ||||
| @ -387,6 +389,7 @@ Blank lines and lines beginning with '#' or ';' are ignored. | ||||
| * if table:: | ||||
| * end:: | ||||
| * date-format:: | ||||
| * decimal-mark:: | ||||
| * newest-first:: | ||||
| * include:: | ||||
| * balance-type:: | ||||
| @ -787,7 +790,7 @@ if ,,,, | ||||
|  end | ||||
| 
 | ||||
|  | ||||
| File: hledger_csv.info,  Node: date-format,  Next: newest-first,  Prev: end,  Up: CSV RULES | ||||
| File: hledger_csv.info,  Node: date-format,  Next: decimal-mark,  Prev: end,  Up: CSV RULES | ||||
| 
 | ||||
| 2.8 'date-format' | ||||
| ================= | ||||
| @ -818,11 +821,29 @@ date-format %-m/%-d/%Y %l:%M %p some other junk | ||||
| https://hackage.haskell.org/package/time/docs/Data-Time-Format.html#v:formatTime | ||||
| 
 | ||||
|  | ||||
| File: hledger_csv.info,  Node: newest-first,  Next: include,  Prev: date-format,  Up: CSV RULES | ||||
| File: hledger_csv.info,  Node: decimal-mark,  Next: newest-first,  Prev: date-format,  Up: CSV RULES | ||||
| 
 | ||||
| 2.9 'newest-first' | ||||
| 2.9 'decimal-mark' | ||||
| ================== | ||||
| 
 | ||||
| decimal-mark . | ||||
| 
 | ||||
|    or: | ||||
| 
 | ||||
| decimal-mark , | ||||
| 
 | ||||
|    hledger automatically accepts either period or comma as a decimal | ||||
| mark when parsing numbers (cf Amounts).  However if any numbers in the | ||||
| CSV contain digit group marks, such as thousand-separating commas, you | ||||
| should declare the decimal mark explicitly with this rule, to avoid | ||||
| misparsed numbers. | ||||
| 
 | ||||
|  | ||||
| File: hledger_csv.info,  Node: newest-first,  Next: include,  Prev: decimal-mark,  Up: CSV RULES | ||||
| 
 | ||||
| 2.10 'newest-first' | ||||
| =================== | ||||
| 
 | ||||
| hledger always sorts the generated transactions by date.  Transactions | ||||
| on the same date should appear in the same order as their CSV records, | ||||
| as hledger can usually auto-detect whether the CSV's normal order is | ||||
| @ -842,7 +863,7 @@ newest-first | ||||
|  | ||||
| File: hledger_csv.info,  Node: include,  Next: balance-type,  Prev: newest-first,  Up: CSV RULES | ||||
| 
 | ||||
| 2.10 'include' | ||||
| 2.11 'include' | ||||
| ============== | ||||
| 
 | ||||
| include RULESFILE | ||||
| @ -865,7 +886,7 @@ include categorisation.rules | ||||
|  | ||||
| File: hledger_csv.info,  Node: balance-type,  Prev: include,  Up: CSV RULES | ||||
| 
 | ||||
| 2.11 'balance-type' | ||||
| 2.12 'balance-type' | ||||
| =================== | ||||
| 
 | ||||
| Balance assertions generated by assigning to balanceN are of the simple | ||||
| @ -1171,84 +1192,86 @@ command the user specified. | ||||
|  | ||||
| Tag Table: | ||||
| Node: Top72 | ||||
| Node: EXAMPLES2677 | ||||
| Ref: #examples2783 | ||||
| Node: Basic2991 | ||||
| Ref: #basic3091 | ||||
| Node: Bank of Ireland3633 | ||||
| Ref: #bank-of-ireland3768 | ||||
| Node: Amazon5230 | ||||
| Ref: #amazon5348 | ||||
| Node: Paypal7067 | ||||
| Ref: #paypal7161 | ||||
| Node: CSV RULES14805 | ||||
| Ref: #csv-rules14914 | ||||
| Node: skip15209 | ||||
| Ref: #skip15302 | ||||
| Node: fields15677 | ||||
| Ref: #fields15799 | ||||
| Node: Transaction field names16964 | ||||
| Ref: #transaction-field-names17124 | ||||
| Node: Posting field names17235 | ||||
| Ref: #posting-field-names17387 | ||||
| Node: account17457 | ||||
| Ref: #account17573 | ||||
| Node: amount18110 | ||||
| Ref: #amount18241 | ||||
| Node: currency19348 | ||||
| Ref: #currency19483 | ||||
| Node: balance19689 | ||||
| Ref: #balance19823 | ||||
| Node: comment20140 | ||||
| Ref: #comment20257 | ||||
| Node: field assignment20420 | ||||
| Ref: #field-assignment20563 | ||||
| Node: separator21381 | ||||
| Ref: #separator21516 | ||||
| Node: if block22056 | ||||
| Ref: #if-block22181 | ||||
| Node: Matching the whole record22582 | ||||
| Ref: #matching-the-whole-record22757 | ||||
| Node: Matching individual fields23561 | ||||
| Ref: #matching-individual-fields23765 | ||||
| Node: Combining matchers23989 | ||||
| Ref: #combining-matchers24185 | ||||
| Node: Rules applied on successful match24498 | ||||
| Ref: #rules-applied-on-successful-match24689 | ||||
| Node: if table25343 | ||||
| Ref: #if-table25462 | ||||
| Node: end27200 | ||||
| Ref: #end27312 | ||||
| Node: date-format27536 | ||||
| Ref: #date-format27668 | ||||
| Node: newest-first28417 | ||||
| Ref: #newest-first28555 | ||||
| Node: include29238 | ||||
| Ref: #include29369 | ||||
| Node: balance-type29813 | ||||
| Ref: #balance-type29933 | ||||
| Node: TIPS30633 | ||||
| Ref: #tips30715 | ||||
| Node: Rapid feedback30971 | ||||
| Ref: #rapid-feedback31088 | ||||
| Node: Valid CSV31548 | ||||
| Ref: #valid-csv31678 | ||||
| Node: File Extension31870 | ||||
| Ref: #file-extension32022 | ||||
| Node: Reading multiple CSV files32451 | ||||
| Ref: #reading-multiple-csv-files32636 | ||||
| Node: Valid transactions32877 | ||||
| Ref: #valid-transactions33055 | ||||
| Node: Deduplicating importing33683 | ||||
| Ref: #deduplicating-importing33862 | ||||
| Node: Setting amounts34895 | ||||
| Ref: #setting-amounts35064 | ||||
| Node: Setting currency/commodity36051 | ||||
| Ref: #setting-currencycommodity36243 | ||||
| Node: Referencing other fields37417 | ||||
| Ref: #referencing-other-fields37617 | ||||
| Node: How CSV rules are evaluated38514 | ||||
| Ref: #how-csv-rules-are-evaluated38687 | ||||
| Node: EXAMPLES2793 | ||||
| Ref: #examples2899 | ||||
| Node: Basic3107 | ||||
| Ref: #basic3207 | ||||
| Node: Bank of Ireland3749 | ||||
| Ref: #bank-of-ireland3884 | ||||
| Node: Amazon5346 | ||||
| Ref: #amazon5464 | ||||
| Node: Paypal7183 | ||||
| Ref: #paypal7277 | ||||
| Node: CSV RULES14921 | ||||
| Ref: #csv-rules15030 | ||||
| Node: skip15342 | ||||
| Ref: #skip15435 | ||||
| Node: fields15810 | ||||
| Ref: #fields15932 | ||||
| Node: Transaction field names17097 | ||||
| Ref: #transaction-field-names17257 | ||||
| Node: Posting field names17368 | ||||
| Ref: #posting-field-names17520 | ||||
| Node: account17590 | ||||
| Ref: #account17706 | ||||
| Node: amount18243 | ||||
| Ref: #amount18374 | ||||
| Node: currency19481 | ||||
| Ref: #currency19616 | ||||
| Node: balance19822 | ||||
| Ref: #balance19956 | ||||
| Node: comment20273 | ||||
| Ref: #comment20390 | ||||
| Node: field assignment20553 | ||||
| Ref: #field-assignment20696 | ||||
| Node: separator21514 | ||||
| Ref: #separator21649 | ||||
| Node: if block22189 | ||||
| Ref: #if-block22314 | ||||
| Node: Matching the whole record22715 | ||||
| Ref: #matching-the-whole-record22890 | ||||
| Node: Matching individual fields23694 | ||||
| Ref: #matching-individual-fields23898 | ||||
| Node: Combining matchers24122 | ||||
| Ref: #combining-matchers24318 | ||||
| Node: Rules applied on successful match24631 | ||||
| Ref: #rules-applied-on-successful-match24822 | ||||
| Node: if table25476 | ||||
| Ref: #if-table25595 | ||||
| Node: end27333 | ||||
| Ref: #end27445 | ||||
| Node: date-format27669 | ||||
| Ref: #date-format27801 | ||||
| Node: decimal-mark28550 | ||||
| Ref: #decimal-mark28693 | ||||
| Node: newest-first29032 | ||||
| Ref: #newest-first29173 | ||||
| Node: include29856 | ||||
| Ref: #include29987 | ||||
| Node: balance-type30431 | ||||
| Ref: #balance-type30551 | ||||
| Node: TIPS31251 | ||||
| Ref: #tips31333 | ||||
| Node: Rapid feedback31589 | ||||
| Ref: #rapid-feedback31706 | ||||
| Node: Valid CSV32166 | ||||
| Ref: #valid-csv32296 | ||||
| Node: File Extension32488 | ||||
| Ref: #file-extension32640 | ||||
| Node: Reading multiple CSV files33069 | ||||
| Ref: #reading-multiple-csv-files33254 | ||||
| Node: Valid transactions33495 | ||||
| Ref: #valid-transactions33673 | ||||
| Node: Deduplicating importing34301 | ||||
| Ref: #deduplicating-importing34480 | ||||
| Node: Setting amounts35513 | ||||
| Ref: #setting-amounts35682 | ||||
| Node: Setting currency/commodity36669 | ||||
| Ref: #setting-currencycommodity36861 | ||||
| Node: Referencing other fields38035 | ||||
| Ref: #referencing-other-fields38235 | ||||
| Node: How CSV rules are evaluated39132 | ||||
| Ref: #how-csv-rules-are-evaluated39305 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -39,7 +39,9 @@ DESCRIPTION | ||||
|        if table                         apply  some rules to CSV records matched | ||||
|                                         by patterns, alternate syntax | ||||
|        end                              skip the remaining CSV records | ||||
|        date-format                      describe the format of CSV dates | ||||
|        date-format                      how to parse dates in CSV records | ||||
|        decimal-mark                     the decimal mark used in CSV amounts, if | ||||
|                                         ambiguous | ||||
|        newest-first                     disambiguate  record  order when there's | ||||
|                                         only one date | ||||
|        include                          inline another CSV rules file | ||||
| @ -640,6 +642,19 @@ CSV RULES | ||||
|        https://hackage.haskell.org/package/time/docs/Data-Time-For- | ||||
|        mat.html#v:formatTime | ||||
| 
 | ||||
|    decimal-mark | ||||
|               decimal-mark . | ||||
| 
 | ||||
|        or: | ||||
| 
 | ||||
|               decimal-mark , | ||||
| 
 | ||||
|        hledger  automatically accepts either period or comma as a decimal mark | ||||
|        when parsing numbers (cf Amounts).  However if any numbers in  the  CSV | ||||
|        contain  digit  group  marks,  such  as thousand-separating commas, you | ||||
|        should declare the decimal mark explicitly with  this  rule,  to  avoid | ||||
|        misparsed numbers. | ||||
| 
 | ||||
|    newest-first | ||||
|        hledger  always sorts the generated transactions by date.  Transactions | ||||
|        on the same date should appear in the same order as their CSV  records, | ||||
|  | ||||
| @ -1588,10 +1588,12 @@ T} | ||||
| If you want intervals that start on arbitrary day of your choosing and | ||||
| span a week, month or year, you need to use any of the following: | ||||
| .PP | ||||
| \f[C]every Nth day of week\f[R], \f[C]every <weekday>\f[R], | ||||
| \f[C]every Nth day of week\f[R], \f[C]every WEEKDAYNAME\f[R] (eg | ||||
| \f[C]mon|tue|wed|thu|fri|sat|sun\f[R]), | ||||
| \f[C]every Nth day [of month]\f[R], | ||||
| \f[C]every Nth weekday [of month]\f[R], \f[C]every MM/DD [of year]\f[R], | ||||
| \f[C]every Nth MMM [of year]\f[R], \f[C]every MMM Nth [of year]\f[R]. | ||||
| \f[C]every Nth WEEKDAYNAME [of month]\f[R], | ||||
| \f[C]every MM/DD [of year]\f[R], \f[C]every Nth MMM [of year]\f[R], | ||||
| \f[C]every MMM Nth [of year]\f[R]. | ||||
| .PP | ||||
| Examples: | ||||
| .PP | ||||
| @ -2113,7 +2115,7 @@ Related: #329, #1083. | ||||
| .PP | ||||
| .TS | ||||
| tab(@); | ||||
| lw(11.7n) lw(11.2n) lw(11.9n) lw(13.1n) lw(12.4n) lw(9.8n). | ||||
| lw(7.4n) lw(11.7n) lw(19.6n) lw(6.8n) lw(19.6n) lw(5.0n). | ||||
| T{ | ||||
| Report type | ||||
| T}@T{ | ||||
| @ -2258,15 +2260,35 @@ T}@T{ | ||||
| value at DATE/today of sums of postings | ||||
| T} | ||||
| T{ | ||||
| balances (with report interval) | ||||
| balances changes (with report interval) | ||||
| T}@T{ | ||||
| sums of costs | ||||
| sums of costs of postings in interval | ||||
| T}@T{ | ||||
| value at period ends of sums of postings | ||||
| value at period ends of sums of postings before period end minus value | ||||
| at period starts of sums of all postings before period start | ||||
| T}@T{ | ||||
| not supported | ||||
| T}@T{ | ||||
| value at period ends of sums of postings | ||||
| value at period ends of sums of postings before period end minus value | ||||
| at period starts of sums of all postings before period start | ||||
| T}@T{ | ||||
| value at DATE/today of sums of postings | ||||
| T} | ||||
| T{ | ||||
| end balances (with report interval and --cumulative or -H) | ||||
| T}@T{ | ||||
| sums of costs of postings from report start (or before report start with | ||||
| -H) and interval end | ||||
| T}@T{ | ||||
| value at period ends of sums of all postings before period end (minus | ||||
| value at report start of of sums of all postings before report start | ||||
| with --cumulative) | ||||
| T}@T{ | ||||
| not supported | ||||
| T}@T{ | ||||
| value at period ends of sums of all postings before period end (minus | ||||
| value at report start of of sums of all postings before report start | ||||
| with --cumulative) | ||||
| T}@T{ | ||||
| value at DATE/today of sums of postings | ||||
| T} | ||||
| @ -2275,11 +2297,11 @@ starting balances (with report interval and -H) | ||||
| T}@T{ | ||||
| sums of costs of postings before report start | ||||
| T}@T{ | ||||
| sums of postings before report start | ||||
| value at report start of sums of all postings before report start | ||||
| T}@T{ | ||||
| not supported | ||||
| T}@T{ | ||||
| sums of postings before report start | ||||
| value at report start of sums of all postings before report start | ||||
| T}@T{ | ||||
| sums of postings before report start | ||||
| T} | ||||
|  | ||||
| @ -1305,9 +1305,10 @@ end on the last one, as described above. | ||||
|    If you want intervals that start on arbitrary day of your choosing | ||||
| and span a week, month or year, you need to use any of the following: | ||||
| 
 | ||||
|    'every Nth day of week', 'every <weekday>', 'every Nth day [of | ||||
| month]', 'every Nth weekday [of month]', 'every MM/DD [of year]', 'every | ||||
| Nth MMM [of year]', 'every MMM Nth [of year]'. | ||||
|    'every Nth day of week', 'every WEEKDAYNAME' (eg | ||||
| 'mon|tue|wed|thu|fri|sat|sun'), 'every Nth day [of month]', 'every Nth | ||||
| WEEKDAYNAME [of month]', 'every MM/DD [of year]', 'every Nth MMM [of | ||||
| year]', 'every MMM Nth [of year]'. | ||||
| 
 | ||||
|    Examples: | ||||
| 
 | ||||
| @ -1785,75 +1786,102 @@ sideways.)  It may be useful when troubleshooting.  If you find | ||||
| problems, please report them, ideally with a reproducible example. | ||||
| Related: #329, #1083. | ||||
| 
 | ||||
| Report       '-B',        '-V', '-X'   '--value=then' '--value=end' '--value=DATE', | ||||
| Report   '-B',        '-V', '-X'           '--value=then''--value=end'  '--value=DATE', | ||||
| type     '--value=cost'                                                 '--value=now' | ||||
| ------------------------------------------------------------------------------- | ||||
| ------------------------------------------------------------------------------ | ||||
| *print* | ||||
| posting      cost         value at     value at       value at      value at | ||||
| amounts                   report end   posting date   report or     DATE/today | ||||
|                           or today                    journal end | ||||
| balance      unchanged    unchanged    unchanged      unchanged     unchanged | ||||
| posting  cost         value at report      value   value at report or   value | ||||
| amounts               end or today         at      journal end          at | ||||
|                                            posting                      DATE/today | ||||
|                                            date | ||||
| balance  unchanged    unchanged            unchangedunchanged           unchanged | ||||
| assertions | ||||
| / | ||||
| assignments | ||||
| *register* | ||||
| starting     cost         value at     not            value at      value at | ||||
| balance                   day before   supported      day before    DATE/today | ||||
| (with -H)                 report or                   report or | ||||
|                           journal                     journal | ||||
|                           start                       start | ||||
| posting      cost         value at     value at       value at      value at | ||||
| amounts                   report end   posting date   report or     DATE/today | ||||
| (no report                or today                    journal end | ||||
| starting cost         value at day         not     value at day         value | ||||
| balance               before report or     supportedbefore report or    at | ||||
| (with                 journal start                journal start        DATE/today | ||||
| -H) | ||||
| posting  cost         value at report      value   value at report or   value | ||||
| amounts               end or today         at      journal end          at | ||||
| (no                                        posting                      DATE/today | ||||
| report                                     date | ||||
| interval) | ||||
| summary      summarised   value at     sum of         value at      value at | ||||
| posting      cost         period       postings in    period ends   DATE/today | ||||
| amounts                   ends         interval, | ||||
| (with                                  valued at | ||||
| report                                 interval | ||||
| interval)                              start | ||||
| running      sum/average  sum/average  sum/average    sum/average   sum/average | ||||
| total/averageof           of           of displayed   of            of | ||||
|              displayed    displayed    values         displayed     displayed | ||||
|              values       values                      values        values | ||||
| summary  summarised   value at period      sum     value at period      value | ||||
| posting  cost         ends                 of      ends                 at | ||||
| amounts                                    postings                     DATE/today | ||||
| (with                                      in | ||||
| report                                     interval, | ||||
| interval)                                  valued | ||||
|                                            at | ||||
|                                            interval | ||||
|                                            start | ||||
| running  sum/average  sum/average of       sum/averagesum/average of    sum/average | ||||
| total/averageof       displayed values     of      displayed values     of | ||||
|          displayed                         displayed                    displayed | ||||
|          values                            values                       values | ||||
| *balance | ||||
| (bs, bse, | ||||
| cf, is..)* | ||||
| balances     sums of      value at     not            value at      value at | ||||
| (no report   costs        report end   supported      report or     DATE/today | ||||
| interval)                 or today                    journal end   of sums | ||||
|                           of sums of                  of sums of    of | ||||
|                           postings                    postings      postings | ||||
| balances     sums of      value at     not            value at      value at | ||||
| (with        costs        period       supported      period ends   DATE/today | ||||
| report                    ends of                     of sums of    of sums | ||||
| interval)                 sums of                     postings      of | ||||
|                           postings                                  postings | ||||
| starting     sums of      sums of      not            sums of       sums of | ||||
| balances     costs of     postings     supported      postings      postings | ||||
| (with        postings     before                      before        before | ||||
| report       before       report                      report        report | ||||
| interval     report       start                       start         start | ||||
| and -H)      start | ||||
| budget       like         like         not            like          like | ||||
| amounts      balances     balances     supported      balances      balances | ||||
| (bs, | ||||
| bse, | ||||
| cf, | ||||
| is..)* | ||||
| balances sums of      value at report      not     value at report or   value | ||||
| (no      costs        end or today of      supportedjournal end of      at | ||||
| report                sums of postings             sums of postings     DATE/today | ||||
| interval)                                                               of | ||||
|                                                                         sums | ||||
|                                                                         of | ||||
|                                                                         postings | ||||
| balances sums of      value at period      not     value at period      value | ||||
| changes  costs of     ends of sums of      supportedends of sums of     at | ||||
| (with    postings     postings before              postings before      DATE/today | ||||
| report   in           period end minus             period end minus     of | ||||
| interval)interval     value at period              value at period      sums | ||||
|                       starts of sums of            starts of sums of    of | ||||
|                       all postings                 all postings         postings | ||||
|                       before period                before period | ||||
|                       start                        start | ||||
| end      sums of      value at period      not     value at period      value | ||||
| balances costs of     ends of sums of      supportedends of sums of     at | ||||
| (with    postings     all postings                 all postings         DATE/today | ||||
| report   from         before period end            before period end    of | ||||
| interval report       (minus value at              (minus value at      sums | ||||
| and      start (or    report start of of           report start of of   of | ||||
| -cumulativebefore     sums of all                  sums of all          postings | ||||
| or -H)   report       postings before              postings before | ||||
|          start with   report start with            report start with | ||||
|          -H) and      -cumulative)                 -cumulative) | ||||
|          interval | ||||
|          end | ||||
| starting sums of      value at report      not     value at report      sums | ||||
| balances costs of     start of sums of     supportedstart of sums of    of | ||||
| (with    postings     all postings                 all postings         postings | ||||
| report   before       before report                before report        before | ||||
| interval report       start                        start                report | ||||
| and      start                                                          start | ||||
| -H) | ||||
| budget   like         like balances        not     like balances        like | ||||
| amounts  balances                          supported                    balances | ||||
| with | ||||
| -budget | ||||
| grand        sum of       sum of       not            sum of        sum of | ||||
| total (no    displayed    displayed    supported      displayed     displayed | ||||
| report       values       values                      values        values | ||||
| grand    sum of       sum of displayed     not     sum of displayed     sum | ||||
| total    displayed    values               supportedvalues              of | ||||
| (no      values                                                         displayed | ||||
| report                                                                  values | ||||
| interval) | ||||
| row          sums/averagessums/averagesnot            sums/averages sums/averages | ||||
| totals/averagesof         of           supported      of            of | ||||
| (with        displayed    displayed                   displayed     displayed | ||||
| report       values       values                      values        values | ||||
| row      sums/averagessums/averages of     not     sums/averages of     sums/averages | ||||
| totals/averagesof     displayed values     supporteddisplayed values    of | ||||
| (with    displayed                                                      displayed | ||||
| report   values                                                         values | ||||
| interval) | ||||
| column       sums of      sums of      not            sums of       sums of | ||||
| totals       displayed    displayed    supported      displayed     displayed | ||||
|              values       values                      values        values | ||||
| grand        sum/average  sum/average  not            sum/average   sum/average | ||||
| total/averageof column    of column    supported      of column     of | ||||
|              totals       totals                      totals        column | ||||
| column   sums of      sums of displayed    not     sums of displayed    sums | ||||
| totals   displayed    values               supportedvalues              of | ||||
|          values                                                         displayed | ||||
|                                                                         values | ||||
| grand    sum/average  sum/average of       not     sum/average of       sum/average | ||||
| total/averageof columncolumn totals        supportedcolumn totals       of | ||||
|          totals                                                         column | ||||
|                                                                         totals | ||||
| 
 | ||||
|    *Glossary:* | ||||
| @ -4132,152 +4160,152 @@ Node: Report intervals40873 | ||||
| Ref: #report-intervals41038 | ||||
| Node: Period expressions41428 | ||||
| Ref: #period-expressions41588 | ||||
| Node: Depth limiting45920 | ||||
| Ref: #depth-limiting46064 | ||||
| Node: Pivoting46396 | ||||
| Ref: #pivoting46519 | ||||
| Node: Valuation48195 | ||||
| Ref: #valuation48297 | ||||
| Node: -B Cost48986 | ||||
| Ref: #b-cost49090 | ||||
| Node: -V Value49223 | ||||
| Ref: #v-value49369 | ||||
| Node: -X Value in specified commodity49564 | ||||
| Ref: #x-value-in-specified-commodity49763 | ||||
| Node: Valuation date49912 | ||||
| Ref: #valuation-date50080 | ||||
| Node: Market prices50490 | ||||
| Ref: #market-prices50670 | ||||
| Node: --infer-value market prices from transactions51447 | ||||
| Ref: #infer-value-market-prices-from-transactions51696 | ||||
| Node: Valuation commodity52978 | ||||
| Ref: #valuation-commodity53187 | ||||
| Node: Simple valuation examples54413 | ||||
| Ref: #simple-valuation-examples54615 | ||||
| Node: --value Flexible valuation55274 | ||||
| Ref: #value-flexible-valuation55482 | ||||
| Node: More valuation examples57429 | ||||
| Ref: #more-valuation-examples57638 | ||||
| Node: Effect of valuation on reports59643 | ||||
| Ref: #effect-of-valuation-on-reports59831 | ||||
| Node: COMMANDS65352 | ||||
| Ref: #commands65460 | ||||
| Node: accounts66568 | ||||
| Ref: #accounts66666 | ||||
| Node: activity67365 | ||||
| Ref: #activity67475 | ||||
| Node: add67858 | ||||
| Ref: #add67959 | ||||
| Node: aregister70752 | ||||
| Ref: #aregister70864 | ||||
| Node: aregister and custom posting dates72237 | ||||
| Ref: #aregister-and-custom-posting-dates72410 | ||||
| Ref: #output-format-173003 | ||||
| Node: balance73408 | ||||
| Ref: #balance73525 | ||||
| Node: Classic balance report75005 | ||||
| Ref: #classic-balance-report75178 | ||||
| Node: Customising the classic balance report76502 | ||||
| Ref: #customising-the-classic-balance-report76730 | ||||
| Node: Colour support78806 | ||||
| Ref: #colour-support78973 | ||||
| Node: Flat mode79069 | ||||
| Ref: #flat-mode79217 | ||||
| Node: Depth limited balance reports79630 | ||||
| Ref: #depth-limited-balance-reports79815 | ||||
| Node: Percentages80271 | ||||
| Ref: #percentages80428 | ||||
| Node: Sorting by amount81565 | ||||
| Ref: #sorting-by-amount81731 | ||||
| Node: Multicolumn balance report82225 | ||||
| Ref: #multicolumn-balance-report82411 | ||||
| Node: Budget report88008 | ||||
| Ref: #budget-report88151 | ||||
| Node: Nested budgets93417 | ||||
| Ref: #nested-budgets93529 | ||||
| Ref: #output-format-297012 | ||||
| Node: balancesheet97209 | ||||
| Ref: #balancesheet97345 | ||||
| Node: balancesheetequity98857 | ||||
| Ref: #balancesheetequity99006 | ||||
| Node: cashflow100082 | ||||
| Ref: #cashflow100210 | ||||
| Node: check-dates101426 | ||||
| Ref: #check-dates101553 | ||||
| Node: check-dupes101832 | ||||
| Ref: #check-dupes101958 | ||||
| Node: close102251 | ||||
| Ref: #close102359 | ||||
| Node: close usage103881 | ||||
| Ref: #close-usage103974 | ||||
| Node: codes106787 | ||||
| Ref: #codes106895 | ||||
| Node: commodities107607 | ||||
| Ref: #commodities107734 | ||||
| Node: descriptions107816 | ||||
| Ref: #descriptions107944 | ||||
| Node: diff108248 | ||||
| Ref: #diff108354 | ||||
| Node: files109401 | ||||
| Ref: #files109501 | ||||
| Node: help109648 | ||||
| Ref: #help109748 | ||||
| Node: import110829 | ||||
| Ref: #import110943 | ||||
| Node: Importing balance assignments111836 | ||||
| Ref: #importing-balance-assignments111984 | ||||
| Node: incomestatement112633 | ||||
| Ref: #incomestatement112766 | ||||
| Node: notes114111 | ||||
| Ref: #notes114224 | ||||
| Node: payees114592 | ||||
| Ref: #payees114698 | ||||
| Node: prices115118 | ||||
| Ref: #prices115224 | ||||
| Node: print115565 | ||||
| Ref: #print115675 | ||||
| Node: print-unique120471 | ||||
| Ref: #print-unique120597 | ||||
| Node: register120882 | ||||
| Ref: #register121009 | ||||
| Node: Custom register output125458 | ||||
| Ref: #custom-register-output125587 | ||||
| Node: register-match126924 | ||||
| Ref: #register-match127058 | ||||
| Node: rewrite127409 | ||||
| Ref: #rewrite127524 | ||||
| Node: Re-write rules in a file129379 | ||||
| Ref: #re-write-rules-in-a-file129513 | ||||
| Node: Diff output format130723 | ||||
| Ref: #diff-output-format130892 | ||||
| Node: rewrite vs print --auto131984 | ||||
| Ref: #rewrite-vs.-print---auto132163 | ||||
| Node: roi132719 | ||||
| Ref: #roi132817 | ||||
| Node: stats133829 | ||||
| Ref: #stats133928 | ||||
| Node: tags134716 | ||||
| Ref: #tags134814 | ||||
| Node: test135333 | ||||
| Ref: #test135441 | ||||
| Node: Add-on commands136188 | ||||
| Ref: #add-on-commands136305 | ||||
| Node: ui137648 | ||||
| Ref: #ui137736 | ||||
| Node: web137790 | ||||
| Ref: #web137893 | ||||
| Node: iadd138009 | ||||
| Ref: #iadd138120 | ||||
| Node: interest138202 | ||||
| Ref: #interest138309 | ||||
| Node: ENVIRONMENT138549 | ||||
| Ref: #environment138661 | ||||
| Node: FILES139646 | ||||
| Ref: #files-1139749 | ||||
| Node: LIMITATIONS139962 | ||||
| Ref: #limitations140081 | ||||
| Node: TROUBLESHOOTING140823 | ||||
| Ref: #troubleshooting140936 | ||||
| Node: Depth limiting45961 | ||||
| Ref: #depth-limiting46105 | ||||
| Node: Pivoting46437 | ||||
| Ref: #pivoting46560 | ||||
| Node: Valuation48236 | ||||
| Ref: #valuation48338 | ||||
| Node: -B Cost49027 | ||||
| Ref: #b-cost49131 | ||||
| Node: -V Value49264 | ||||
| Ref: #v-value49410 | ||||
| Node: -X Value in specified commodity49605 | ||||
| Ref: #x-value-in-specified-commodity49804 | ||||
| Node: Valuation date49953 | ||||
| Ref: #valuation-date50121 | ||||
| Node: Market prices50531 | ||||
| Ref: #market-prices50711 | ||||
| Node: --infer-value market prices from transactions51488 | ||||
| Ref: #infer-value-market-prices-from-transactions51737 | ||||
| Node: Valuation commodity53019 | ||||
| Ref: #valuation-commodity53228 | ||||
| Node: Simple valuation examples54454 | ||||
| Ref: #simple-valuation-examples54656 | ||||
| Node: --value Flexible valuation55315 | ||||
| Ref: #value-flexible-valuation55523 | ||||
| Node: More valuation examples57470 | ||||
| Ref: #more-valuation-examples57679 | ||||
| Node: Effect of valuation on reports59684 | ||||
| Ref: #effect-of-valuation-on-reports59872 | ||||
| Node: COMMANDS67137 | ||||
| Ref: #commands67245 | ||||
| Node: accounts68353 | ||||
| Ref: #accounts68451 | ||||
| Node: activity69150 | ||||
| Ref: #activity69260 | ||||
| Node: add69643 | ||||
| Ref: #add69744 | ||||
| Node: aregister72537 | ||||
| Ref: #aregister72649 | ||||
| Node: aregister and custom posting dates74022 | ||||
| Ref: #aregister-and-custom-posting-dates74195 | ||||
| Ref: #output-format-174788 | ||||
| Node: balance75193 | ||||
| Ref: #balance75310 | ||||
| Node: Classic balance report76790 | ||||
| Ref: #classic-balance-report76963 | ||||
| Node: Customising the classic balance report78287 | ||||
| Ref: #customising-the-classic-balance-report78515 | ||||
| Node: Colour support80591 | ||||
| Ref: #colour-support80758 | ||||
| Node: Flat mode80854 | ||||
| Ref: #flat-mode81002 | ||||
| Node: Depth limited balance reports81415 | ||||
| Ref: #depth-limited-balance-reports81600 | ||||
| Node: Percentages82056 | ||||
| Ref: #percentages82213 | ||||
| Node: Sorting by amount83350 | ||||
| Ref: #sorting-by-amount83516 | ||||
| Node: Multicolumn balance report84010 | ||||
| Ref: #multicolumn-balance-report84196 | ||||
| Node: Budget report89793 | ||||
| Ref: #budget-report89936 | ||||
| Node: Nested budgets95202 | ||||
| Ref: #nested-budgets95314 | ||||
| Ref: #output-format-298797 | ||||
| Node: balancesheet98994 | ||||
| Ref: #balancesheet99130 | ||||
| Node: balancesheetequity100642 | ||||
| Ref: #balancesheetequity100791 | ||||
| Node: cashflow101867 | ||||
| Ref: #cashflow101995 | ||||
| Node: check-dates103211 | ||||
| Ref: #check-dates103338 | ||||
| Node: check-dupes103617 | ||||
| Ref: #check-dupes103743 | ||||
| Node: close104036 | ||||
| Ref: #close104144 | ||||
| Node: close usage105666 | ||||
| Ref: #close-usage105759 | ||||
| Node: codes108572 | ||||
| Ref: #codes108680 | ||||
| Node: commodities109392 | ||||
| Ref: #commodities109519 | ||||
| Node: descriptions109601 | ||||
| Ref: #descriptions109729 | ||||
| Node: diff110033 | ||||
| Ref: #diff110139 | ||||
| Node: files111186 | ||||
| Ref: #files111286 | ||||
| Node: help111433 | ||||
| Ref: #help111533 | ||||
| Node: import112614 | ||||
| Ref: #import112728 | ||||
| Node: Importing balance assignments113621 | ||||
| Ref: #importing-balance-assignments113769 | ||||
| Node: incomestatement114418 | ||||
| Ref: #incomestatement114551 | ||||
| Node: notes115896 | ||||
| Ref: #notes116009 | ||||
| Node: payees116377 | ||||
| Ref: #payees116483 | ||||
| Node: prices116903 | ||||
| Ref: #prices117009 | ||||
| Node: print117350 | ||||
| Ref: #print117460 | ||||
| Node: print-unique122256 | ||||
| Ref: #print-unique122382 | ||||
| Node: register122667 | ||||
| Ref: #register122794 | ||||
| Node: Custom register output127243 | ||||
| Ref: #custom-register-output127372 | ||||
| Node: register-match128709 | ||||
| Ref: #register-match128843 | ||||
| Node: rewrite129194 | ||||
| Ref: #rewrite129309 | ||||
| Node: Re-write rules in a file131164 | ||||
| Ref: #re-write-rules-in-a-file131298 | ||||
| Node: Diff output format132508 | ||||
| Ref: #diff-output-format132677 | ||||
| Node: rewrite vs print --auto133769 | ||||
| Ref: #rewrite-vs.-print---auto133948 | ||||
| Node: roi134504 | ||||
| Ref: #roi134602 | ||||
| Node: stats135614 | ||||
| Ref: #stats135713 | ||||
| Node: tags136501 | ||||
| Ref: #tags136599 | ||||
| Node: test137118 | ||||
| Ref: #test137226 | ||||
| Node: Add-on commands137973 | ||||
| Ref: #add-on-commands138090 | ||||
| Node: ui139433 | ||||
| Ref: #ui139521 | ||||
| Node: web139575 | ||||
| Ref: #web139678 | ||||
| Node: iadd139794 | ||||
| Ref: #iadd139905 | ||||
| Node: interest139987 | ||||
| Ref: #interest140094 | ||||
| Node: ENVIRONMENT140334 | ||||
| Ref: #environment140446 | ||||
| Node: FILES141431 | ||||
| Ref: #files-1141534 | ||||
| Node: LIMITATIONS141747 | ||||
| Ref: #limitations141866 | ||||
| Node: TROUBLESHOOTING142608 | ||||
| Ref: #troubleshooting142721 | ||||
|  | ||||
| End Tag Table | ||||
| 
 | ||||
|  | ||||
| @ -1138,9 +1138,10 @@ OPTIONS | ||||
|        If  you want intervals that start on arbitrary day of your choosing and | ||||
|        span a week, month or year, you need to use any of the following: | ||||
| 
 | ||||
|        every Nth day of week, every <weekday>, every Nth day [of month], every | ||||
|        Nth weekday [of month], every MM/DD [of year], every Nth MMM [of year], | ||||
|        every MMM Nth [of year]. | ||||
|        every    Nth     day     of     week,     every     WEEKDAYNAME     (eg | ||||
|        mon|tue|wed|thu|fri|sat|sun), every Nth day [of month], every Nth WEEK- | ||||
|        DAYNAME [of month], every MM/DD [of year], every Nth MMM [of year], ev- | ||||
|        ery MMM Nth [of year]. | ||||
| 
 | ||||
|        Examples: | ||||
| 
 | ||||
| @ -1532,71 +1533,111 @@ OPTIONS | ||||
|        problems, please report them, ideally with a reproducible example.  Re- | ||||
|        lated: #329, #1083. | ||||
| 
 | ||||
|        Report type    -B,            -V, -X         --value=then    --value=end    --value=DATE, | ||||
|                       --value=cost                                                 --value=now | ||||
|        ------------------------------------------------------------------------------------------ | ||||
|        Report     -B,            -V, -X                 --value=then   --value=end            --value=DATE, | ||||
|        type       --value=cost                                                                --value=now | ||||
|        ----------------------------------------------------------------------------------------------------- | ||||
|        print | ||||
|        posting        cost           value at re-   value      at   value at re-   value      at | ||||
|        amounts                       port end  or   posting date    port      or   DATE/today | ||||
|                                      today                          journal end | ||||
|        balance  as-   unchanged      unchanged      unchanged       unchanged      unchanged | ||||
|        sertions   / | ||||
|        assignments | ||||
|        posting    cost           value  at report end   value     at   value  at  report or   value      at | ||||
|        amounts                   or today               posting date   journal end            DATE/today | ||||
|        balance    unchanged      unchanged              unchanged      unchanged              unchanged | ||||
|        asser- | ||||
|        tions / | ||||
|        assign- | ||||
|        ments | ||||
| 
 | ||||
|        register | ||||
|        starting       cost           value at day   not supported   value at day   value      at | ||||
|        balance                       before   re-                   before   re-   DATE/today | ||||
|        (with -H)                     port      or                   port      or | ||||
|                                      journal                        journal | ||||
|                                      start                          start | ||||
|        posting        cost           value at re-   value      at   value at re-   value      at | ||||
|        amounts  (no                  port end  or   posting date    port      or   DATE/today | ||||
|        report   in-                  today                          journal end | ||||
|        terval) | ||||
|        summary        summarised     value at pe-   sum  of post-   value at pe-   value      at | ||||
|        posting        cost           riod ends      ings  in  in-   riod ends      DATE/today | ||||
|        regis- | ||||
|        ter | ||||
|        start-     cost           value at day  before   not     sup-   value  at day before   value      at | ||||
|        ing                       report   or  journal   ported         report  or   journal   DATE/today | ||||
|        balance                   start                                 start | ||||
|        (with | ||||
|        -H) | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|        posting    cost           value  at report end   value     at   value  at  report or   value      at | ||||
|        amounts                   or today               posting date   journal end            DATE/today | ||||
|        (no re- | ||||
|        port | ||||
|        inter- | ||||
|        val) | ||||
|        summary    summarised     value at period ends   sum of post-   value at period ends   value      at | ||||
|        posting    cost                                  ings  in in-                          DATE/today | ||||
|        amounts                                          terval, val- | ||||
|        (with report                                 ued at inter- | ||||
|        interval)                                    val start | ||||
|        running  to-   sum/average    sum/average    sum/average     sum/average    sum/average | ||||
|        tal/average    of displayed   of displayed   of  displayed   of displayed   of  displayed | ||||
|                       values         values         values          values         values | ||||
|        (with                                            ued  at  in- | ||||
|        report                                           terval start | ||||
|        inter- | ||||
|        val) | ||||
|        running    sum/average    sum/average of  dis-   sum/average    sum/average  of dis-   sum/average | ||||
|        to-        of displayed   played values          of displayed   played values          of  displayed | ||||
|        tal/av-    values                                values                                values | ||||
|        erage | ||||
| 
 | ||||
| 
 | ||||
|        balance (bs, | ||||
|        bse,     cf, | ||||
|        balance | ||||
|        (bs, | ||||
|        bse, | ||||
|        cf, | ||||
|        is..) | ||||
|        balances (no   sums      of   value at re-   not supported   value at re-   value      at | ||||
|        report   in-   costs          port end  or                   port      or   DATE/today of | ||||
|        terval)                       today     of                   journal  end   sums of post- | ||||
|                                      sums      of                   of  sums  of   ings | ||||
|                                      postings                       postings | ||||
|        balances       sums      of   value at pe-   not supported   value at pe-   value      at | ||||
|        (with report   costs          riod ends of                   riod ends of   DATE/today of | ||||
|        interval)                     sums      of                   sums      of   sums of post- | ||||
|                                      postings                       postings       ings | ||||
|        starting       sums      of   sums      of   not supported   sums      of   sums of post- | ||||
|        balances       costs     of   postings be-                   postings be-   ings   before | ||||
|        (with report   postings be-   fore  report                   fore  report   report start | ||||
|        interval and   fore  report   start                          start | ||||
|        -H)            start | ||||
|        budget         like    bal-   like    bal-   not supported   like    bal-   like balances | ||||
|        amounts with   ances          ances                          ances | ||||
|        --budget | ||||
|        grand  total   sum  of dis-   sum  of dis-   not supported   sum  of dis-   sum  of  dis- | ||||
|        (no   report   played  val-   played  val-                   played  val-   played values | ||||
|        interval)      ues            ues                            ues | ||||
|        row      to-   sums/aver-     sums/aver-     not supported   sums/aver-     sums/averages | ||||
|        tals/aver-     ages of dis-   ages of dis-                   ages of dis-   of  displayed | ||||
|        ages   (with   played  val-   played  val-                   played  val-   values | ||||
|        report   in-   ues            ues                            ues | ||||
|        terval) | ||||
|        column   to-   sums of dis-   sums of dis-   not supported   sums of dis-   sums of  dis- | ||||
|        tals           played  val-   played  val-                   played  val-   played values | ||||
|                       ues            ues                            ues | ||||
|        grand    to-   sum/average    sum/average    not supported   sum/average    sum/average | ||||
|        tal/average    of    column   of    column                   of    column   of column to- | ||||
|                       totals         totals                         totals         tals | ||||
|        bal-       sums      of   value at report  end   not     sup-   value  at  report or   value      at | ||||
|        ances      costs          or  today of sums of   ported         journal end of  sums   DATE/today of | ||||
|        (no re-                   postings                              of postings            sums of post- | ||||
|        port                                                                                   ings | ||||
|        inter- | ||||
|        val) | ||||
|        bal-       sums      of   value at period ends   not     sup-   value at period ends   value      at | ||||
|        ances      costs     of   of sums of  postings   ported         of  sums of postings   DATE/today of | ||||
|        changes    postings  in   before   period  end                  before  period   end   sums of post- | ||||
|        (with      interval       minus value  at  pe-                  minus  value  at pe-   ings | ||||
|        report                    riod  starts of sums                  riod starts of  sums | ||||
|        inter-                    of all postings  be-                  of  all postings be- | ||||
|        val)                      fore period start                     fore period start | ||||
|        end        sums      of   value at period ends   not     sup-   value at period ends   value      at | ||||
|        bal-       costs     of   of sums of all post-   ported         of sums of all post-   DATE/today of | ||||
|        ances      postings       ings  before  period                  ings  before  period   sums of post- | ||||
|        (with      from  report   end  (minus value at                  end  (minus value at   ings | ||||
|        report     start    (or   report start  of  of                  report start  of  of | ||||
|        inter-     before   re-   sums of all postings                  sums of all postings | ||||
|        val and    port   start   before report  start                  before report  start | ||||
|        --cumu-    with -H) and   with --cumulative)                    with --cumulative) | ||||
|        lative     interval end | ||||
|        or -H) | ||||
|        start-     sums      of   value   at    report   not     sup-   value   at    report   sums of post- | ||||
|        ing        costs     of   start of sums of all   ported         start of sums of all   ings   before | ||||
|        bal-       postings be-   postings before  re-                  postings before  re-   report start | ||||
|        ances      fore  report   port start                            port start | ||||
|        (with      start | ||||
|        report | ||||
|        inter- | ||||
|        val and | ||||
|        -H) | ||||
|        budget     like    bal-   like balances          not     sup-   like balances          like balances | ||||
|        amounts    ances                                 ported | ||||
|        with | ||||
|        --bud- | ||||
|        get | ||||
|        grand      sum of  dis-   sum   of   displayed   not     sup-   sum   of   displayed   sum  of  dis- | ||||
|        total      played  val-   values                 ported         values                 played values | ||||
|        (no re-    ues | ||||
|        port | ||||
|        inter- | ||||
|        val) | ||||
| 
 | ||||
| 
 | ||||
| 
 | ||||
|        row to-    sums/aver-     sums/averages     of   not     sup-   sums/averages     of   sums/averages | ||||
|        tals/av-   ages of dis-   displayed values       ported         displayed values       of  displayed | ||||
|        erages     played  val-                                                                values | ||||
|        (with      ues | ||||
|        report | ||||
|        inter- | ||||
|        val) | ||||
|        column     sums of dis-   sums   of  displayed   not     sup-   sums   of  displayed   sums of  dis- | ||||
|        totals     played  val-   values                 ported         values                 played values | ||||
|                   ues | ||||
|        grand      sum/average    sum/average of  col-   not     sup-   sum/average of  col-   sum/average | ||||
|        to-        of    column   umn totals             ported         umn totals             of column to- | ||||
|        tal/av-    totals                                                                      tals | ||||
|        erage | ||||
| 
 | ||||
| 
 | ||||
|        Glossary: | ||||
|  | ||||
		Loading…
	
		Reference in New Issue
	
	Block a user