doc: release notes cleanup
This commit is contained in:
		
							parent
							
								
									97e7fd67f4
								
							
						
					
					
						commit
						aec7d2fa3c
					
				| @ -1,50 +1,33 @@ | |||||||
| # -*- mode:org -*- | # -*- mode:org -*- | ||||||
| 
 | 
 | ||||||
|  | #+OPTIONS: num:0 | ||||||
|  | 
 | ||||||
| * 2016/mm/dd 0.28 | * 2016/mm/dd 0.28 | ||||||
| ** general | ** general | ||||||
| *** misc | *** misc | ||||||
|     * Added GHC 8 support, dropped GHC 7.6 and 7.8 support. | **** added GHC 8 support, dropped GHC 7.6 and 7.8 support. | ||||||
|       (Restoring GHC 7.8 support would need small code changes and a |      GHC 7.8 support could be restored with small code changes and a maintainer. | ||||||
|       maintainer.) | **** a cabal.project file has been added (Moritz Kiefer) | ||||||
|     * a cabal.project file has been added to the source tree (Moritz Kiefer) | **** use hpack for maintaining cabal files (#371). | ||||||
|     * tools/simplebench has been spun off as the quickbench package. |      Instead of editing cabal files directly, we now edit the less | ||||||
|     * clean up some old cabal flags |      verbose and less redundant package.yaml files and let stack (or | ||||||
|     * use hpack for maintaining all packages' cabal files (#371). |      hpack) update the cabal files. We commit both the .yaml and | ||||||
|       Instead of editing cabal files directly, we now edit the less |      .cabal files. | ||||||
|       verbose and less redundant package.yaml files and let stack (or | **** clean up some old cabal flags | ||||||
|       hpack) update the cabal files. We commit both the .yaml and | **** tools/simplebench has been spun off as the quickbench package. | ||||||
|       .cabal files. | **** add Appveyor CI builds, provide up-to-date binaries for Windows | ||||||
|     * use Appveyor for CI and up-to-date binaries on Windows | **** extra: add a bunch of CSV rules examples | ||||||
| 
 |  | ||||||
| 
 |  | ||||||
| *** docs | *** docs | ||||||
|     * All of the hledger executables' manuals now include the full | **** the website is simpler, clearer, and more mobile-friendly.   | ||||||
|       list of general and reporting options; the assumption is that |      Docs are now collected on a single page and organised by type: getting started, reference, more. | ||||||
|       these options are harmlessly ignored when not supported. | **** reference docs have been split into one manual for each executable and file format.  | ||||||
|     * docs have been reorganised and are now also provided as built-in |      This helps with maintenance and packaging and also should make it | ||||||
|       help, in plain text, man and info formats, generated from the |      easier to see what's available and to read just what you need. | ||||||
|       same source by a new Shake-based docs build system. (#292) | **** manuals are now provided in html, plain text, man and info formats | ||||||
|     * misc documentation updates - layout/style cleanups, LEDGER_FILE, |      generated from the same source by a new Shake-based docs build system. (#292) | ||||||
|       accounts, include directive, CSV, timeclock, how to use dotted | **** versioned manuals are provided on the website, covering recent releases and the latest dev version (#385, #387) | ||||||
|       account names | **** manuals are built in to the hledger executables, allowing easy offline reading on all platforms. | ||||||
|     * minor copyedits (jungle-boogie) |      #+BEGIN_EXAMPLE | ||||||
|     * The website is simpler, clearer, and more mobile-friendly.  Docs |  | ||||||
|       are now collected on a single page and separated by type: |  | ||||||
|       getting started, reference, more.  Also separate web manuals are |  | ||||||
|       available for each executable and file format. This should make |  | ||||||
|       it easier to see what's available, and to read just what you |  | ||||||
|       need. |  | ||||||
|     * web docs are now provided for recent releases and the latest dev |  | ||||||
|       version (#385, #387) |  | ||||||
|     * add beancount's nice example journal, hledgerised This is the |  | ||||||
|       synthetic, somewhat realistic example journal from Martin Blais' |  | ||||||
|       beancount project (of a few months ago), slightly tweaked for |  | ||||||
|       hledger. It makes a nice example, eg for trying out hledger-ui. |  | ||||||
| 
 |  | ||||||
| *** cli |  | ||||||
|     * The hledger executables have a new help system, making their |  | ||||||
|       manuals available for local reading. |  | ||||||
|       #+BEGIN_EXAMPLE |  | ||||||
|       PROG -h              shows PROG's command-line usage |       PROG -h              shows PROG's command-line usage | ||||||
|       PROG --help          shows PROG's manual (fixed width) |       PROG --help          shows PROG's manual (fixed width) | ||||||
|       PROG --man           shows PROG's manual with man (formatted/paged) |       PROG --man           shows PROG's manual with man (formatted/paged) | ||||||
| @ -52,273 +35,250 @@ | |||||||
|       hledger help [TOPIC] shows any manual |       hledger help [TOPIC] shows any manual | ||||||
|       hledger man  [TOPIC] shows any manual with man |       hledger man  [TOPIC] shows any manual with man | ||||||
|       hledger info [TOPIC] shows any manual with info |       hledger info [TOPIC] shows any manual with info | ||||||
|       #+END_EXAMPLE |      #+END_EXAMPLE | ||||||
|  | **** the general and reporting options are now listed in all executable manuals. | ||||||
|  |      We assume any of them which are unsupported are harmlessly ignored. | ||||||
|  | **** demo.hledger.org is using beancount's example journal. | ||||||
|  |      This is the somewhat realistic example journal from the beancount | ||||||
|  |      project, tweaked for hledger. | ||||||
|  | **** minor copyedits (jungle-boogie) | ||||||
|  | *** cli | ||||||
|  | **** parsing multiple input files is now robust. | ||||||
|  |      When multiple -f options are provided, we now parse each file | ||||||
|  |      individually rather than just concatenating them, so they can | ||||||
|  |      have different formats (#320).  Note this also means that | ||||||
|  |      directives (like `Y` or `alias`) no longer carry over from one | ||||||
|  |      file to the next. | ||||||
| 
 | 
 | ||||||
|     * When multiple files are specified with multiple -f options, we | **** I has been added as the short flag for --ignore-assertions | ||||||
|       now parse each one individually, rather than just concatenating |      (this is different from Ledger's CLI, but useful for hledger-ui). | ||||||
|       them, so they can have different formats (#320).  Note this also |  | ||||||
|       means that directives (like `Y` or `alias`) no longer carry over |  | ||||||
|       from one file to the next. |  | ||||||
| 
 | 
 | ||||||
|     * Parsing an argument-less --debug option is more robust. | **** parsing an argument-less --debug option is more robust | ||||||
| 
 |  | ||||||
|     * -I has been added as the short flag for --ignore-assertions. |  | ||||||
|       (Differs from Ledger's CLI, but useful for hledger-ui.) |  | ||||||
| 
 | 
 | ||||||
| ** hledger-lib 0.28 | ** hledger-lib 0.28 | ||||||
| *** journal format | *** timedot format | ||||||
|     * try to parse standard input as journal format always, not just most of the time | **** new "timedot" format for retroactive/approximate time logging. | ||||||
|     * can now include timeclock/timedot files (#320) journal files can |      Timedot is a plain text format for logging dated, categorised | ||||||
|       now include journal, timeclock or timedot files (but not yet CSV |      quantities (eg time), supported by hledger.  It is convenient | ||||||
|       files). Also timeclock/timedot files no longer support default |      for approximate and retroactive time logging, eg when the | ||||||
|       year directives. |      real-time clock-in/out required with a timeclock file is too | ||||||
|     * support commodity directive and format subdirective, allowing |      precise or too interruptive.  It can be formatted like a bar | ||||||
|       full control of commodity style (#295) The commodity directive's |      chart, making clear at a glance where time was spent. | ||||||
|       format subdirective can now be used to override the inferred |  | ||||||
|       style for a commodity, eg to increase or decrease the |  | ||||||
|       precision. This is at least a good workaround for #295. |  | ||||||
|     * lib: after reloading a journal, also refilter it (#314) |  | ||||||
|     * lib: fix bracketed posting dates, parser cleanup (#304) |  | ||||||
|       Bracketed posting dates were fragile; they worked only if you |  | ||||||
|       wrote full 10-character dates. Also some semantics were a bit |  | ||||||
|       unclear. Now they should be robust, and have been documented |  | ||||||
|       more clearly. This is a legacy undocumented Ledger syntax, but |  | ||||||
|       it improves compatibility and might be preferable to the more |  | ||||||
|       verbose "date:" tags if you write posting dates often (as I do). |  | ||||||
|       Internally, bracketed posting dates are no longer considered to |  | ||||||
|       be tags.  Journal comment, tag, and posting date parsers have |  | ||||||
|       been reworked, all with doctests. |  | ||||||
|     * We now parse "account" directives, like Ledger's. We don't do |  | ||||||
|       anything with them yet. The default parent account feature must |  | ||||||
|       now be spelled "apply account"/"end apply account". |  | ||||||
|     * support ledger3-compatible "apply account" |  | ||||||
|     * lib: show txn's file position in assertion errors |  | ||||||
|     * lib: more ergonomic balance assertion errors |  | ||||||
|     * fixed an issue with ordering of included same-date transactions |  | ||||||
|     * Balance assertion failure messages now have a more standard and parseable layout. |  | ||||||
|     * With --debug=2, more detail about balance assertions is shown. |  | ||||||
| 
 | 
 | ||||||
| *** timeclock format | *** timeclock format | ||||||
|     * renamed timelog format to "timeclock", matching the emacs package | **** renamed "timelog" format to "timeclock", matching the emacs package | ||||||
|     * sessions can no longer span file boundaries (unclocked-out | **** sessions can no longer span file boundaries (unclocked-out | ||||||
|       sessions will be auto-closed at the end of the file). |      sessions will be auto-closed at the end of the file). | ||||||
|     * timeclock: fix order of transaction indexes #394. | **** transaction ids now count up rather than down (#394) | ||||||
|       Timeclock transaction ids now count up rather than down. | **** timeclock files no longer support default year directives | ||||||
|     * removed old code for appending timeclock transactions to journal | **** removed old code for appending timeclock transactions to journal transactions. | ||||||
|       transactions, a holdover from the days when both were allowed in |      A holdover from the days when both were allowed in one file. | ||||||
|       one file. |  | ||||||
| 
 |  | ||||||
| *** timedot format |  | ||||||
|     * new "timedot" format for retroactive/approximate time logging |  | ||||||
|       Timedot is a plain text format for logging dated, categorised |  | ||||||
|       quantities (eg time), supported by hledger.  It is convenient |  | ||||||
|       for approximate and retroactive time logging, eg when the |  | ||||||
|       real-time clock-in/out required with a timeclock file is too |  | ||||||
|       precise or too interruptive.  It can be formatted like a bar |  | ||||||
|       chart, making clear at a glance where time was spent. |  | ||||||
| 
 |  | ||||||
| *** csv format | *** csv format | ||||||
|     * fix empty field assignment parsing, rule parse errors after | **** fix empty field assignment parsing, rule parse errors after megaparsec port (#407) (Hans-Peter Deifel) | ||||||
|       megaparsec port (#407) (Hans-Peter Deifel) | *** journal format | ||||||
|  | **** journal files can now include timeclock or timedot files (#320)  | ||||||
|  |      (but not yet CSV files). | ||||||
|  | **** fixed an issue with ordering of same-date transactions included from other files | ||||||
|  | **** the "commodity" directive and "format" subdirective are now supported, allowing | ||||||
|  |      full control of commodity style (#295) The commodity directive's | ||||||
|  |      format subdirective can now be used to override the inferred | ||||||
|  |      style for a commodity, eg to increase or decrease the | ||||||
|  |      precision. This is at least a good workaround for #295. | ||||||
|  | **** Ledger-style "apply account"/"end apply account" directives are now used to set a default parent account. | ||||||
|  | **** the Ledger-style "account" directive is now accepted (and ignored). | ||||||
|  | **** bracketed posting dates are more robust (#304) | ||||||
|  |      Bracketed posting dates were fragile; they worked only if you | ||||||
|  |      wrote full 10-character dates. Also some semantics were a bit | ||||||
|  |      unclear. Now they should be robust, and have been documented | ||||||
|  |      more clearly. This is a legacy undocumented Ledger syntax, but | ||||||
|  |      it improves compatibility and might be preferable to the more | ||||||
|  |      verbose "date:" tags if you write posting dates often (as I do). | ||||||
|  |      Internally, bracketed posting dates are no longer considered to | ||||||
|  |      be tags.  Journal comment, tag, and posting date parsers have | ||||||
|  |      been reworked, all with doctests. | ||||||
|  | **** balance assertion failure messages are clearer | ||||||
|  | **** with --debug=2, more detail about balance assertions is shown. | ||||||
| *** misc | *** misc | ||||||
|     * file parsers have been ported from Parsec to Megaparsec \o/  | **** file parsers have been ported from Parsec to Megaparsec \o/ (#289, #366) (Alexey Shmalko, Moritz Kiefer) | ||||||
|       (#289, #366) (Alexey Shmalko, Moritz Kiefer) | **** most hledger types have been converted from String to Text, reducing memory usage by 30%+ on large files and giving a slight speed increase | ||||||
|     * All formats now produce transaction ids, not just journal format (#394) | **** file parsers have been simplified for easier troubleshooting (#275). | ||||||
|     * clarify balance assertion error again. "calculated" is better |      The journal/timeclock/timedot parsers, instead of constructing | ||||||
|       than "actual" which implies the account's actual real-world |      opaque journal update functions which are later applied to build | ||||||
|       balance, which might be different. |      the journal, now construct the journal directly by modifying the | ||||||
|     * Use hpack in hledger-ui (#356) |      parser state. This is easier to understand and debug. It also | ||||||
|     * always try parsing stdin as journal |      rules out the possibility of journal updates being a space | ||||||
|     * reduced memory usage by 30%+ on large files |      leak. (They weren't, in fact this change increased memory usage | ||||||
|     * bump default stackage snapshot to lts-6.0 |      slightly, but that has been addressed in other ways).  The | ||||||
|     * git clone of the hledger repo on windows now works (#345) |      ParsedJournal type alias has been added to distinguish | ||||||
|     * added missing benchmark file (#342) |      "being-parsed" journals and "finalised" journals. | ||||||
|     * Add --pivot option with tests and docs (#323) (Malte Brandy) | **** file format detection is more robust. | ||||||
|     * more tests, start using doctests |      The Journal, Timelog and Timedot readers' detectors now check | ||||||
|     * lib: slightly better file format detection. The Journal, Timelog |      each line in the sample data, not just the first one. I think the | ||||||
|       and Timedot readers' detectors now check each line in the sample |      sample data is only about 30 chars right now, but even so this | ||||||
|       data, not just the first one. I think the sample data is only |      fixed a format detection issue I was seeing.  | ||||||
|       about 30 chars right now, but even so this fixed a format |      Also, we now always try parsing stdin as journal format (not just sometimes). | ||||||
|       detection issue I was seeing. | **** all file formats now produce transaction ids, not just journal (#394) | ||||||
|     * make stack config more compatible across stack versions (#300) | **** git clone of the hledger repo on windows now works (#345) | ||||||
|     * journalReloadIfChanged now reloads the full journal without filtering, like journalReload | **** added missing benchmark file (#342) | ||||||
|     * Reloading a journal should now reload all included files as well. | **** our stack.yaml files are more compatible across stack versions (#300) | ||||||
|     * lib: make Journal a monoid | **** use newer file-embed to fix ghci working directory dependence (https://github.com/snoyberg/file-embed/issues/18) | ||||||
|     * lib: The Hledger.Read.* modules have been reorganised for better | **** report more accurate dates in account transaction report when postings have their own dates | ||||||
|       reuse.  Hledger.Read.Utils has been renamed Hledger.Read.Common |      (affects hledger-ui and hledger-web registers). | ||||||
|       and holds low-level parsers & utilities; high-level read |      The newly-named "transaction register date" is the date to be | ||||||
|       utilities have moved to Hledger.Read. |      displayed for that transaction in a transaction register, for | ||||||
|     * use new file-embed to fix ghci cwd dependence, see |      some current account and filter query.  It is either the | ||||||
|       https://github.com/snoyberg/file-embed/issues/18 |      transaction date from the journal ("transaction general date"), | ||||||
|     * lib: refactor amount canonicalisation.  Amount display style |      or if postings to the current account and matched by the | ||||||
|       canonicalisation code and terminology has been clarified a |      register's filter query have their own dates, the earliest of | ||||||
|       bit. Individual amounts still have styles; from these we derive |      those posting dates. | ||||||
|       the standard "commodity styles". In user docs, we might call |  | ||||||
|       these "commodity formats" since a Ledger-compatible commodity |  | ||||||
|       directive would use the "format" keyword. |  | ||||||
|     * Most hledger types have been converted from String to (strict) |  | ||||||
|       Text.  This reduces maximum residency (~30-50%) on large data |  | ||||||
|       files and gives a slight speed increase. |  | ||||||
|     * lib: simplify parsers; cleanups (#275).  The |  | ||||||
|       journal/timeclock/timedot parsers, instead of constructing |  | ||||||
|       (opaque) journal update functions which are later applied to |  | ||||||
|       build the journal, now construct the journal directly (by |  | ||||||
|       modifying the parser state). This is easier to understand and |  | ||||||
|       debug. It also rules out the possibility of journal updates |  | ||||||
|       being a space leak. (They weren't, in fact memory usage is now |  | ||||||
|       slightly higher, but that will be addressed in other ways.) |  | ||||||
|     * Journal data and journal parse info have been merged into one |  | ||||||
|       type (for now), and field names are more consistent. |  | ||||||
|     * The ParsedJournal type alias has been added to distinguish |  | ||||||
|       being-parsed and finalised journals. |  | ||||||
|     * Journal is now a monoid. |  | ||||||
|     * expandPath now throws a proper IO error (and requires the IO monad). |  | ||||||
|     * provide more accurate dates in account transactions report |  | ||||||
|       (and hledger-ui and hledger-web's account registers) |  | ||||||
|       when postings have their own dates.  |  | ||||||
| 
 |  | ||||||
|       The newly-named "transaction register date" is the date to be |  | ||||||
|       displayed for that transaction in a transaction register, for |  | ||||||
|       some current account and filter query.  It is either the |  | ||||||
|       transaction date from the journal ("transaction general date"), |  | ||||||
|       or if postings to the current account and matched by the |  | ||||||
|       register's filter query have their own dates, the earliest of |  | ||||||
|       those posting dates. |  | ||||||
| 
 |  | ||||||
|     * lib: simplify account txns report running total. |  | ||||||
|       The account transactions report used for hledger-ui and -web |  | ||||||
|       registers now gives either the "period total" or "historical |  | ||||||
|       total", depending strictly on the --historical flag. It doesn't |  | ||||||
|       try to indicate whether the historical total is the accurate |  | ||||||
|       historical balance (which depends on the user's report query). |  | ||||||
| 
 | 
 | ||||||
|  | **** simplify account transactions report's running total. | ||||||
|  |      The account transactions report used for hledger-ui and -web | ||||||
|  |      registers now gives either the "period total" or "historical | ||||||
|  |      total", depending strictly on the --historical flag. It doesn't | ||||||
|  |      try to indicate whether the historical total is the accurate | ||||||
|  |      historical balance (which depends on the user's report query). | ||||||
|  | **** reloading a file now preserves the effect of options, query arguments etc. | ||||||
|  | **** reloading a journal should now reload all included files as well. | ||||||
|  | **** the Hledger.Read.* modules have been reorganised for better reuse. | ||||||
|  |      Hledger.Read.Utils has been renamed Hledger.Read.Common | ||||||
|  |      and holds low-level parsers & utilities; high-level read | ||||||
|  |      utilities are now in Hledger.Read. | ||||||
|  | **** clarify amount display style canonicalisation code and terminology a bit. | ||||||
|  |      Individual amounts still have styles; from these we derive | ||||||
|  |      the standard "commodity styles". In user docs, we might call | ||||||
|  |      these "commodity formats" since they can be controlled by the | ||||||
|  |      "format" subdirective in journal files. | ||||||
|  | **** Journal is now a monoid | ||||||
|  | **** expandPath now throws a proper IO error | ||||||
|  | **** more unit tests, start using doctest | ||||||
| ** hledger 0.28 | ** hledger 0.28 | ||||||
| 
 |  | ||||||
| *** add | *** add | ||||||
|     * suggest only one commodity at a time as default amount, | **** suggest only one commodity at a time as default amount (#383) | ||||||
|       since we currently can't input more than one at a time (#383) |      (since we currently can't input more than one at a time) | ||||||
| 
 |  | ||||||
| *** balance | *** balance | ||||||
|     * output CSV item amounts on one line #336 | **** added --change flag for consistency | ||||||
|     * added --change flag for consistency | **** H/--historical now also affects single-column balance reports with a start date (#392). | ||||||
|     * -H/--historical now also affects single-column balance reports with a start date (#392). |      This has the same effect as just omitting the start date, but adds consistency. | ||||||
|       This has the same effect as just omitting the start date, but adds consistency. | **** in CSV output, render amounts in one-line format (#336) | ||||||
| *** balancesheet | *** balancesheet | ||||||
|     * fix an infinite loop #393 | **** fix an infinite loop (#393) | ||||||
| *** print | *** print | ||||||
|     * fix/rename transaction id field in CSV output | **** in CSV output, fix and rename the transaction id field | ||||||
| *** register | *** register | ||||||
|     * fix sorting regression with --date2 (#326) | **** fix a sorting regression with --date2 (#326) | ||||||
|     * include transaction id, rename total field in CSV output (fixes #391) | **** --average/-A is now affected by --historical/-H | ||||||
|     * --average/-A is now affected by --historical/-H | **** added --cumulative flag for consistency | ||||||
|     * added --cumulative flag for consistency | **** in CSV output, include the transaction id and rename the total field (#391) | ||||||
| *** stats | *** stats | ||||||
|     * fixed an issue with ordering of include files ? | **** fixed an issue with ordering of include files | ||||||
| *** misc | *** misc | ||||||
|     * try to clarify balance/register's various report modes,  | **** --pivot option added, groups postings by tag instead of account (#323) (Malte Brandy) | ||||||
|       kinds of "balance" displayed, and related options and language. | **** try to clarify balance/register's various report modes, | ||||||
|     * with multiple --change/--cumulative/--historical flags,  |      kinds of "balance" displayed, and related options and language. | ||||||
|       use the last one instead of complaining | **** with multiple --change/--cumulative/--historical flags, use the last one instead of complaining | ||||||
|     * don't add the "d" suffix when displaying day periods | **** don't add the "d" suffix when displaying day periods | ||||||
|     * stack-ify extra/hledger-rewrite.hs | **** stack-ify extra/hledger-rewrite.hs | ||||||
| ** hledger-ui 0.28 | ** hledger-ui 0.28 | ||||||
|     * add vi-style movement keys, use ? for help (#357) | *** accounts screen | ||||||
|     * The E key (on all screens) runs $HLEDGER_UI_EDITOR or $EDITOR or a default editor (vi) on the journal file. | **** at depth 0, show accounts on one "All" line and show all transactions in the register | ||||||
|       When using emacs or vi, if a transaction is selected the cursor will be positioned at its journal entry. | **** 0 now sets depth limit to 0 instead of clearing it | ||||||
|     * flat mode affects register too; doc updates | **** always use --no-elide for a more regular accounts tree | ||||||
|     * at depth 0 call account "All" (and fix register) | *** register screen | ||||||
|     * 0 now limits depth to 0 instead of resetting it | **** registers can now include/exclude subaccount transactions. | ||||||
|     * briefer footer help |      The register screen now includes subaccounts' transactions if the | ||||||
|     * more detailed help dialog, including manual |      accounts screen was in tree mode, or when showing an account | ||||||
|     * help dialog uses full terminal width when narrow |      which was at the depth limit. Ie, it always shows the | ||||||
|     * a key runs the add command |      transactions contributing to the balance displayed on the | ||||||
|     * ESC key cancels minibuffer/help or clears filter and jumps to top |      accounts screen. As on the accounts screen, F toggles between | ||||||
|     * / key sets the filter query; backspace/delete clears it |      tree mode/subaccount txns included by default and flat | ||||||
|       I was planning to use this for search, but I can't help it, my hands |      mode/subaccount txns excluded by default. (At least, it does when | ||||||
|       want to use / to adjust the filter. |      it would make a difference.) | ||||||
|     * U key shows only uncleared transactions/postings | **** register transactions are filtered by realness and status (#354). | ||||||
|     * accounts, register: Z key toggles zero items (--empty), and they are shown by default |      Two fixes for the account transactions report when --real/--cleared/real:/status:  | ||||||
|       -E/--empty is now the default for hledger-ui, so accounts with 0 balance |      are in effect, affecting hledger-ui and hledger-web: | ||||||
|       and transactions posting 0 change are shown by default.  The Z key |  | ||||||
|       toggles this, entering "nonzero" mode which hides zero items. |  | ||||||
|     * accounts, register: R key toggles --real |  | ||||||
|     * show historical or periodic balances (#392). |  | ||||||
|       hledger-ui now shows historical balances by default (like balance --historical). |  | ||||||
|       `H` toggles between "historical" and "period" modes, on the accounts and register screens. |  | ||||||
|     * ui, web: register transactions are filtered by realness and status (#354). |  | ||||||
|       Two fixes for the account transactions report when --real/--cleared/real:/status:  |  | ||||||
|       are in effect, affecting hledger-ui and hledger-web: |  | ||||||
|      |      | ||||||
|       1. exclude transactions which affect the current account via an excluded posting type. |      1. exclude transactions which affect the current account via an excluded posting type. | ||||||
|          Eg when --real is in effect, a transaction posting to the current account with only |         Eg when --real is in effect, a transaction posting to the current account with only | ||||||
|          virtual postings will not appear in the report. |         virtual postings will not appear in the report. | ||||||
| 
 | 
 | ||||||
|       2. when showing historical balances, don't count excluded posting types in the |      2. when showing historical balances, don't count excluded posting types in the | ||||||
|          starting balance. Eg with --real, the starting balance will be the sum of only the |         starting balance. Eg with --real, the starting balance will be the sum of only the | ||||||
|          non-virtual prior postings. |         non-virtual prior postings. | ||||||
| 
 | 
 | ||||||
|       This is complicated and there might be some ways to confuse it still, causing |         This is complicated and there might be some ways to confuse it still, causing | ||||||
|       wrongly included/excluded transactions or wrong historical balances/running totals |         wrongly included/excluded transactions or wrong historical balances/running totals | ||||||
|       (transactions with both real and virtual postings to the current account, perhaps ?) |         (transactions with both real and virtual postings to the current account, perhaps ?) | ||||||
|     * more efficient wording in header; historical/period and tree/flat are now indicated in the footer | **** show more accurate dates when postings have their own dates. | ||||||
|     * the enter key has been reserved for later and is no longer an alias for right/l |      If postings to the register account matched by the register's | ||||||
|     * I (as in -I/--ignore-assertions) toggles balance assertions on or off, |      filter query have their own dates, we show the earliest of these | ||||||
|       allowing troubled journals to be viewed. |      as the transaction date. | ||||||
|     * preserve --ignore-assertions, --pivot, aliases and other options on reload |  | ||||||
|     * reloading on the error screen now updates the message rather |  | ||||||
|       than entering a new error screen |  | ||||||
|     * switch to the quicker-building microlens |  | ||||||
|     * set report period from date: query args, also. |  | ||||||
|       A date2: query or --date2 flag might also affect it somehow (untested). |  | ||||||
|     * easy period selection and navigation:  |  | ||||||
| 
 | 
 | ||||||
|       - shift-down narrows to the next smaller standard period | *** misc | ||||||
|         (year/quarter/month/week/day), shift-up does the reverse | **** H toggles between showing "historical" or "period" balances (#392). | ||||||
|       - when narrowed to a standard period, shift-right/left moves to |      By default hledger-ui now shows historical balances, which | ||||||
|         the next/previous period |      include transactions before the report start date (like hledger | ||||||
|       - `t` sets the period to today. |      balance --historical). Use the H key to toggle to "period" mode, | ||||||
|     * always use --no-elide for a more regular accounts tree |      where balances start from 0 on the report start date. | ||||||
|     * more accurate register dates when postings have their own dates (see hledger-lib account transactions report) | **** shift arrow keys allow quick period browsing | ||||||
| 
 |  | ||||||
|     * The register screen now includes subaccounts' transactions if |  | ||||||
|       the accounts screen was in tree mode, or when showing an account |  | ||||||
|       which was at the depth limit. Ie, it always shows the |  | ||||||
|       transactions contributing to the balance displayed on the |  | ||||||
|       accounts screen. As on the accounts screen, F toggles tree |  | ||||||
|       (subaccount txns included by default) or flat (subaccount txns |  | ||||||
|       excluded by default) mode. (At least, it does when it would make |  | ||||||
|       a difference.) |  | ||||||
| 
 | 
 | ||||||
|  |      - shift-down narrows to the next smaller standard period | ||||||
|  |        (year/quarter/month/week/day), shift-up does the reverse | ||||||
|  |      - when narrowed to a standard period, shift-right/left moves to | ||||||
|  |        the next/previous period | ||||||
|  |      - `t` sets the period to today. | ||||||
|  | **** a runs the add command | ||||||
|  | **** E runs $HLEDGER_UI_EDITOR or $EDITOR or a default editor (vi) on the journal file. | ||||||
|  |      When using emacs or vi, if a transaction is selected the cursor will be positioned at its journal entry. | ||||||
|  | **** / key sets the filter query; BACKSPACE/DELETE clears it | ||||||
|  | **** Z toggles display of zero items (like --empty), and they are shown by default. | ||||||
|  |      -E/--empty is now the default for hledger-ui, so accounts with 0 balance | ||||||
|  |      and transactions posting 0 change are shown by default.  The Z key | ||||||
|  |      toggles this, entering "nonzero" mode which hides zero items. | ||||||
|  | **** R toggles inclusion of only real (non-virtual) postings | ||||||
|  | **** U toggles inclusion of only uncleared transactions/postings | ||||||
|  | **** I toggles balance assertions checking, useful for troubleshooting | ||||||
|  | **** vi-style movement keys are now supported (for help, you must now use ? not h) (#357) | ||||||
|  | **** ESC cancels minibuffer/help or clears the filter query and jumps to top screen | ||||||
|  | **** ENTER has been reserved for later use | ||||||
|  | **** reloading now preserves any options and modes in effect | ||||||
|  | **** reloading on the error screen now updates the message rather than entering a new error screen | ||||||
|  | **** the help dialog is more detailed, includes the hledger-ui manual, and uses the full terminal width if needed | ||||||
|  | **** the header/footer content is more efficient; historical/period and tree/flat modes are now indicated in the footer | ||||||
|  | **** date: query args on the command line now affect the report period. | ||||||
|  |      A date2: arg or --date2 flag might also affect it (untested). | ||||||
|  | **** hledger-ui now uses the quicker-building microlens | ||||||
| ** hledger-web 0.28 | ** hledger-web 0.28 | ||||||
|     * possible fix for filtering register by realness and status (see hledger-ui) | *** ui | ||||||
|     * Added .btn-default to unify buttons across browsers (#418) (Dominik Süß) | **** show the sidebar by default (#310) | ||||||
|     * update wai-handler-launch for better startup (fixes #226) | **** fix the add link's tooltip | ||||||
|     * show a proper not found page on 404 | **** when the add form opens, focus the first field (#338) | ||||||
|     * focus the first field after clicking add a transaction (fixes #338) | **** leave the add form's date field blank, avoiding a problem with tab clearing it (#322) | ||||||
|     * fix the add a transaction link's tooltip | **** use transaction id instead of date in transaction urls (#308) (Thomas R. Koll) | ||||||
|     * preserve initial command-line query when journal file is changed (#314). | **** after following a link to a transaction, highlight it (Thomas R. Koll) | ||||||
|       The initial query specified by command line arguments is now preserved | **** misc. HTML/CSS/file cleanups/fixes (Thomas R. Koll) | ||||||
|       when the journal is reloaded. This does not appear in the web UI, it's | **** added .btn-default for consistent button styling across browsers (#418) (Dominik Süß) | ||||||
|       like an invisible extra filter. | *** misc | ||||||
|     * leave date field blank, avoid problems with tab clearing it (#322) | **** startup is more robust (#226). | ||||||
|     * exit if something is already using the specified port (#226) |      Now we exit if something is already using the specified port, | ||||||
|     * don't open a browser page until the app is ready (#226) |      and we don't open a browser page before the app is ready. | ||||||
|     * Terminate the server thread more carefully on exit, eg on control-C | **** termination is more robust, avoiding stray background threads. | ||||||
|       in GHCI. May prevent stray background threads on windows. |      We terminate the server thread more carefully on exit, eg on control-C in GHCI. | ||||||
|     * show the sidebar by default (#310) | **** more robust register dates and filtering in some situations (see hledger-ui notes) | ||||||
|     * after following a link to a transaction, highlight it (Thomas R. Koll) | **** reloading the journal preserves options, arguments in effect (#314). | ||||||
|     * use numeric id instead of date for linking to transactions #308 (Thomas R. Koll) |      The initial query specified by command line arguments is now preserved | ||||||
|     * misc. HTML/CSS/file cleanups/fixes (Thomas R. Koll) |      when the journal is reloaded. This does not appear in the web UI, it's | ||||||
|     * keep aliases and pivot in effect when reloading the journal |      like an invisible extra filter. | ||||||
|     * document the special `inacct:` query (#390) | **** show a proper not found page on 404 | ||||||
|     * more accurate register dates when postings have their own dates (see hledger-lib account transactions report) | **** document the special `inacct:` query (#390) | ||||||
| 
 |  | ||||||
| ** hledger-api 0.28 | ** hledger-api 0.28 | ||||||
|     * new hledger-api tool: a simple web API server with example clients (#316) | *** misc | ||||||
|     * start an Angular-based API example client (#316) (Thomas R. Koll) | **** new hledger-api tool: a simple web API server with example clients (#316) | ||||||
|  | **** start an Angular-based API example client (#316) (Thomas R. Koll) | ||||||
| 
 | 
 | ||||||
| * notes | 
 | ||||||
| release commits by time | # NOTES: | ||||||
| git ll 0.27.. | # release commits by time | ||||||
| release commits by component: | # git ll 0.27.. | ||||||
| git ll 0.27.. | sort -k3 -f, sort --reverse each part | # release commits by component: | ||||||
|  | # git ll 0.27.. | sort -k3 -f, sort --reverse each part | ||||||
|  | |||||||
		Loading…
	
		Reference in New Issue
	
	Block a user