;doc: merge 1.31 changelogs

CHANGES.md

@@ -18,12 +18,18 @@ Infrastructure
 General changes in the hledger project.
 For package-specific changes, see the hledger package changelogs.
 
-# 79a1f1dd9
+# 1.31 2023-09-03
 
 Scripts/addons
 
+- ft, tt shell scripts for collecting financial and time reports
+
+- A justfile implementation of ft and tt
+
 Examples
 
+- self-tracking
+
 - RPG ledger (Eric Mertens)
 
 Docs
@@ -32,6 +38,27 @@ Infrastructure
 
 - tools, CI: checkembeddedfiles, checkversions
 
+- Shake: avoid making empty commits
+
+- make functest-PAT: runs a subset of functional tests
+
+- Provide a ghc-tags.yaml file to make use of ghc-tags with Hledger easy.
+
+  ghc-tags is a standalone tool to replace the formerly-built-in
+  ":ctags" feature (and I presume ":etags") in GHCi. These walked over
+  the source and produced a TAGS file (in vim-compatible ctags or
+  Emacs-compatible etags format) that allows the relevant editors to
+  quickly navigate around function definitions.
+
+  ghc-tags trips over some of the CPP used in Hledger. The solution
+  is to provide ghc-tags with explicit CPP defines via a YAML file.
+  However, if a YAML file is provided, one also must specify the source
+  paths, as the tool XORs config file | paths-on-command-line.
+
+  See <https://github.com/arybczak/ghc-tags/issues/6> for more
+  information.
+  (Jonathan Dowland)
+
 # 1.30 2023-06-01
 
 Scripts/addons

hledger-lib/CHANGES.md

@@ -13,12 +13,33 @@ Misc. changes
 Internal/api/developer-ish changes in the hledger-lib (and hledger) packages.
 For user-visible changes, see the hledger package changelog.
 
-# 79a1f1dd9
+# 1.31 2023-09-03
 
 Breaking changes
 
+- There is a new consolidated API for styling amounts, and a
+  convenient HasAmounts typeclass.  AmountStyle's fields have been
+  renamed/reordered more mnemonically, and setting the precision is
+  now optional.  (This simplifies the amount-stylingn code, but
+  complicates the semantics a little. When reading, an unset precision
+  generally behaves like NaturalPrecision.)
+
+- (Possible breaking change):
+  showMixedAmountLinesB, showAmountB, showAmountPrice now preserve
+  commodityful zeroes when rendering. This is intended to affect print output,
+  but it seems possible it might also affect balance and register reports,
+  though our tests show no change in those.
+
+- Renamed: journalAddInferredEquityPostings -> journalInferEquityFromCosts
+
 Misc. changes
 
+- Reports now do a final amount styling pass before rendering.
+
+- groupByDateSpan code cleanup (Jay Neubrand)
+
+- Allow aeson 2.2, megaparsec 9.5
+
 # 1.30 2023-06-01
 
 Breaking changes

hledger-ui/CHANGES.md

@@ -21,19 +21,11 @@ API
 User-visible changes in hledger-ui.
 See also the hledger changelog.
 
-# 79a1f1dd9
-
-Breaking changes
-
-Features
+# 1.31 2023-09-03
 
 Improvements
 
-Fixes
-
-Docs
-
-API
+- Allow megaparsec 9.5
 
 # 1.30 2023-06-01
 

hledger-web/CHANGES.md

@@ -21,19 +21,11 @@ API
 User-visible changes in hledger-web.
 See also the hledger changelog.
 
-# 79a1f1dd9
-
-Breaking changes
-
-Features
+# 1.31 2023-09-03
 
 Improvements
 
-Fixes
-
-Docs
-
-API
+- Allow aeson 2.2, megaparsec 9.5
 
 # 1.30 2023-06-01
 

hledger/CHANGES.md

@@ -21,35 +21,98 @@ API
 User-visible changes in the hledger command line tool and library.
 
 
