From 74961ef05afc5d06d0af192752912466021882c4 Mon Sep 17 00:00:00 2001
From: tv <tv@nomic.retiolum>
Date: Wed, 11 Sep 2013 20:14:06 +0200
Subject: ledger balance: add description and pipe-usage

---
 ledger/lib/balance | 17 +++++++++++++++--
 1 file 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 {
-- 
cgit v1.2.3