doc: ANNOUNCE
This commit is contained in:
parent
948badd48c
commit
971139c62a
105
doc/ANNOUNCE
105
doc/ANNOUNCE
@ -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
|
||||||
|
|||||||
@ -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) -->
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user