<qt>

# Shopper

- What is Shopper?
- How does it Work?
- Getting Started
- Making a List
- Out Shopping
- Your Data
- About Shopper
- Thanks
- Home page
- Copyright

# What is Shopper?

Shopper is a program designed to help you maintain a reusable shopping list. It runs on your Zaurus and is both quick and easy to use. The current version is 1.2.1.

# How does it Work?

Shopper holds a list of all the things you want to buy on a regular (and not-so-regular) basis. Before you go shopping you check the things you need (and you can make little notes for each of them too). When you're out shopping you check the things you've bought. Simple and useful.

# Getting Started?

You begin using Shopper by choosing "Making a list" from the "Mode" menu and then defining categories of items. Choose "Add New Category" from the "Category" menu. Categories are best used to break down a shopping trip by the different types of stores you will be visiting, or by the class of products you will be buying. (Fridge, Tins/Jars, Grocery, Clothing etc)

Once you have defined your categories, you can add items to your master list. Choose "Add Item" from the "Setup" menu. Each item is associated with a category. As you add items to your master list, they appear in the main window with an empty checkbox next to each. (More on that later!)

Tap-and-hold on an item to edit or delete the item. (Note: if you're using the notes box, you can't tap it, you must tap and hold the item itself.)

Shopper has 2 main 'modes' : "Making a list" and "Out Shopping".

# Making a List

Well, to be safe, Shopper remembers everything when you start and stop it. So the first thing you normally do is choose "New Shopping Trip" from the "Setup" menu. This just lets Shopper know that you're going to start a new list and you've not bought anything. (Don't worry, all the items for your lists are safe!)

Alternately, just go to the "Mode" menu and choose "Making a List".

OK, once you're making a list you just check those items that you are adding to your shopping list by placing a check in the box. This lets Shopper know you need them on this trip.

If you want to make a note by any item, go to the "Setup" menu and select "Preferences". From there you can choose to "Show notes area". Now you can click into any box and type in anything you like - like how many you need, a particular variety etc.

To show only items that belong to a specific category (like Snacks), choose that name from the "Category" menu. To view everything, choose "Everything"!

Generally Shopper doesn't change category unless you tell it to; but, if you're looking at "Everything" and then switch to "Making a List" Shopper will change to your first proper category so as not to give you a huge list to wade through. Of course you can select "Everything" if you like :)

You can also use the "<" and ">" on the menu bar to move through your categories.

You can switch back to "Making a List" at any time if you need to add something.

# Out Shopping

When you want to go shopping you tell Shopper to use one of the "Out Shopping" modes (from the "Mode" menu).

The "Out Shopping (What's left)" mode is what you normally use. Any items you marked on your master list now appear ready-to-buy. As you buy each item, place a check in the box and it disappears, just leaving what's left.

If you make a mistake (or just want to double-check) you can always select "Out Shopping (Full list)" fom the "Mode" menu to see everything you needed on this trip. In this mode, things that appear as checked have been "bought" - you can always uncheck them if you like.

Note that when you switch to an "Out Shopping" mode Shopper automatically switches to showing all Categories. You can still switch between categories as usual of course.

# Speed

Sometimes, if your Zaurus is doing other things or if you have a long list (you know who you are!) then Shopper can slow down a bit when you move from one category to another. There's an option in the "Setup"->"Preferences" called "Speed up category menu" that may help. It hides the screen whilst the list is being drawn and then shows it. This can flicker a little but that's nothing to be concerned about.

# Data

Your shopping list is stored in:
~/Applications/ShoppingListQt/shoppinglist.xml.

# About Shopper

Now maintained by David Greaves, Shopper was originally written by Jesper Pedersen (http://www.blackie.dk/) who said "I didn't get the idea for this program all by myself, I stole every single bit from a program with similar purpose called ShoppingList. ShoppingList was written in Java and was therefore very slow on the Zaurus. I therefore cloned the program, but this time wrote it in Qt."

Since then I've made further modifications. I'd always wanted a Shopper application but couldn't program in C++ or Qt :( Then, along came Jesper, Darien and Robert with a fantastic application to build on (and figure out some Qt and C++!). Shopper now does what I want - I hope that's close to what you want too :) If it's not then drop me a line with any suggestions - in fact drop me a line anyway if you like (or don't!) Shopper.

As an aside (and to help people from Google) Shopper is quite an easy app to get your head round to learn to program Qt on the Zaurus. For more informations see http://zaurus-shopper.sourceforge.net

# Thanks

I'd like to thank Jesper for developing Shopper and for being thoughtful enought to release it under GPL. I'll also retain and add to his thanks to Darien Kruss <darien at kruss.com> for developing an icon for this program, proofreading, and beta testing the software.

Thanks must also go to Robert Crawford <crawford at kloognome.com> for developing the original java program and help text.

Thanks also to: Krister Bruhwel

# Home Page

The home of this application is http://zaurus-shopper.sourceforge.net/

$Id: Shopper.html,v 1.3 2004/04/10 20:55:18 arbor Exp $

# Copyright and License

Copyright (c) 2002,2003, Jesper Pedersen, David Greaves

This file is part of Shopper.

Shopper is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Shopper is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Shopper; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Neither the names of Jesper Pedersen, David Greaves nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

</qt>