From 6a9f2b5745dd2a6ba22f73777bb4094a5a354e47 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Mon, 20 Feb 2023 22:05:41 -1000
Subject: [PATCH] ;doc: bin/README: add hledger-fifo, improve hledger-utils

---
 bin/README.md | 46 ++++++++++++++++++++++++++++++++++++----------
 1 file changed, 36 insertions(+), 10 deletions(-)

diff --git a/bin/README.md b/bin/README.md
index ed867063f..5674e2425 100644
--- a/bin/README.md
+++ b/bin/README.md
@@ -104,31 +104,57 @@ $ hledger pijul status
 $ hledger pijul record [MSG]
 ```
 
+### hledger-fifo
+
+[`hledger-fifo`](https://github.com/edkedk99/hledger-fifo)
+shows a lots report, or generates a lot sale transaction, using FIFO strategy
+(and without needing subaccounts for lots).
+
+Install or upgrade:
+```
+$ pip install -U git+https://github.com/edkedk99/hledger-fifo
+```
+
+```cli
+$ hledger fifo
+$ hledger fifo lots -h
+$ hledger fifo lots
+$ hledger-fifo lots -c ADA -n 'closing balances'
+$ hledger fifo sell
+$ hledger fifo -- sell -c ADA -n 'closing balances' -b '$' -a assets:bank:checking -r 'revenues:capital gains' -d 2023-02-20 -q 100.23 -p 0.40
+```
+
 ### hledger-utils
 
-The [`hledger-utils` Python package](https://pypi.org/project/hledger-utils/) ships an `hledger edit` command to edit the queried transactions in your `$EDITOR` no matter what file they reside in:
+The [`hledger-utils` Python package](https://pypi.org/project/hledger-utils/) provides
+- a `hledger-edit` command to edit the queried transactions in your `$EDITOR` no matter what file they reside in
+- a `hledger-plot` command for generating charts with matplotlib.
 
+
+
+Install or upgrade:
+```shell
+$ pip install -U hledger-utils    # might be slightly different on your system
+```
+
+Examples:
 ```cli
 # Opens your $EDITOR or $VISUAL with only costs in Florida 
 # (if you named and tagged them like that)
 # edit the transactions, save and exit your editor, 
 # then the changes are distributed to the original files
 $ hledger edit Cost tag:location=Florida
-
+```
+```
 # Automate changes by setting `$EDITOR` to a script
 # (here all food we had on that one day in Florida was Fast Food 🌭 and we initially forgot to write that) 
 EDITOR='perl -pi -e "s|Cost:Food|Cost:Food:Fast Food|g"' hledger edit tag:location=Florida date:2022-12-20
 ```
-
-📹 Screencast
-
 [![asciicast](https://asciinema.org/a/549559.svg)](https://asciinema.org/a/549559)
 
-And also a useful `hledger plot` command for generating charts.
-
-To install or upgrade the hledger-utils tools:
-```shell
-$ pip install -U hledger-utils    # might be slightly different on your system
+```
+$ hledger-plot -h
+$ hledger plot -- bal -DH ^Assets -2
 ```
 
 ## hledger-integrated scripts