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).

                                         November 11 2022                       cleartrans-cli(1)