doc, site: final 1.3 changelogs, release notes, announcement

[ci skip]
This commit is contained in:
Simon Michael 2017-07-01 18:56:57 +01:00
parent f40c19165d
commit 5ce66fb0de
5 changed files with 175 additions and 88 deletions

View File

@ -1,20 +1,17 @@
I'm pleased to announce hledger 1.2, on schedule. Thank you to
release contributors Peter Simons, Stefano Rodighiero, Moritz Kiefer,
Pia Mancini, Bryan Richter, Steven R. Baker, Hans-Peter Deifel, Joshua
Chia, Joshua Kehn, Michael Walker, and especially Mykola Orliuk and
Justin Le!
I'm pleased to announce hledger 1.3, released yesterday.
Thank you release contributors: Mykola Orliuk, Christian G. Warden,
Dmitry Astapov, Justin Le, Joe Horsnell, Nicolas Wavrant, afarrow,
Carel Fellinger, flip111, David Reaver, Felix Yan, Nissar Chababy, and
Jan Zerebecki.
Notable user-visible changes in this release:
new commands list,
more powerful balancesheet/incomestatement/cashflow commands,
more parseable print output,
better --pivot,
basic automated postings and periodic transactions support,
more and easier addons,
terminology/UI improvements for the status field,
selection/scrolling/movement improvements in hledger-ui,
negative amounts shown in red,
bugfixes.
Full release notes: http://hledger.org/release-notes#hledger-1.2
The next major release is scheduled for June 30.
Full release notes are at http://hledger.org/release-notes#hledger-1.3
The next major release is scheduled for September 30.
hledger (http://hledger.org) is a dependable, precise, cross-platform
program for tracking money, time, or any other commodity, using
@ -22,20 +19,30 @@ double-entry accounting and a simple plain text file format. It is a
haskell reimplementation of Ledger, provides command-line, curses and
web interfaces, and aims to be a robust, practical tool for daily use.
To install this release:
To get started, install the stack tool, eg by downloading from
http://haskell-lang.org/get-started. Then install hledger (and
optionally the alternate UIs):
Get stack, eg from http://haskell-lang.org/get-started
$ stack install --resolver=nightly hledger [hledger-ui] [hledger-web] [hledger-api]
$ ~/.local/bin/hledger
$ stack install hledger-lib-1.3 hledger-1.3 [hledger-ui-1.3] [hledger-web-1.3] [hledger-api-1.3]
(cabal experts can use that instead. See http://hledger.org/download
for more install options.)
Ensure $HOME/.local/bin is in your $PATH, and try some commands:
$ hledger # list commands
$ hledger -h # quick help
$ hledger --man # man page for the hledger CLI tool
$ hledger info journal # info manual for the journal format
etc.
or see http://hledger.org/download for more installation options.
Our IRC channel is #hledger on Freenode, and you can find out more at
http://hledger.org.
I hope you enjoy hledger and that it helps you achieve your goals.
If you have benefitted from hledger, please give back and make it stronger!
Donate using one of the funding links on the home page, give feedback,
report bugs, send pull requests, write about it, etc.
report bugs, send pull requests, write about it, or help in some other way.
Thanks for your support; I hope you enjoy hledger and that it helps you achieve your goals.
Best!
-Simon

View File

@ -2,9 +2,8 @@ Project-wide changes in the hledger project.
See also the package change logs.
# 1.1 (2016/12/31) and newer
see project changes at http://hledger.org/release-notes
# 1.1 (2016/12/31) and newer:
project changes are now kept at http://hledger.org/release-notes .
# 1.0.1 (2016/10/27)

View File

