From 30e0768e865a5421b2f75da4241a8ce17863e9bc Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Fri, 5 Oct 2018 14:43:05 -1000 Subject: [PATCH] doc: save 1.11 announcement [ci skip] --- doc/ANNOUNCE | 106 +++++++++++++++++++++------------------------------ 1 file changed, 43 insertions(+), 63 deletions(-) diff --git a/doc/ANNOUNCE b/doc/ANNOUNCE index 5f53aa8c2..e0ef30524 100644 --- a/doc/ANNOUNCE +++ b/doc/ANNOUNCE @@ -1,73 +1,53 @@ -hledger (http://hledger.org) is a friendly, robust, cross-platform -program for tracking money, time or other commodities, using -double-entry accounting, simple plain text file formats, and -command-line, curses or web UIs. +Short announcement this quarter. Pleased to announce the release of hledger 1.11 on schedule! -I'm very pleased to announce hledger 1.10, including work by release -contributors: +Thanks to release contributors Joseph Weston, Dmitry Astapov, Gaith Hallak, Jakub Zárybnický, Luca Molteni, and SpicyCat. -Alex Chen, -Everett Hildenbrandt, -Jakub Zárybnický, -Nolan Darilek, -Dmitry Astapov, -Jacob Weisz, -Peter Simons, -Stephen Morgan, -Pavlo Kerestey, -Trevor Riles, -Léo Gaspard, -Mykola Orliuk, -Wad, -Nana Amfo. +stack users will need to get a copy of hledger source and do stack install from there, due to the recent GHC 8.6 release. cabal install hledger-1.11 should work normally. -You'll note this is not 2.0 as previously planned - we will spend a -bit more time on that. The next major release is expected to be on -2018/09/30. +From http://hledger.org/release-notes.html#hledger-1.11 : -Please see http://hledger.org/release-notes#hledger-1.10 for the changes -(as soon as I can get to those; until then, the package changelogs): +hledger 1.11 -http://hackage.haskell.org/package/hledger-1.10/changelog -http://hackage.haskell.org/package/hledger-ui-1.10/changelog -http://hackage.haskell.org/package/hledger-web-1.10/changelog -http://hackage.haskell.org/package/hledger-api-1.10/changelog -http://hackage.haskell.org/package/hledger-lib-1.10/changelog +- The default display order of accounts is now influenced by the order of account directives. Accounts declared by account directives are displayed first (top-most), in declaration order, followed by undeclared accounts in alphabetical order. Numeric account codes are no longer used, and are ignored and considered deprecated. + +- So if your accounts are displaying in a weird order after upgrading, and you want them alphabetical like before, just sort your account directives alphabetically. + +- Account sorting (by name, by declaration, by amount) is now more robust and supported consistently by all commands (accounts, balance, bs..) in all modes (tree & flat, tabular & non-tabular). + +- close: new –opening/–closing flags to print only the opening or closing transaction + +- files: a new command to list included files + +- prices: query arguments are now supported. Prices can be filtered by date, and postings providing transaction prices can also be filtered. + +- rewrite: help clarifies relation to print –auto (#745) + +- roi: a new command to compute return on investment, based on hledger-irr + +- test: has more verbose output, more informative failure messages, and no longer tries to read the journal + +- csv: We use a more robust CSV lib (cassava) and now support non-comma separators, eg –separator ‘;’ (experimental, this flag will probably become a CSV rule) (#829) + +- csv: interpolated field names in values are now properly case insensitive, so this works: + +- fields …,Transaction_Date,… date %Transaction_Date + +- journal: D (default commodity) directives no longer break multiplier amounts in transaction modifiers (AKA automated postings) (#860) + +- journal: “Automated Postings” have been renamed to “Transaction Modifiers”. + +- journal: transaction comments in transaction modifier rules are now parsed correctly. (#745) + +- journal: when include files form a cycle, we give an error instead of hanging. + +- upper-case day/month names in period expressions no longer give an error (#847, #852) +Corrections: -How to get started: -------------------- +- http://hledger.org has been updated with the latest install methods. -See http://hledger.org/download for all install methods. +- hledger-install.sh now ensures a new-enough stack. -One of the easiest is the hledger-install script, which requires only -bash and will build and install the hledger tools in $HOME/.local/bin/: - -$ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh -$ less hledger-install.sh # do security review -$ bash hledger-install.sh - -or (insecure; add -x flag to bash to see commands that were run): - -$ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash - -After installation, ensure $HOME/.local/bin is in your $PATH, and try some commands: - -$ hledger -h # quick help -$ hledger help # list built-in manuals -$ hledger add # record some transactions -$ hledger # list available commands - -Next, I encourage you to at least skim the tutorials and docs at -http://hledger.org. - -Say hello and ask questions in the #hledger IRC channel on Freenode: -http://irc.hledger.org. - -New users and contributors are always welcome! Give feedback, report -bugs, send pull requests, write, evangelise, help sustain us by donating. - - -Best! --Simon +- stack users don't need to fetch hledger source, but do need to specify an extra dep on the command line, eg like so: +stack install --resolver=lts-12 cassava-megaparsec-1.0.0 hledger-lib-1.11 hledger-1.11 hledger-ui-1.11 hledger-web-1.11 hledger-api-1.11