HowTo
Wiki Home
Home
----------
HandyShopper User's Guide: How To...
THIS PAGE IS UNDER CONSTRUCTION (it is in outline form and content is incomplete)

Sometimes the basics of how to use HandyShopper , and even the in-depth look at all the features and functions is not enough for a user to really get to know the program. This page contains several examples of how to do common things in HandyShopper with step-by-step instructions and illustrations so that they don't get lost. Suggestions for new How To sections are welcome via the Contact page.
----------
Table of Contents
1 Getting Started
2 How To... current page
3 Preferences
4 Menus and More
5 Sharing Lists
----------
{maketoc}
----------
How to use HandyShopper 's Import/Export feature
Importing from MemoPad :
When importing, the new items are placed in the current category (or Unfiled if "All" is the current category). If you are in the "Need" view, then the imported items are also marked as needed items. The items are also associated with the currently selected store (if "All Stores" is selected, then the new items are not associated with any stores). Imported items use the default auto-delete and taxable settings.

Steps to import from a MemoPad memo:
0.1 Tap the Menu area next to the graffiti area.
0.2 Select "Options", then "Import from MemoPad ..."
0.3 Select the memo from which to import the list.
0.4 Tap the "Import" button.
Import format details:
** Items can begin with '-' or the bullet character (149 decimal, 0x95 hex, 225 octal). If the second line begins this way but the first line does not, the first line is assumed to be a title, and is skipped. Examples of the two supported formats are given below.
** The fields are recognized in the following order. Required fields are marked with * and other fields may be omitted:
0.0.1 Quantity -- '@4.5' sets the quantity to 4.5. Unit -- 'u:xyz' sets the units to 'xyx'.
0.0.2 Price -- '45.69' sets the price to 45.69. Prices may be negative, and may optionally begin with the currency symbol, but may not end with the currency symbol.
0.0.3 Aisle -- 'a:123' sets the aisle to 123, or 'a:G' sets the aisle to G.
0.0.4 Description * -- for items beginning with '-' or the bullet character the description can be more than one line.
0.0.5 Note -- the '|' character separates the description and the note text.
Known Limitations
** If you export a list, make some changes, and import it again, the imported items are ADDED to your list. This means that you will now have duplicate copies of each item that you exported and then imported. You can use the "Purge for Import..." command to delete all the items from the current view, and then import the list. Note, the "current view" is filtered to show only All, Needed, or Coupon items from the current store and current category.
** You can put bullet characters in the description of an item. But if you export the list, and then import it again, the bullet characters may be interpreted as new items instead of as part of the description. To avoid this, make sure that the bullet character does not immediately follow a line break.
** Not all fields can be exported. Only the Quantity, Price, Aisle, and Description can be exported.
** There is currently no way to export which stores an item is associated with.

Format 1: Bullet Marks
This is the format that HandyShopper uses when it exports a list to the MemoPad .
* Each item begins with a bullet mark, which is either a dash ('-') or the bullet character (the graffiti stroke is backslash, dot), followed by a space.
* Next comes the Quantity, which is a number followed by '@'. (This field is optional; if you omit it, the quantity is set to 0).
* Next is the Price, which may or may not begin with a '$$'. (This field is optional; if you omit it, the price is set to $$0).
* Next is the Aisle, which must be 'a:' followed by a number (for instance, 'a:3' means aisle 3). (This field is optional; if you omit it, the aisle is set to 1).
* Anything following the above fields is put into the Name field. Line breaks are considered to be part of the Name field, unless they are immediately followed by a bullet character (or dash).

My shopping list:
- cereal
- 2@ 1.49 Pringles
- 5.99 batteries
- a:27 sci-fi books
- 4@ .99 2-Liter bottles of pop
- 3@ a:4 cookies for party
party is at Greg's house
(this is 3rd line of party item)
- 14.99 box of logs for fire

Format 2: No Bullet Marks
If you do not use bullet marks, then line breaks are used to determine when to start a new item. The data for each item will be interpreted the same as described for Format 1.

newspaper
3@ towels
$$5 cat food
1@ $$5.99 AAA batteries
2@ $$1.89 a:3 soup
----------
How to use the Unit Price column
How to assign a list of items to a store
How to print HandyShopper lists
How to make a copy of a list
----------
Original Content from: http://www.ggaub.com/hs/ HowTo .html ----------
Wiki Home
Home