add option to convert budget

[chaz/homebank2ledger] / bin / homebank2ledger

diff --git a/bin/homebank2ledger b/bin/homebank2ledger
index 2d46501656f33b8c9697a0025d7c6b9ae0f0d11e..1139928ea98c30dd8b8bdc86ef4f5a94e3903f09 100644 (file)
--- a/bin/homebank2ledger
+++ b/bin/homebank2ledger
@@ -4,12 +4,11 @@
 
 =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
@@ -18,12 +17,14 @@ C<homebank2ledger> converts L<HomeBank|http://homebank.free.fr/> files to a form
 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
 
@@ -116,6 +117,15 @@ Enables commodity declarations.
 
 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
@@ -123,12 +133,6 @@ needed) to support HomeBank's ability to configure accounts with opening balance
 
 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
@@ -204,7 +208,7 @@ it's just plain text.
 
 =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