Release App-HomeBank2Ledger 0.007

[chaz/homebank2ledger] / README.md

diff --git a/README.md b/README.md
index 8c560b109ffd6a9ddbc888f0a9483df1ef68261a..83e193be8f47b5228f91eb483413116713487387 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ homebank2ledger - A tool to convert HomeBank files to Ledger format
 
 # VERSION
 
-version 0.001
+version 0.007
 
 # SYNOPSIS
 
@@ -12,7 +12,7 @@ version 0.001
                     [--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]...
 
 # DESCRIPTION
@@ -48,6 +48,43 @@ You can migrate the data you have in HomeBank so you can start maintaining your
 Or if you don't plan to switch completely off of HomeBank, you can continue to maintain your
 accounts in HomeBank and use this script to also take advantage of the reports Ledger offers.
 
+# INSTALL
+
+There are several ways to install `homebank2ledger` to your system.
+
+## using cpanm
+
+You can install `homebank2ledger` using [cpanm](https://metacpan.org/pod/cpanm). If you have a local perl (plenv, perlbrew, etc.),
+you can just do:
+
+    cpanm App::Homebank2Ledger
+
+to install the `homebank2ledger` executable and its dependencies. The executable will be installed
+to your perl's bin path, like `~/perl5/perlbrew/bin/homebank2ledger`.
+
+If you're installing to your system perl, you can do:
+
+    cpanm --sudo App::Homebank2Ledger
+
+to install the `homebank2ledger` executable to a system directory, like
+`/usr/local/bin/homebank2ledger` (depending on your perl).
+
+## Downloading just the executable
+
+You may also choose to download `homebank2ledger` as a single executable, like this:
+
+    curl -OL https://raw.githubusercontent.com/chazmcgarvey/homebank2ledger/solo/homebank2ledger
+    chmod +x homebank2ledger
+
+## For developers
+
+If you're a developer and want to hack on the source, clone the repository and pull the
+dependencies:
+
+    git clone https://github.com/chazmcgarvey/homebank2ledger.git
+    cd homebank2ledger
+    make bootstrap      # installs dependencies; requires cpanm
+
 # OPTIONS
 
 ## --version
@@ -119,6 +156,15 @@ Enables commodity declarations.
 
 Defaults to enabled; use `--no-commodities` to disable.
 
+## --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 `--no-budget` to disable.
+
 ## --opening-date DATE
 
 Specify the opening date for the "opening balances" transaction. This transaction is created (if
@@ -126,12 +172,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.
 
-## --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.
-
 ## --rename-account STR
 
 Specifies a mapping for renaming accounts in the output. By default `homebank2ledger` tries to come
@@ -205,7 +245,7 @@ it's just plain text.
 # CAVEATS
 
 - 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)
 
 # BUGS