hledger/doc/ANNOUNCE

107 lines
3.7 KiB
Plaintext
Raw Normal View History

iHappy New Year all! I'm very pleased to announce hledger 1.5.
2017-12-31 23:53:51 +03:00
hledger (http://hledger.org) is a reliable, cross-platform program for
tracking money, time or other commodities, using double-entry
accounting and simple plain text file formats. It provides
command-line, curses and web interfaces, and aims to be a pleasant and
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.
2017-12-31 23:53:51 +03:00
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.
2016-10-28 04:01:34 +03:00
2017-12-31 23:53:51 +03:00
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).
2017-10-01 05:37:19 +03:00
What's new ?
------------
2017-12-31 23:53:51 +03:00
Some highlights from the release notes at http://hledger.org/release-notes#hledger-1.5 :
2017-10-01 05:37:19 +03:00
* Ledger-style automated posting rules to modify transactions, enabled
with --auto flag
2017-10-01 05:37:19 +03:00
* Ledger-style periodic transaction rules to generate forecast
transactions (--forecast) and budget goals
2017-10-01 05:37:19 +03:00
* a new budget report (balance --budget) comparing amounts with
per-period and per-account budget goals
2017-10-01 05:37:19 +03:00
* more expressive period expressions
2017-10-01 05:37:19 +03:00
* space can be used as digit group separator character in numbers
* commodity or default commodity directives give more control over
display precision and decimal point/digit group separator
2017-10-01 05:37:19 +03:00
2017-12-31 23:53:51 +03:00
Get started
-----------
2017-10-01 05:37:19 +03:00
2017-12-31 23:53:51 +03:00
See http://hledger.org/download for all install methods. Windows
users can download nightly binaries. On other platforms, you may need
to build the latest release yourself. The easiest and most reliable
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
installed cabal or stack if possible, otherwise installs stack and GHC
in $HOME/.local/bin and $HOME/.stack/). Here's the responsible way to
run it:
$ 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 # (add -v for more detail; use bash -x to show commands being run)
or the more convenient, less secure way:
$ curl https://raw.githubusercontent.com/simonmichael/hledger/master/hledger-install/hledger-install.sh | bash
or, to install individual tools:
$ stack install hledger-lib-1.5 hledger-1.5 # hledger-ui-1.5 hledger-web-1.5 hledger-api-1.5 etc.
or:
2017-10-01 05:37:19 +03:00
$ cabal update
$ cabal install hledger-1.5 # hledger-ui-1.5 hledger-web-1.5 hledger-api-1.5 etc.
2017-10-01 05:37:19 +03:00
2017-12-31 23:53:51 +03:00
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.
2017-10-01 05:37:19 +03:00
After installation, ensure $HOME/.local/bin is in your $PATH.
Now try some commands:
$ hledger -h # quick help
2017-10-01 05:37:19 +03:00
$ hledger help # list built-in manuals
$ hledger add # record some transactions
$ hledger # list available commands
Now perhaps work through the tutorial at http://hledger.org/step-by-step.html
2017-10-01 05:37:19 +03:00
Or review the fine documents, presentations etc. at http://hledger.org
and http://plaintextaccounting.org
2016-10-28 04:01:34 +03:00
2017-10-01 05:37:19 +03:00
Or say hello and ask questions in the #hledger IRC channel on Freenode:
http://irc.hledger.org
2017-12-31 23:53:51 +03:00
Wishing you a highly prosperous and serene 2018,
2016-10-28 04:01:34 +03:00
-Simon