-# f660e0327
-
-Breaking changes
-
-- More relaxed multicommodity transaction checking: 
-  hledger 1.29 and 1.30 were over-strict, raiding an error for
-  transactions with equity conversion postings whose matching
-  non-equity postings couldn't be auto-detected, even though otherwise valid.
-  This is no longer considered an error; such transactions are accepted,
-  and --infer-cost has no effect on them. This is similar to the behaviour
-  of --cost, --infer-equity, and --infer-market-prices.
-  (#2045)
+# 1.31 2023-09-03
 
 Features
 
-- Multipivot: --pivot now accepts multiple colon-delimited arguments,
-  to construct account names from multiple fields.
+- Multi-pivot: the --pivot option now accepts multiple arguments,
+  colon-delimited, to construct account names from multiple fields.
   (#2050, Eric Mertens)
 
 Improvements
 
-- With --pivot, `desc` is now the preferred spelling for
-  pivoting on description.
+- The `print` command now more closely replicates the original journal
+   amount styles, which is helpful when round-tripping / cleaning up
+   journal files:
+
+  - Amounts in conversion transactions could be displayed rounded to a
+    lower precision; this no longer happens.
+    (#2079)
+
+  - Amounts could be displayed with extra zeros after the decimal mark;
+    this no longer happens.
+
+  - Amounts could display with a different precision if the journal
+    included a timedot file; this no longer happens.
+
+  - Costs in balance assertions were not displayed with standard
+    styles like other amounts; now they are.
+
+  - Zero amounts were always shown as just "0"; now they are shown
+    with their original commodity symbol and style.  (And if an
+    inferred amount has multiple zeros in different commodities, a
+    posting is displayed for each of these.)
+  
+- `print` no longer displays numbers with a single digit group mark
+  and no decimal mark, which are ambiguous and hard to re-parse.  Now
+  if a number has digit group marks the decimal mark will always be
+  shown also.  Eg `1,000` (where the comma is a thousands separator)
+  is now shown as `1,000.`.
+
+- The check command's 
+  `balancedwithautoconversion` and `balancednoautoconversion` checks
+  have been renamed to `autobalanced` and `balanced`.
+
+- `hledger check recentassertions` now reports failures at the first
+  posting that's more than 7 days later than the latest balance
+  assertion (rather than at the balance assertion).  This is the thing
+  actually triggering the error, and it is more likely to be visible
+  or at least closer when you are working at the end of a journal
+  file.
+
+  Also, the suggested sample balance assertion now uses the same
+  commodity symbol as in the failing posting (the first, if there are
+  more than one); and, no longer includes a cleared mark.
+
+- The import command now shows the file path being imported to.
+
+- With --pivot, `desc` is now the preferred spelling for pivoting on
+  description.
+
+- The demo command now ignores an invalid journal file, like the other
+  HELP commands.
+
+- Debug output for equity conversion postings has been improved,
+  making troubleshooting easier.
+
+- Allow aeson 2.2, megaparsec 9.5.
 
 Fixes
 
-Docs
+- In journal files, valid multicommodity transactions where the
+  matching non-equity postings can't be auto-detected are no longer
+  considered an error (as they were in hledger 1.29 and 1.30).  Now,
+  such transactions are accepted, and --infer-cost has no effect on
+  them. This is similar to the behaviour of --cost, --infer-equity,
+  and --infer-market-prices.  (#2045)
 
-API
+- In journal files, equity conversion postings are now detected more
+  tolerantly, using the same precision as the conversion posting's
+  amount (#2041). Eg, the following transaction is now accepted:
+
+      2023-01-01
+          Assets               -84.01 USD @ 2.495 GEL
+		    ; ^ 209.60495 GEL, recognised as a match for the 209.60 below
+          Equity:Conversion     84.01 USD
+          Equity:Conversion   -209.60 GEL
+          Assets               209.60 GEL
+
+- The roi command now reports TWR per period and overall TWR for
+  multi-period reports.
+  (#2068, Dmitry Astapov)
+
+- The commands list no longer shows bar when hledger-bar is not installed (#2065),
+  and had a few other cleanups.
 
 # 1.30.1 2023-06-02