chiark / gitweb /
Improved usage message
authorIan Jackson <ian@liberator.relativity.greenend.org.uk>
Mon, 18 May 2009 02:14:03 +0000 (03:14 +0100)
committerIan Jackson <ian@liberator.relativity.greenend.org.uk>
Mon, 18 May 2009 02:14:03 +0000 (03:14 +0100)
ypp-restock-rum

index 569f461..ab56abd 100755 (executable)
@@ -14,13 +14,20 @@ where <information> is
   price  <swill> <grog>  <fine> [<shot>]
 
 Each of which may appear only once, except \`have' which may appear
-more than once which case we calculate the differences and the profit
-for each one.
-
-If <shot> is not specified at all, relevant information about shot is
-not reported.  For have and want, missing entries count as zero.
+more than once which case we calculate the financial implications
+at each stage.
 
+Missing entries count as zero (and zeroes are not displayed in the output).
 In price, \`x' means the commodity is unavailable.
+
+The intended use is that at the start of the pillage you run:
+   ypp-restock-rum have ... want ...
+to check that stocks are sufficient, or perhaps:
+   ypp-restock-rum have ... want ... price ...
+if you want to stock up some more.  At the end of the pillage,
+run the same thing again with some extra parameters:
+   ypp-restock-rum have .. want ... have ... price ...
+and it will tell you how you did and what the restock should be like.
 END
 ;