=head1 SYNOPSIS
- homebank2ledger --input FILEPATH [--output FILEPATH]
- [--version|--help|--manual]
- [--format FORMAT] [--account-width NUM]
+ homebank2ledger --input FILEPATH [--output FILEPATH] [--format FORMAT]
+ [--version|--help|--manual] [--account-width NUM]
[--accounts|--no-accounts] [--payees|--no-payees]
[--tags|--no-tags] [--commodities|--no-commodities]
- [--opening-date DATE] [--default-account STR]
+ [--opening-date DATE]
[--rename-account STR]... [--exclude-account STR]...
=head1 DESCRIPTION
L<Ledger|https://www.ledger-cli.org/>. It can also convert directly to the similar
L<Beancount|http://furius.ca/beancount/> format.
-This software is B<EXPERIMENTAL>. I wrote it because I have been maintaining my own personal
-finances using HomeBank (which is awesome) and I wanted to investigate using plain text accounting
-programs which have great support for commodities. It works well enough for my data, but you may be
-using HomeBank features that I don't so there may be cases this doesn't handle well or at all. Feel
-free to file a bug report. This script does NOT try to modify the original HomeBank files it
-converts from, so there won't be any crazy data loss bugs... but no warranty.
+This software is B<EXPERIMENTAL>, in early development. Its interface may change without notice.
+
+I wrote C<homebank2ledger> because I have been maintaining my own personal finances using HomeBank
+(which is awesome) and I wanted to investigate using plain text accounting programs. It works well
+enough for my data, but you may be using HomeBank features that I don't so there may be cases this
+doesn't handle well or at all. Feel free to file a bug report. This script does NOT try to modify
+the original HomeBank files it converts from, so there won't be any crazy data loss bugs... but no
+warranty.
=head2 Features
Defaults to enabled; use C<--no-commodities> to disable.
+=head2 --budget
+
+Enables budget transactions.
+
+Budget transactions are only supported by the Ledger format (for now). This option is silently
+ignored otherwise.
+
+Defaults to enabled; use C<--no-budget> to disable.
+
=head2 --opening-date DATE
Specify the opening date for the "opening balances" transaction. This transaction is created (if
Date must be in the form "YYYY-MM-DD". Defaults to the date of the first transaction.
-=head2 --default-account STR
-
-Specify the account to use for one-sided transactions (if any). Defaults to "Expenses:No Category".
-
-A default account may be necessary because with Ledger all transactions are double-entry.
-
=head2 --rename-account STR
Specifies a mapping for renaming accounts in the output. By default C<homebank2ledger> tries to come
=for :list
* I didn't intend to make this a releasable robust product, so it's lacking tests.
-* Budgets and scheduled transactions are not (yet) converted.
+* Scheduled transactions are not (yet) converted.
* There are some minor formatting tweaks I will make (e.g. consolidate transaction tags and payees)
=cut