doc: save 1.11 announcement

[ci skip]
This commit is contained in:
Simon Michael 2018-10-05 14:43:05 -10:00
parent 9c0648b46a
commit 30e0768e86

View File

@ -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