doc: ANNOUNCE
This commit is contained in:
parent
87abe50b11
commit
be3497c1e5
102
doc/ANNOUNCE
102
doc/ANNOUNCE
@ -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).
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user