.TH tkshop 1 "December 2002" "Unix System Manual" "User Programs"
.SH NAME
tkshop \- grocery list database
.SH SYNOPSIS
.B tkshop
[file]
.SH DESCRIPTION
.B tkshop
is a small grocery list manager. It can manage multiple grocery
lists, categorized by store.
.PP
It is cross-platform, and will run on any system where
.I tcl/Tk
can be installed. This way, it may be used on iPaq handheld systems
as well as desktop un*x, Windows, or Macintosh systems. The user
interface has been optimized to work well on handheld devices.
.PP
The data is stored in a colon-delimited, flat file so that it may
be manipulated by many tools. It can easily be imported and exported
between various other programs. The data can be edited with a spreadsheet
application, for instance. The author shares the data between a Palm
Pilot, iPaq running Familiar linux, a laptop running Debian linux,
and a desktop system running Windows 2000.
.SH NOTES
When a data file is read (see section
.B FILES
for the default locations for data files), the 
.I Store
field will be parsed so that entries may be viewed by individual
categories. Entries can be sorted by aisle, cost, or item. Individual
entries can viewed by double-clicking on them. They can be further
manipulated by highlighting them, and selecting an operation from
the 
.I Entry
menu. 
.PP
The displayed list can be set to only show items from a particular store,
and can also be set to only display those items that are needed (those
whose quantity field is greater than 0).
.PP
When an item in the list is double-clicked, it will toggle its quantity
between 0 and 1. This is a shortcut method for adding and removing items
from the list of those needed.
.PP
A running total is kept of all needed items. 
.SH FILES
If called with no arguments, 
.B tkshop
will default to a data file in one of these locations:
.ta .5i 4i
.ds Z	$HOME/.tkshop \t (un*x)
.ds ZZ	%HOMEDRIVE%%HOMEPATH%/tkshop \t (windows)
.ds ZZZ	$PREFS/.tkshop \t (mac)
.nf
\*[Z]
\*[ZZ]
\*[ZZZ]
.fi
.ta
.SH COMPATIBILITY
Since the program is written in tcl/Tk, it will run on any system where
these tools can be installed. It has been tested on handheld and desktop
linux systems, and Windows 2000.
.SH COPYRIGHT
Copyright \(co 2002 Dave W. Capella
.PP
This is free software; the program may be freely copied and used as long
as it is accompanied by all documentation, and all attributions remain
intact. Changes to the original source must be clearly marked.
.PP
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.
.SH AUTHOR
.B dave w capella
<dave.capella@cornell.edu> http://grox.net