penny-bin-0.6.0.0: man/penny-reconcile.1

.TH penny-reconcile 1

.SH NAME
penny-reconcile - mark cleared postings as reconciled

.SH SYNOPSIS
.B penny-reconcile
FILE...

.SH DESCRIPTION
Finds all postings in the input ledger files whose flag is exactly one
letter: the letter
.IR C .
Changes those flags to the letter
.I R
and prints the resulting ledger to standard output. This is useful
when reconciling a financial institution account: you may first mark
postings in your ledger that match a posting on your bank statement
with a
.I C
flag. Because only postings from the current statement will be marked with a
.I C
flag, it is easier to use
.BR penny (1)
to list only the postings that you have just cleared.  Then, after
ensuring that the statement is properly reconciled,
.B penny-reconcile
will automatically mark all the posts reconciled.

If no
.IR FILE ", or " FILE " is " - ,
read standard input.

.SH VERSUS sed(1) OR YOUR TEXT EDITOR
You could do this with
.BR sed (1)
or your text editor. Unlike those programs,
.B penny-reconcile
knows the structure of a ledger file. So
.B penny-reconcile
will not, for example, change the text
.IR [C] " to " [R]
where the
.I [C]
appears within a comment, while a naive
.BR sed (1)
script would do so. This would happen only rarely though, so you might
be just fine using a query-replace function in your text editor.

Also,
.B penny-reconcile
will tidy up your ledger file--that is, it might rearrange or delete
the non-significant whitespace within a transaction and posting, similar to
.BR penny-reprint (1).
This might be good or bad.
.BR sed (1)
or your text editor, on the other hand, will not do this.

.SH EXIT STATUS
0 if everything went fine; some other value if something went wrong
(e.g. a ledger file could not be parsed.)

.SH BUGS
Please report bugs in the program or documentation to
.MT omari@smileystation.com
Omari Norman.
.ME

.SH SEE ALSO
.BR penny-suite (7)