doc: ANNOUNCE

This commit is contained in:
Simon Michael 2018-03-31 19:11:34 +01:00
parent 87abe50b11
commit be3497c1e5

View File

@ -1,4 +1,17 @@
iHappy New Year all! I'm very pleased to announce hledger 1.5. I'm pleased to announce hledger 1.9. The version jump signals some
noteworthy changes still landing (normal-positive reports, budget
reporting) which are a kind of preview of 2.0. The next major release,
on 2018/06/30, will be hledger 2.0.
Thank you to release contributors:
Eli Flanagan,
Peter Simons,
Christoph Nicolai,
agander,
M Parker,
Moritz Kiefer,
Mykola Orliuk.
hledger (http://hledger.org) is a reliable, cross-platform program for hledger (http://hledger.org) is a reliable, cross-platform program for
tracking money, time or other commodities, using double-entry tracking money, time or other commodities, using double-entry
@ -6,83 +19,57 @@ accounting and simple plain text file formats. It provides
command-line, curses and web interfaces, and aims to be a pleasant and command-line, curses and web interfaces, and aims to be a pleasant and
practical tool for personal, business or institutional use. practical tool for personal, business or institutional use.
A big thank you to the release contributors:
Dmitry Astapov,
Mykola Orliuk,
Eli Flanagan,
Elijah Caine,
Sam Jeeves,
Matthias Kauer,
Hans-Peter Deifel,
Mick Dekkers,
Nadrieril,
Alvaro Fernando García.
In 2017, four quarter-end releases were shipped on schedule,
and our feature set, marketing reach and contributor activity
continue to grow. The next release is scheduled for 2018/03/31.
New users and contributors are always welcome! Give feedback, report
bugs, send pull requests, write about it, etc. And if you have been
finding hledger useful, consider becoming a sponsor or donor to help
to sustain and accelerate our progress (see home page).
Our IRC channel is #hledger on Freenode (http://irc.hledger.org).
What's new ? What's new ?
------------ ------------
Some highlights from the release notes at http://hledger.org/release-notes#hledger-1.5 : Some highlights:
* Ledger-style automated posting rules to modify transactions, enabled * the "financial statement" commands bs/bse/cf/is now show all normal
with --auto flag balances as positive numbers, producing more conventional financial
reports which are easier to share with others. (experimental)
* Ledger-style periodic transaction rules to generate forecast * bal/bs/bse/cf/is can now generate HTML reports
transactions (--forecast) and budget goals
* a new budget report (balance --budget) comparing amounts with * account codes can be used to customize account sorting
per-period and per-account budget goals
* more expressive period expressions * numbers in scientific E-notation are supported, eg in journal and CSV data
* space can be used as digit group separator character in numbers * budget report improvements
* commodity or default commodity directives give more control over * general report cleanups
display precision and decimal point/digit group separator
More at http://hledger.org/release-notes#hledger-1.9 .
Get started Get started
----------- -----------
See http://hledger.org/download for all install methods. Windows See http://hledger.org/download for all install methods.
users can download nightly binaries. On other platforms, you may need Often, to get the latest release you will need to build it.
to build the latest release yourself. The easiest and most reliable Here are some ways to do that:
way is to run the hledger install script. This requires only bash and
will install the hledger tools in $HOME/.local/bin/. (It uses an Using the hledger-install script, which requires only bash and will
installed cabal or stack if possible, otherwise installs stack and GHC build and install the hledger tools in $HOME/.local/bin/.
in $HOME/.local/bin and $HOME/.stack/). Here's the responsible way to (Note: building haskell apps can take significant time, memory, and
run it: disk space, especially the first time. You can kill and restart the
installer without losing progress. If it fails, please help us
improve it by reporting the full output):
$ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh $ curl -O https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh
$ less hledger-install.sh # (do security review) $ less hledger-install.sh # (do security review)
$ bash hledger-install.sh # (add -v for more detail; use bash -x to show commands being run) $ bash hledger-install.sh # (add -v for more detail; use bash -x to show commands being run)
or the more convenient, less secure way: Using hledger-install the more convenient, less secure way:
$ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash $ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash
or, to install individual tools: Using stack:
$ stack install hledger-lib-1.5 hledger-1.5 # hledger-ui-1.5 hledger-web-1.5 hledger-api-1.5 etc. $ stack install hledger-lib-1.9 hledger-1.9 # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9
or: Using cabal:
$ cabal update $ cabal update
$ cabal install hledger-1.5 # hledger-ui-1.5 hledger-web-1.5 hledger-api-1.5 etc. $ cabal install hledger-1.9 # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9
Note: building haskell apps can take significant time, memory, and
disk space, especially the first time. You can kill and restart the
installer without losing progress. If it fails, please help us
improve it by reporting the full output.
After installation, ensure $HOME/.local/bin is in your $PATH. After installation, ensure $HOME/.local/bin is in your $PATH.
Now try some commands: Now try some commands:
@ -100,7 +87,8 @@ and http://plaintextaccounting.org
Or say hello and ask questions in the #hledger IRC channel on Freenode: Or say hello and ask questions in the #hledger IRC channel on Freenode:
http://irc.hledger.org http://irc.hledger.org
New users and contributors are always welcome! Give feedback, report
Wishing you a highly prosperous and serene 2018, bugs, send pull requests, write about it, etc. And if you have been
finding hledger useful, consider becoming a sponsor or donor to help
-Simon to sustain and accelerate our progress (see home page).
Our IRC channel is #hledger on Freenode (http://irc.hledger.org).