From 917700718eb394474e448deca7dd8a1289df404a Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Sun, 7 Sep 2025 08:31:27 +0100
Subject: [PATCH] ;bin: paypal*, simplefin*: add usage examples

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

diff --git a/bin/README.md b/bin/README.md
index c1ed91ea4..7e24ec9e8 100644
--- a/bin/README.md
+++ b/bin/README.md
@@ -54,6 +54,11 @@ downloads the last 30 days of Paypal transactions (requires a free developer acc
 [`paypalcsv`](https://github.com/simonmichael/hledger/blob/master/bin/paypalcsv) (python)
 converts `paypaljson`'s output to CSV, with format similar to Paypal's manually-downloaded CSV.
 
+Example usage with hledger 1.50+:
+call these in a CSV rules file like: `source | paypaljson | paypalcsv`.
+Or, do the download externally with `paypaljson >paypal.json`,
+then convert to CSV in the rules file: `source | paypalcsv paypal.json`.
+
 ### simplefinsetup
 
 [`simplefinsetup`](https://github.com/simonmichael/hledger/blob/master/bin/simplefinsetup)
@@ -69,6 +74,11 @@ downloads data for one or more bank accounts from SimpleFIN's API, as JSON.
 [`simplefincsv`](https://github.com/simonmichael/hledger/blob/master/bin/simplefincsv)
 converts SimpleFIN's JSON data to CSV, for one or more bank accounts.
 
+Example usage with hledger 1.50+:
+download multi-account JSON once with `simplefinjson >simplefin.json`,
+and in each account's CSV rules file, extract that account's CSV, eg:
+`source | simplefincsv simplefin.json 'wells fargo.*checking'`.
+
 ## hledger command line scripts
 
 These scripts use hledger's command line interface, or process one of its output formats.