.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "ledger2beancount" "1" "2022-12-18"
.P
.P
.P
.SH NAME
.P
ledger2beancount - ledger to beancount converter
.P
.SH SYNOPSIS
.P
\fBledger2beancount\fR [options] \fIinput.\&ledger\fR > \fIoutput.\&beancount\fR
.P
\fBcat\fR \fIinput.\&ledger\fR | \fBledger2beancount\fR [options] > \fIoutput.\&beancount\fR
.P
.SH DESCRIPTION
.P
\fBledger2beancount\fR is a script to automatically convert
\fBledger\fR(1)-based textual ledgers to \fBbeancount\fR files.\&
.P
Conversion is based on (concrete) syntax, so that information that is
not meaningful for accounting reasons but still valuable (e.\&g.\&,
comments, formatting, etc.\&) can be preserved.\&
.P
.SH OPTIONS
.P
\fB-c, --config\fR
.RS 4
Specify a configuration file.\&  The options of the configuration
file are described in \fBledger2beancount\fR(5) and the
\fBledger2beancount\fR manual.\&
.P
.RE
\fB-h, --help\fR
.RS 4
Show help message and quit.\&
.P
.RE
\fB-V, --version\fR
.RS 4
Show version and quit.\&
.P
.RE
.SH USAGE
.P
\fBledger2beancount\fR accepts input from \fIstdin\fR or from a file and will
write the converted data to \fIstdout\fR.\&  You can run \fBledger2beancount\fR
like this on the example provided:
.P
.RS 4
\fBledger2beancount\fR \fIexamples/simple.\&ledger\fR > \fIsimple.\&beancount\fR
.P
.RE
After you convert your \fBledger\fR(1) file, you should validate the
generated beancount file with \fBbean-check\fR(1) and fix all errors:
.P
.RS 4
\fBbean-check\fR \fIsimple.\&beancount\fR
.P
.RE
You should also inspect the generated \fBbeancount\fR file to see if it
looks correct to you.\&  Please note that \fBledger2beancount\fR puts notes at
the beginning of the generated \fBbeancount\fR file if it encounters
problems with the conversion.\&
.P
.SH FILES
.P
\fI$PWD/.\&ledger2beancount.\&yaml\fR or \fI$PWD/ledger2beancount.\&yaml\fR
.RS 4
The configuration file for the current directory.\&
.P
.RE
\fI$XDG_CONFIG_HOME/ledger2beancount/config.\&yaml\fR (usually \fI$HOME/.\&config/ledger2beancount/config.\&yaml\fR)
.RS 4
The default configuration file.\&
.P
.RE
.SH BUGS
.P
If you find any bugs in \fBledger2beancount\fR or believe the conversion
from \fBledger\fR to \fBbeancount\fR could be improved, please open an issue on
GitHub:
.RS 4
https://github.\&com/beancount/ledger2beancount/issues
.P
.RE
Please include a small test case so we can reproduce the problem.\&
.P
.SH AUTHORS
.P
Stefano Zacchiroli and Martin Michlmayr
.P
.SH SEE ALSO
.P
\fBledger2beancount\fR(5), \fBledger\fR(1), \fBbean-check\fR(1)
.P
The full documentation for \fBledger2beancount\fR can be found in its manual.\&
.P