@ -4,20 +4,21 @@ See also the hledger and project change logs (for user-visible changes).
# 1.3 (2017/6/30)
Deps: allow megaparsec 5.3.
CSV conversion: assigning to the "balance" field name creates balance
assertions (#537, Dmitry Astapov).
Doubled minus signs are handled more robustly (fixes #524, Nicolas Wavrant, Simon Michael)
The "uncleared" transaction/posting status, and associated UI flags
journal: The "uncleared" transaction/posting status, and associated UI flags
and keys, have been renamed to "unmarked" to remove ambiguity and
confusion. This means that we have dropped the `--uncleared` flag,
and our `-U` flag now matches only unmarked things and not pending
ones. See the issue and linked mail list discussion for more
background. (#564)
Multiple status: query terms are now OR'd together. (#564)
csv: assigning to the "balance" field name creates balance
assertions (#537, Dmitry Astapov).
csv: Doubled minus signs are handled more robustly (fixes #524, Nicolas Wavrant, Simon Michael)
Multiple "status:" query terms are now OR'd together. (#564)
deps: allow megaparsec 5.3.
# 1.2 (2017/3/31)

View File

@ -4,11 +4,17 @@ See also the hledger and project change logs.
# 1.3 (2017/6/30)
Deps: allow brick 0.19 (#575, Felix Yan, Simon Michael)
The register screen now shows transaction status marks.
The P key toggles pending mode.
Also there is a temporary --status-toggles flag for testing different
toggle styles, see `hledger-ui -h`. (#564)
The "uncleared" status, and associated UI flags and keys, have been
renamed to "unmarked" to remove ambiguity and confusion. This means
that we have dropped the `--uncleared` flag, and our `-U` flag now
matches only unmarked things and not pending ones. See the issue and
linked mail list discussion for more background. (#564)
The P key toggles pending mode, consistent with U (unmarked) and C
(cleared). There is also a temporary --status-toggles flag for testing
other toggle styles; see `hledger-ui -h`. (#564)
There is now less "warping" of selection when lists change:
@ -23,8 +29,8 @@ There is now less "warping" of selection when lists change:
In the accounts and register screens, you can now scroll down further
so that the last item need not always be shown at the bottom of the
screen. Also we now try to center the selected item in the following
situations:
screen. And we now try to show the selected item centered in the
following situations:
- after moving to the end with Page down/End
- after toggling filters (status, real, historical..)
@ -32,17 +38,17 @@ situations:
- on entering the register screen from the accounts screen (there's a
known problem with this: it doesn't work the first time).
Items near the top of the list can't be centered, as we don't scroll
higher than the top of the list.
(Items near the top can't be centered, as we don't scroll higher than
the top of the list.)
Emacs movement keys are now supported, as well as VI keys.
hjkl and CTRL-bfnp should work wherever unmodified arrow keys work.
The register screen now shows transaction status marks.
In the transaction screen, amounts are now better aligned, eg when
there are posting status marks or virtual postings.
Deps: allow brick 0.19 (#575, Felix Yan, Simon Michael)
# 1.2 (2017/3/31)

View File

@ -57,26 +57,28 @@ change logs.
## 2017/6/30 hledger 1.3
***release notes to follow
***
***terminology/UI improvements for the status field,
selection/scrolling/movement improvements in hledger-ui,
negative amounts shown in red,
bugfixes.***
<!-- ([announcement](http://thread.gmane.org/gmane.comp.finance.ledger.hledger/1267)) -->
<!-- ([announcement](https://groups.google.com/d/topic/hledger/WgdTy3-a6sc/discussion)) -->
([announcement](https://groups.google.com/d/msg/hledger/X4iR1wpaq0E/_v5BLQIXAgAJ))
Release contributors:
<!-- Simon Michael, -->
<!-- Mykola Orliuk, -->
<!-- Justin Le, -->
<!-- Peter Simons, -->
<!-- Stefano Rodighiero, -->
<!-- Moritz Kiefer, -->
<!-- Pia Mancini, -->
<!-- Bryan Richter, -->
<!-- Steven R. Baker, -->
<!-- Hans-Peter Deifel, -->
<!-- Joshua Chia, -->
<!-- Joshua Kehn, -->
<!-- Michael Walker. -->
Simon Michael,
Mykola Orliuk,
Christian G. Warden,
Dmitry Astapov,
Justin Le,
Joe Horsnell,
Nicolas Wavrant,
afarrow,
Carel Fellinger,
flip111,
David Reaver,
Felix Yan,
Nissar Chababy,
Jan Zerebecki.
[project](#project-wide-changes-for-1.3)
| [hledger-lib](#hledger-lib-1.3)
@ -87,13 +89,13 @@ Release contributors:
### project-wide changes for 1.3
#### Packaging
<!-- #### Packaging -->
#### Finance
<!-- #### Finance -->
#### Documentation and website
<!-- #### Documentation and website -->
#### Examples
<!-- #### Examples -->
#### Tools
@ -109,49 +111,121 @@ make changelog-draft shows the commits since last tag as org nodes
#### journal format
#### ledger format
The "uncleared" transaction/posting status (and associated UI flags
and keys) has been renamed to "unmarked" to remove ambiguity and
confusion. See the issue and linked mail list discussion for more
background. (#564)
#### csv format
In CSV conversion rules, assigning to the "balance" field name
creates balance assertions (#537, Dmitry Astapov).
Doubled minus signs are handled more robustly (fixes #524, Nicolas
Wavrant, Simon Michael)
#### Misc
Multiple status: query terms are now OR'd together. (#564)
Deps: allow megaparsec 5.3.
### hledger 1.3
#### CLI
The "uncleared" transaction/posting status, and associated UI flags
and keys, have been renamed to "unmarked" to remove ambiguity and
confusion. This means that we have dropped the `--uncleared` flag,
and our `-U` flag now matches only unmarked things and not pending
ones. See the issue and linked mail list discussion for more
background. (#564)
Also the -P short flag has been added for --pending, and the -U/-P/-C
flags can be combined.
bs/is: fix "Ratio has zero denominator" error (#535)
bs/is/cf: fix --flat (#552) (Justin Le, Simon Michael)
bal/bs/is/cf: show negative amounts in red (Simon Michael, Justin Le).
These commands now shows negative amounts in red, when hledger detects
that ANSI codes are supported, (ie when TERM is not "dumb" and stdout
is not being redirected or piped).
print: show pending mark on postings (fixes #563).
A pending mark on postings is now displayed, just like a cleared mark.
Also there will now be a space between the mark and account name.
print: amounts are now better aligned, eg when there are posting
status marks or virtual postings
#### Addons
`make addons` compiles the experimental add-ons.
### addons
prices: add --inverted-costs flag, sort output, increase precision
(Mykola Orliuk)
make addons compiles the experimental add-ons
prices: add inverted-costs support and sort output (Mykola Orliuk)
prices: improve precision (Nikolay Orlyuk)
rewrite: Add Support for Rewriting Multipler Postings Into Different Commodities (#557) (Christian G. Warden)
When generating a new posting as a multiple of an existing posting,
support conversion to a different commodity. For example, postings in
hours can be used to generate postings in USD.
Automatic transactions generated from rewrite rules use the commodity,
amount style, and transaction price if the rewrite defines a
commodity.
#### balance
#### balancesheet/cashflow/incomestatement
#### print
#### Misc
rewrite: add support for rewriting multipler postings into different
commodities. For example, postings in hours can be used to generate
postings in USD. (#557) (Christian G. Warden)
### hledger-ui 1.3
The register screen now shows transaction status marks.
The "uncleared" status, and associated UI flags and keys, have been
renamed to "unmarked" to remove ambiguity and confusion. This means
that we have dropped the `--uncleared` flag, and our `-U` flag now
matches only unmarked things and not pending ones. See the issue and
linked mail list discussion for more background. (#564)
The P key toggles pending mode, consistent with U (unmarked) and C
(cleared). There is also a temporary --status-toggles flag for testing
other toggle styles; see `hledger-ui -h`. (#564)
There is now less "warping" of selection when lists change:
- When the selected account disappears, eg when toggling zero
accounts, the selection moves to the alphabetically preceding item,
instead of the first one.
- When the selected transaction disappears, eg when toggling status
filters, the selection moves to the nearest transaction by date (and
if several have the same date, by journal order), instead of the
last one.
In the accounts and register screens, you can now scroll down further
so that the last item need not always be shown at the bottom of the
screen. And we now try to show the selected item centered in the
following situations:
- after moving to the end with Page down/End
- after toggling filters (status, real, historical..)
- on pressing the control-l key (should force a screen redraw, also)
- on entering the register screen from the accounts screen (there's a
known problem with this: it doesn't work the first time).
(Items near the top can't be centered, as we don't scroll higher than
the top of the list.)
Emacs movement keys are now supported, as well as VI keys.
hjkl and CTRL-bfnp should work wherever unmodified arrow keys work.
In the transaction screen, amounts are now better aligned, eg when
there are posting status marks or virtual postings.
Deps: allow brick 0.19 (#575, Felix Yan, Simon Michael)
### hledger-web 1.3
Depends on hledger 1.3.
### hledger-api 1.3
Depends on hledger 1.3.
## 2017/3/31 hledger 1.2