Release 1.29.2 · simonmichael/hledger

Release notes (https://hledger.org/release-notes.html#hledger-1-29-2)

hledger 1.29.2

Breaking changes

1.29's cleanup of the close command has been continued.
Here are all the changes to close since hledger 1.28:
- The default behaviour is now to print only one transaction: a closing transaction.
- To print both closing and opening transactions as before,
  use the new --migrate flag.
- The accounts closed by default are now just the ALE accounts
  (accounts declared or inferred as type Asset, Liability, or Equity).
  If you don't have account types configured, or
  to close some other set of accounts, provide query arguments that match them.
  To close all accounts as before, use a . argument to match them all.
- To print a retain earnings transaction for RX accounts (accounts
  of type Revenue or Expense), use the new --retain flag.
- The equity command alias, removed in 1.29, has been restored.
- The --open-acct option, removed in 1.29, has been restored.
- The --closing and --opening flags have been renamed to --close and --open.
  (--close had been removed in 1.29 and is now restored.)
- The docs have been rewritten. Also the 1.29 release notes now mention
  the breaking change.
- The command is marked experimental again.
(#2020)

Fixes

type: queries now "see through" account aliases and pivots,
as they did in hledger <1.27, and as acct: queries do.
(#2018)
The corruption in 1.29's info manual is fixed. (#2023)
The 1.29 release notes for periodic reports'/periodic transactions' start dates
have been improved. Also the hledger manual's "Date adjustment" section
has been corrected and clarified.

hledger-ui 1.29.2

Improvements

A pager is used to show --help output when needed, as in hledger.

Fixes

The corruption in 1.29's info manual is fixed. (#2023)

hledger-web 1.29.2

Improvements

A pager is used to show --help output when needed, as in hledger.

Fixes

The corruption in 1.29's info manual is fixed. (#2023)

project changes 1.29.2

Scripts/addons

hledger-install: re-enable hledger-interest, hledger-iadd; add hledger-lots

credits 1.29.2

Simon Michael

Installing

At https://hledger.org/install, binary packages should be available for this release within a few days (look for green badges).

Or, you can build from source as described there, after cloning at tag 1.29.2:
git clone https://github.com/simonmichael/hledger --depth 1 -b 1.29.2

Or, if under "Assets" below there are release binaries suitable for your OS and hardware, you can use those.

Here are platform-specific instructions for the release binaries.
(You can copy & paste each block of commands as a unit to save time.):

GNU/Linux on 64-bit Intel

At the command line,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.29.2/hledger-linux-x64.zip   # can rerun if interrupted
unzip hledger-linux-x64.zip; tar xvf hledger-linux-x64.tar; rm hledger-linux-x64.{zip,tar}        # github workaround, preserves permissions
cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Mac on 64-bit Intel

In a terminal window,

cd /usr/local/bin
curl -LOC- https://github.com/simonmichael/hledger/releases/download/1.29.2/hledger-mac-x64.zip
unzip hledger-mac-x64.zip; tar xvf hledger-mac-x64.tar; rm hledger-mac-x64.{zip,tar}              # github workaround, preserves permissions
open .
# for the hledger, hledger-ui, hledger-web icons: right-click, Open, confirm it's ok to run
cd -
hledger --version  # should show the new version
touch $HOME/.hledger.journal   # ensure a default journal file exists

Windows on 64-bit Intel

In a powershell window (press Windows-r, type powershell, press enter),

Make a place to keep hledger binaries, and add it to your PATH; this makes running hledger easier. You only need to do this once, not for every release:

mkdir -force $HOME\bin >$null
$ENV:PATH += ";"+$HOME+"\bin"
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)+";"+$HOME+"\bin", [EnvironmentVariableTarget]::User)

Download and install the release binaries:

cd $HOME\bin
curl https://github.com/simonmichael/hledger/releases/download/1.29.2/hledger-windows-x64.zip -OutFile hledger-windows-x64.zip
Expand-Archive hledger-windows-x64.zip -DestinationPath .
rm hledger-windows-x64.zip
cd $HOME
hledger --version           # should show the new version

And ensure a default journal file exists:

out-file -append -encoding ascii $HOME/.hledger.journal

Problems:

Starting hledger/hledger-web by double-clicking their icon won't work; run them from a cmd or powershell window instead.

Windows 7 on 64-bit Intel, using Firefox

click hledger-windows-x64.zip below
choose Open with Windows Explorer, OK
click Extract all files
choose a destination folder - ideally one that appears in echo %PATH%, like C:\Windows (though that one will require administrator permission); otherwise, your home directory (C:\Users\YOURNAME)
check "Show extracted files when complete"
click Extract, wait for the destination folder to open
find the hledger, hledger-web icons (if you extracted to \Windows, you'll need to scroll down)
for each icon: double-click, uncheck "Always ask before opening this file", click Run
close those Explorer windows
open a command window (press Windows-r, type CMD, press enter)
hledger --version should show the new version
echo # >> .hledger.journal to ensure a default journal file exists. (Important: the doubled >> is needed to avoid overwriting existing data.)

Problems:

Starting hledger by double-clicking its icon won't work because it needs arguments; run it from the command window instead.
Starting hledger-web by double-clicking its icon may fail eg because Explorer's command window is too small;
configure that to be larger, or run hledger-web from a command window instead.
hledger or hledger-web may fail to run if there is not enough memory available.