ledger balance: add description and pipe-usage

1 files changed, 15 insertions, 2 deletions

diff --git a/ledger/lib/balance b/ledger/lib/balance
index f75410c3..77cb7f6d 100755
--- a/ledger/lib/balance
+++ b/ledger/lib/balance
@@ -1,7 +1,20 @@
 #! /bin/awk -f
 #
-# usage: [colorize=false] [scale=N] //ledger/lib/balance LEDGER_FILE...
-# see also: //cholerab/ledger-spec.markdown
+# ledger balance calculator
+#
+# usage:
+#   [colorize=false] [scale=N] //ledger/lib/balance LEDGER_FILE...
+#   [colorize=false] [scale=N] //ledger/lib/balance < LEDGER_FILE
+#
+# description:
+#   The ledger balance calculator computes the balance of each account it
+#   encounters in the provided ledger files.
+#
+# example:
+#   //ledger/lib/balance < //cholerab/ledger-spec.markdown
+#
+# see also:
+#   //cholerab/ledger-spec.markdown (ledger file format)
 #
 
 BEGIN {