NAME¶

cleartrans-cli - interactively clear transactions in a ledger file

SYNOPSIS¶

cleartrans

DESCRIPTION¶

cleartrans-cli is a text program for quickly clearing transactions in a ledger file.

This program looks for all uncleared transactions in the ledger file, whose effective date is not in the future. For each such transaction, it asks whether the transaction should be cleared, and prompts for an effective date for the transaction.

The resulting ledger is written to a new file, and atomically renamed to the original filename. This prevents accidental loss of data.

The program must be supplied with location of the ledger file to work with. The location of the file is determined using the following mechanisms, in this order. The first mechanism which yields a result, wins.

ENVIRONMENT¶

The following environment variable is recognized by this program:

LEDGER_FILE

Path to ledger file to work with.

FILES¶

The config file for ledger(1), namely file .ledgerrc in user's home directory is scanned looking for the following option.

--file FILE

Path to ledger file to work with.

SEE ALSO¶

ledger(1), addtrans(1), sellstock-cli(1), sorttrans-cli(1), withdraw-cli(1).