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

[ci skip]

doc/ANNOUNCE

@@ -1,20 +1,17 @@
-I'm pleased to announce hledger 1.2, on schedule.  Thank you to
+I'm pleased to announce hledger 1.3, released yesterday.  
-release contributors Peter Simons, Stefano Rodighiero, Moritz Kiefer,
+Thank you release contributors: Mykola Orliuk, Christian G. Warden,
-Pia Mancini, Bryan Richter, Steven R. Baker, Hans-Peter Deifel, Joshua
+Dmitry Astapov, Justin Le, Joe Horsnell, Nicolas Wavrant, afarrow,
-Chia, Joshua Kehn, Michael Walker, and especially Mykola Orliuk and
+Carel Fellinger, flip111, David Reaver, Felix Yan, Nissar Chababy, and
-Justin Le!
+Jan Zerebecki.
 
 Notable user-visible changes in this release:
-new commands list,
+terminology/UI improvements for the status field,
-more powerful balancesheet/incomestatement/cashflow commands,
+selection/scrolling/movement improvements in hledger-ui,
-more parseable print output,
+negative amounts shown in red,
-better --pivot, 
-basic automated postings and periodic transactions support,
-more and easier addons,
 bugfixes.
 
-Full release notes: http://hledger.org/release-notes#hledger-1.2
+Full release notes are at http://hledger.org/release-notes#hledger-1.3
-The next major release is scheduled for June 30.
+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 hledger-lib-1.3 hledger-1.3 [hledger-ui-1.3] [hledger-web-1.3] [hledger-api-1.3]
-$ stack install --resolver=nightly hledger [hledger-ui] [hledger-web] [hledger-api]
+
-$ ~/.local/bin/hledger
+(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

doc/CHANGES

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

hledger-lib/CHANGES

@@ -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.
+journal: The "uncleared" transaction/posting status, and associated UI flags
-
-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
 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)

hledger-ui/CHANGES

@@ -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.
+The "uncleared" status, and associated UI flags and keys, have been
-Also there is a temporary --status-toggles flag for testing different
+renamed to "unmarked" to remove ambiguity and confusion.  This means
-toggle styles, see `hledger-ui -h`. (#564)
+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
+screen.  And we now try to show the selected item centered in the
-situations:
+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
+(Items near the top can't be centered, as we don't scroll higher than
-higher than the top of the list.
+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)
 

site/release-notes.md

@@ -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/msg/hledger/X4iR1wpaq0E/_v5BLQIXAgAJ))
-<!-- ([announcement](https://groups.google.com/d/topic/hledger/WgdTy3-a6sc/discussion))  -->
 
 Release contributors:
-<!-- Simon Michael, -->
+Simon Michael,
-<!-- Mykola Orliuk, -->
+Mykola Orliuk,
-<!-- Justin Le, -->
+Christian G. Warden,
-<!-- Peter Simons, -->
+Dmitry Astapov,
-<!-- Stefano Rodighiero, -->
+Justin Le,
-<!-- Moritz Kiefer, -->
+Joe Horsnell,
-<!-- Pia Mancini, -->
+Nicolas Wavrant,
-<!-- Bryan Richter, -->
+afarrow,
-<!-- Steven R. Baker, -->
+Carel Fellinger,
-<!-- Hans-Peter Deifel, -->
+flip111,
-<!-- Joshua Chia, -->
+David Reaver,
-<!-- Joshua Kehn, -->
+Felix Yan,
-<!-- Michael Walker. -->
+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
+rewrite: add support for rewriting multipler postings into different
-
+commodities. For example, postings in hours can be used to generate
-prices: add inverted-costs support and sort output (Mykola Orliuk)
+postings in USD. (#557) (Christian G. Warden)
-
-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
 
 ### 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