From 8847c9aeb6f1042d1d7bd809fcfcd392cdccd7ee Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Wed, 26 Nov 2025 13:48:43 -0800 Subject: [PATCH] ;doc:changelogs --- doc/CHANGES.md | 54 ++++++++----- hledger-lib/CHANGES.md | 33 +++++++- hledger-ui/CHANGES.md | 24 +++++- hledger-web/CHANGES.md | 26 +++++- hledger/CHANGES.md | 179 ++++++++++++++++++++++++++++++++++++++++- 5 files changed, 291 insertions(+), 25 deletions(-) diff --git a/doc/CHANGES.md b/doc/CHANGES.md index 300c1a694..0951a5cbf 100644 --- a/doc/CHANGES.md +++ b/doc/CHANGES.md @@ -18,42 +18,54 @@ General changes in the hledger project. For package-specific changes, see the hledger package changelogs. -# 7e885134 +# fc85fa26 -Doc updates +Docs updated -- AUTHORS.md: move to doc/ -- ANNOUNCE.short: rename -- CHANGES.md: move to doc/, for easy consistent paths +- ACHIEVEMENTS +- ANNOUNCE.short +- AUTHORS +- bin/README +- CHANGES.md: move to doc/ for consistent paths - Contributing: mention translation (Lý Minh Nhật) -- DOCS, doc-update.png: document & diagram latest doc update procedures -- relnotes: use more reliable changelog links -- tldr/README -- RELEASING -- REGRESSIONS -- RELEASING: updates, formatting - DECISIONS +- dev +- DOCS: document & diagram latest doc update procedures - ISSUES +- REGRESSIONS +- RELEASING +- relnotes: more reliable changelog links +- ROADMAP +- tldr/README Website Infrastructure/Misc -- use a nightly branch instead of a nightly tag again on github, it's simpler +- add performance tests, logged to perf.log, run by just perftest +- bump stack snapshots +- drop the hledger-install script +- just changelogs* update +- just docupdatediag +- just ghci-ui: :main (and :rmain) now works again +- just ghnightly* -> nightly* +- just oldest +- just releasediag update +- just rels-major +- just site-restart +- Justfile reorg, cleanups - release script updates -- ;pkg:stack98: restore needed encoding 0.10 extra dep -- ;tools: update just releasediag, add just docupdatediag -- ;tools:just ghnightly* -> nightly* -- ;tools:just: reorganise, cleanups -- ;tools:Shake manuals: more contributor instructions in the header comment [hledger_site#140] +- Shake manuals: more contributor instructions in the header comment [hledger_site#140] - stack92: add valid hashtables version - stack94: add valid hashtables version - stack96: add valid hashtables version - stack98: include valid hashtables version - -- bump stack snapshots -- drop the hledger-install script -- just ghci-ui: :main (and :rmain) now works again +- stack98: restore needed encoding 0.10 extra dep +- stop git ignoring site/src/, allowing web docs to be easily opened in vscode +- tools/relnotes.hs update +- use a nightly branch instead of a nightly tag on github, it's simpler +- workflows: use shelltestrunner 1.11 +- workflows:binaries-mac-x64: switch to macos-15-intel # 1.50.3 2025-11-18 diff --git a/hledger-lib/CHANGES.md b/hledger-lib/CHANGES.md index efd54dd85..e1f7f52d3 100644 --- a/hledger-lib/CHANGES.md +++ b/hledger-lib/CHANGES.md @@ -17,7 +17,38 @@ API/developer-ish changes in hledger-lib. For user-visible changes, see the hledger package changelog. -# 7e885134 +# fc85fa26 + +- ;doc: add the 1.50.3 changelogs + +- dev: balanceTransaction -> balanceSingleTransaction + +- imp:lib:Hledger.Read: safer defaultJournal* functions + +- fix!: error if LEDGER_FILE points to a nonexistent file [#2485] + Avoiding potentially confusing silent fallback. Also, + + - Drop support for Ledger's legacy LEDGER environment variable; + we now support only LEDGER_FILE, for simplicity. + + - Clarify the behaviour, eg when a glob pattern matches multiple files + or when the value is empty. + +- fix:journal: repair 1.50's journal reading slowness [#2493] + Since 1.50, sourceFilePath, which does IO operations, was being called for every item in the journal. + On my machine this was causing a ~40% slowdown, + but probably it could be more depending on storage system. + + Now it's once again called only once per include directive. + Speed seems slightly better now than 1.43 for some reason + (eg: 13k txns/s -> 8k txns/s -> 14k txns/s). + +- ;doc: update embedded manuals + +- ;doc:changelogs + + + Breaking changes diff --git a/hledger-ui/CHANGES.md b/hledger-ui/CHANGES.md index b1337b782..3f58af138 100644 --- a/hledger-ui/CHANGES.md +++ b/hledger-ui/CHANGES.md @@ -23,7 +23,29 @@ User-visible changes in hledger-ui. See also the hledger changelog. -# 7e885134 +# fc85fa26 + +- ;doc: add the 1.50.3 changelogs + +- imp:cli,ui,web: always build with -threaded [#2495] + It's required for runPager and presumably for the web server among + other things. The old "threaded" build flag has been dropped. + +- fix:pkg: make threaded (and dev and library-only) build flags manual [#2495] + The threaded runtime is required at least for hledger's pager output, + and probably for other things. It's controlled by the "threaded" build + flag for some historical reason. Now, that flag is marked as manual, + so that it can no longer be toggled by cabal. (Probably the build flag + should be dropped, that can be tried later.) + + Related: Debian bug #1120833, causing an unusable hledger-1.50.2 package. + +- ;doc: update embedded manuals + +- ;doc:changelogs + + + Breaking changes diff --git a/hledger-web/CHANGES.md b/hledger-web/CHANGES.md index 799035ba1..eaca3b6c2 100644 --- a/hledger-web/CHANGES.md +++ b/hledger-web/CHANGES.md @@ -23,7 +23,31 @@ User-visible changes in hledger-web. See also the hledger changelog. -# 7e885134 +# fc85fa26 + +- ;doc: add the 1.50.3 changelogs + +- dev: balanceTransaction -> balanceSingleTransaction + +- imp:cli,ui,web: always build with -threaded [#2495] + It's required for runPager and presumably for the web server among + other things. The old "threaded" build flag has been dropped. + +- fix:pkg: make threaded (and dev and library-only) build flags manual [#2495] + The threaded runtime is required at least for hledger's pager output, + and probably for other things. It's controlled by the "threaded" build + flag for some historical reason. Now, that flag is marked as manual, + so that it can no longer be toggled by cabal. (Probably the build flag + should be dropped, that can be tried later.) + + Related: Debian bug #1120833, causing an unusable hledger-1.50.2 package. + +- ;doc: update embedded manuals + +- ;doc:changelogs + + + Breaking changes diff --git a/hledger/CHANGES.md b/hledger/CHANGES.md index bdc27aa84..faee6ed09 100644 --- a/hledger/CHANGES.md +++ b/hledger/CHANGES.md @@ -26,7 +26,175 @@ API User-visible changes in the hledger command line tool and library. -# 7e885134 +# fc85fa26 + +- pkg:Dockerfile: a likely fix, not tested + +- ;dev: add performance tests, logging to perf.log, run by just perftest + +- ;doc: update embedded manuals + +- ;doc: update command docs + +- imp:stats: one-line mode; fix -o; doc updates + The new -1 flag prints a single line of output in machine-friendly + tab-separated format, including the program version, journal file + name, and performance stats. + + Also -o now redirects all output, including the performance stats. + +- ;doc:csv: CSV fields and hledger fields: edits + +- ;doc:csv: CSV fields and hledger fields: edits + +- ;doc:csv: Regular expressions in CSV rules: edits + +- ;doc:csv: Regular expressions in CSV rules: edits + +- ;doc:csv: Regular expressions in CSV rules + +- ;doc:csv: CSV fields and hledger fields + +- ;doc: update embedded manuals + +- ;doc: update command docs + +- ;dev: update internal error message + +- fix:add: clean up typos after an over-eager search-replace + +- ;doc: add the 1.50.3 changelogs + +- dev:add: refactor, simplify names + +- dev: balanceTransaction -> balanceSingleTransaction + +- ;dev:test:errors: make csvnoinclude test more robust + It was failing on github's machines. + +- ;dev:add: add missing test file + +- ;dev:test:errors: readme + +- ;doc: Setting LEDGER_FILE: update + +- ;dev:tests:errors: update readme, tests + +- imp:setup: tidier output for missing LEDGER_FILE or default file + +- fix!: error if LEDGER_FILE points to a nonexistent file [#2485] + Avoiding potentially confusing silent fallback. Also, + + - Drop support for Ledger's legacy LEDGER environment variable; + we now support only LEDGER_FILE, for simplicity. + + - Clarify the behaviour, eg when a glob pattern matches multiple files + or when the value is empty. + +- ;doc:add: edits + +- ;doc:add: now balance assignment adding, as a separate commit + +- ;doc:add: don't mention balance assignment adding yet + It doesn't really belong in the upcoming minor release; but it got + committed along with a fix which does. + +- fix:add: check balance assertions more accurately; allow balance assignments [#2478] + Balance assertions are now checked more accurately, with awareness of + how everything is ordered in the journal. + Also, it's now possible to add balance assignments. + +- imp:cli,ui,web: always build with -threaded [#2495] + It's required for runPager and presumably for the web server among + other things. The old "threaded" build flag has been dropped. + +- fix:pkg: make threaded (and dev and library-only) build flags manual [#2495] + The threaded runtime is required at least for hledger's pager output, + and probably for other things. It's controlled by the "threaded" build + flag for some historical reason. Now, that flag is marked as manual, + so that it can no longer be toggled by cabal. (Probably the build flag + should be dropped, that can be tried later.) + + Related: Debian bug #1120833, causing an unusable hledger-1.50.2 package. + +- ;doc:csv:if: link skip, end more clearly + +- ;doc:print: note another way print can disrupt journal readability + (same-day balance assertions) + +- ;doc:add: balance assertions/assignments: edits [#2494] + +- ;doc:add: balance assertions/assignments: clarify, fix [#2494] + +- ;doc:csv:source: wording + +- ;doc:areg: edits + +- ;doc:areg: formatting + +- ;doc:check: edits, correction + +- imp: Show parent accounts in tree mode for context (samahri) + +- fix: html: Nested tables resulting in broken HTML on export (Joschua Kesper) + A HTML export results in a table which has a stylesheet and another table + nested inside. This is not valid HTML and gets auto corrected by closing the + first table and opening another table. The result is the heading of the table + can expand further than the remaining table. + + This results in a few notable changes: + + - The date is in a far bigger cell and it's very noticeable it's centered compared to the amounts + (we may want to right align the date, though I don't have any particular thoughts about this) + - We no longer have two consecutive lines with black background and the start + - The table is as big as the heading (+ the default left margin) + +- Summary: ;doc:Value reporting: edits + +- Summary: ;doc:Value reporting: edits + +- ;doc:Value reporting: more advice, examples for COMM + +- ;doc:Value reporting: warn about -V, emphasise -X + +- ;doc:check: edit + +- ;doc:check: edit + +- ;doc:check: edit + +- ;doc: update embedded manuals + +- ;fix:check:doc: drop obsolete note about transaction balancing + +- ;doc:argument files: edits + +- ;doc:argument files: edits + +- ;doc:argument files: corrections + +- ;fix:close:doc:customisation: edit [#2492] + +- ;fix:close:doc:customisation: edit [#2492] + +- ;fix:close:doc:customisation: clarify [#2492] + +- ;doc:depth: rewrite, note combining issue + +- ;doc:CHANGES, relnotes:hledger 1.33: fix typo + +- ;doc: Setting LEDGER_FILE: rewrite, new windows procedures + +- ;doc: demote COMMON TASKS subheadings + +- ;docs:manual: add info about the -c command line option in the commodity directy section (ooker) + +- ;imp:setup: accounts of all types wording + +- ;doc:changelogs + + + Breaking changes @@ -78,8 +246,17 @@ Docs Examples +- examples: organise/start the CSV rules library + Scripts/addons +- bin: hledger-check-buynothing +- bin: sortandmergepostings: Overhaul for more robust determinism (Caleb Maclennan) + - Avoids non-deterministic flip-flopping when the alphabetical account sort has multiple commodities + - Sorts postings commodities so commodities are in the same order across transactions + - Sorts postings with matching commodity by posting amount +- scripts: hledgerj1: example of a wrapper reading a custom format + API - Hledger.Cli.Utils: