doc: ANNOUNCE

This commit is contained in:
Simon Michael 2018-06-30 22:32:01 +01:00
parent 948badd48c
commit 971139c62a
2 changed files with 46 additions and 63 deletions

View File

@ -1,90 +1,73 @@
hledger (http://hledger.org) is a reliable, cross-platform program for hledger (http://hledger.org) is a friendly, robust, cross-platform
tracking money, time or other commodities, using double-entry program for tracking money, time or other commodities, using
accounting and simple plain text file formats. It provides double-entry accounting, simple plain text file formats, and
command-line, curses and web interfaces, and aims to be a pleasant and command-line, curses or web UIs.
practical tool for personal, business or institutional use.
I'm pleased to announce hledger 1.9. The version jump signals some I'm very pleased to announce hledger 1.10, including work by release
noteworthy changes still landing (normal-positive reports, budget contributors:
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, Alex Chen,
Everett Hildenbrandt,
Jakub Zárybnický,
Nolan Darilek,
Dmitry Astapov,
Jacob Weisz,
Peter Simons, Peter Simons,
Christoph Nicolai, Stephen Morgan,
agander, Pavlo Kerestey,
M Parker, Trevor Riles,
Moritz Kiefer, Léo Gaspard,
Mykola Orliuk. Mykola Orliuk,
Wad,
Nana Amfo.
Highlights: 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.
* the "financial statement" commands bs/bse/cf/is now show all normal Please see http://hledger.org/release-notes#hledger-1.10 for the changes
balances as positive numbers, producing more conventional financial (as soon as I can get to those; until then, the package changelogs):
reports which are easier to share with others. (experimental)
* bal/bs/bse/cf/is can now generate HTML reports 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
* account codes can be used to customize account sorting
* numbers in scientific E-notation are supported, eg in journal and CSV data
* budget report improvements How to get started:
-------------------
* general report cleanups
More at http://hledger.org/release-notes#hledger-1.9 .
Get started:
------------
See http://hledger.org/download for all install methods. See http://hledger.org/download for all install methods.
Often, to get the latest release you will need to build it.
Here are some ways to do that:
Using the hledger-install script, which requires only bash and will One of the easiest is the hledger-install script, which requires only
build and install the hledger tools in $HOME/.local/bin/. bash and will build and install the hledger tools in $HOME/.local/bin/:
(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):
$ 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)
Using hledger-install the more convenient, less secure way: or (insecure):
$ 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
Using stack: After installation, ensure $HOME/.local/bin is in your $PATH, and try some commands:
$ stack install hledger-lib-1.9 hledger-1.9 # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9
Using cabal:
$ cabal update
$ cabal install hledger-1.9 # hledger-ui-1.9 hledger-web-1.9 hledger-api-1.9
After installation, ensure $HOME/.local/bin is in your $PATH.
Now try some commands:
$ hledger -h # quick help $ hledger -h # quick help
$ hledger help # list built-in manuals $ hledger help # list built-in manuals
$ hledger add # record some transactions $ hledger add # record some transactions
$ hledger # list available commands $ hledger # list available commands
Now perhaps work through the tutorial at Next, I encourage you to at least skim the tutorials and docs at
https://github.com/simonmichael/hledger/wiki/hledger-basics-tutorial. http://hledger.org.
Or review the fine documents at http://hledger.org and
http://plaintextaccounting.org. Or say hello and ask questions in the
#hledger IRC channel on Freenode: http://irc.hledger.org.
Get involved: 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 New users and contributors are always welcome! Give feedback, report
bugs, send pull requests, write about it, etc. And if you have been bugs, send pull requests, write, evangelise, donate.
finding hledger useful, consider becoming a sponsor or donor to help
to sustain and accelerate our progress (see home page).
Best!
-Simon

View File

@ -81,11 +81,11 @@ Jacob Weisz,
Peter Simons, Peter Simons,
Stephen Morgan, Stephen Morgan,
Pavlo Kerestey, Pavlo Kerestey,
trevorriles, Trevor Riles,
Léo Gaspard, Léo Gaspard,
Mykola Orliuk, Mykola Orliuk,
Wad, Wad,
Aerex. Nana Amfo.
<!-- [project](#project-wide-changes-for-1.10) --> <!-- [project](#project-wide-changes-for-1.10) -->
<!-- | [hledger-install](#hledger-install.sh-1.10) --> <!-- | [hledger-install](#hledger-install.sh-1.10) -->