X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fhomebank2ledger;a=blobdiff_plain;f=bin%2Fhomebank2ledger;h=1139928ea98c30dd8b8bdc86ef4f5a94e3903f09;hp=2d46501656f33b8c9697a0025d7c6b9ae0f0d11e;hb=1290bb7c0ee4c8fa6f962712b43207a0323b18a1;hpb=acbf9960f68f612f5ba8cfaaec2fb7fda27e20e2 diff --git a/bin/homebank2ledger b/bin/homebank2ledger index 2d46501..1139928 100644 --- 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 converts L files to a form L. It can also convert directly to the similar L format. -This software is B. 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, in early development. Its interface may change without notice. + +I wrote C 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 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