Grocery.wk1 Documentation
=========================

Grocery.wk1 is a Lotus 1-2-3 spreadsheet for use on an HP200LX.  It is
a grocery list management utility.

A brief description of the structure follows:

Column	Description
------	-----------
A		the item description
B		the type, for supplementary description if needed
C		the number or quantity to purchase
D		the unit price. Should match the grocery store tag value, with
		sales tax multipliers included if applicable
E		the accumulated cost of all items at and above this row.
		This multiplies the quantity in C by the cost in D and adds
		it to the total 1 row above in E
F		a sale price, considered one-time only.  This is used as
		a unit price instead of the value in D if present
G		a "serial number" in store order.  This is used to sort the
		data in the order it appears on the store shelves.  The user
		must modify this to match the store layout.
H		a serial number for home order.  This is used to sort the data
		in the order one would scan one's home locations to determine
		desired quantities.  Again this must be adjusted to match the
		user's storage layout.
I		the three macros:
			/S	sort in store order
			/H	sort in home order
			/C	clear quantity and sale price columns


Notes:

The "milk" item illustrates an unusual calculation in column D.  I
sometimes get a 4 litre jug alone, somtimes this plus a 1 litre.  The
"unit" cost is adjusted to produce the correct total, depending on
whether I enter 1 or 2 as the quantity.  To correct this to "normal"
calculation simply match the cell above with row numbers corrected
(copy it over top)

I've used this for several years now, and wouldn't be without it.  The
sort options make it very easy and efficient in both the store and at
home.

As a matter of interest, I rarely come up with exactly the same total
as the store till unless I review and correct the prices to match my
sales slip. But the grand total (at the end of the list) does serve to
detect gross mistakes.  The unit prices also give one a chance to
detect price changes on the store tags easily.

Technical note: the sorts and clear macros used defined range names to
isolate the appropriate sections of the table. If one adjusts the
depth of the table these ranges will have to be modified for correct
operation.

The spreadsheet is released to the public domain on the understanding
that use is entirely at the user's risk.  Please let me know if you
have any suggestions.

Alan G. Herron
aherron@shaw.ca
2002-July-5