home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PILOT / database / TEALMEAL / TEALMEAL.ZIP / TEALMEAL.DOC < prev    next >
Encoding:
Text File  |  1997-07-20  |  7.6 KB  |  212 lines
  1. ---------------------------------------------------------------------------
  2.  
  3.    TealMeal.DOC
  4.  
  5.    By Vince Lee
  6.    Last Updated:  Jul 11, 1997
  7.  
  8.    Minor Update Version 1.01
  9.  
  10.         The application name has been shortened from 'TealMeal 2000' to
  11.     'Tealmeal' to work with some third-party launch programs.  Note:
  12.     If you install 1.01 and already have 1.00, you MUST first delete
  13.     the old version before installing the new, or your Pilot will
  14.     get confused by the inconsistent names and will crash.  Thus,
  15.     if you have created a custom database and wish to save it, insure
  16.     that it has been backed up to you computer (look for the file in
  17.     your Pilot\UserName\Backup directory), copy it elsewhere, and 
  18.     reinstall it after the update.
  19.  
  20. ---------------------------------------------------------------------------
  21.  
  22. DESCRIPTION
  23.  
  24.       Thank you for trying the TealMeal 2000.  This is a simple but
  25.    fun program designed to answer the age old question:  "So where 
  26.    do you want to eat?"  
  27.  
  28.       The TealMeal 2000 holds a database of restaurants which can be 
  29.    selectively displayed by type or category.  The database may be
  30.    created or modified using full pilot-based editing functions.
  31.    Additionally, databases may be edited on a PC using the included
  32.    conversion programs when translate database files to and from an
  33.    easily-editable text file format.
  34.  
  35. ---------------------------------------------------------------------------
  36.  
  37. INSTALLING
  38.  
  39.    This archive contains the files:  
  40.  
  41.    TEALMEAL.DOC  - This doc in text format
  42.    TEALMEAL.HTM  - This doc in HTML format
  43.    TEALMEAL.PRC  - The TealMeal 2000 program file
  44.    SAMPLE.PDB    - A sample database file
  45.    SAMPLE.TEXT   - A sample text database file for use with programs below
  46.    MEAL2TEXT.EXE - Database-to-Textfile converter program
  47.    TEXT2MEAL.EXE - Textfile-to-Database converter program
  48.    REGISTER.HTM  - TealPoint Registration form in HTML format
  49.    REGISTER.DOC  - TealPoint Registration form in text format
  50.  
  51.       Use the Pilot installer to install the program file TEALMEAL.PRC
  52.    You may also optionally install the sample database file SAMPLE.PDB.
  53.    If you do not, the program will not be useful until you create some
  54.    restaurant entries (see instructions below).  Additional
  55.    restaurant files are available on our web site (www.tealpoint.com)
  56.  
  57. ---------------------------------------------------------------------------
  58.  
  59. USING THE PROGRAM
  60.  
  61.       The TealMeal 2000 is easy to use.  The current restaurant list 
  62.    appears on the right half of the display, while selectable options 
  63.    appear on the left hand side and bottom of the screen.  
  64.  
  65.       The options on the left are types of restaurants you want to see,
  66.    such as Thai, Mexican, or French.  A restaurant will only appear 
  67.    on the restaurant list if one of the types of foods it serves is 
  68.    checked on the left.  Checking more restaurant types will include MORE
  69.    restaurants.
  70.  
  71.       The options on the bottom represent special conditions for the shown
  72.    restaurants, such as outdoor seating or cheapness.  Restaurants will 
  73.    only be included if they satisfy ALL selected conditions.  Thus, 
  74.    selecting more options will show FEWER restaurants.
  75.  
  76.       Once a list of acceptable restaurants has been created, two functions
  77.    are available.  To show more information on the restaurant, press on the
  78.    "Info" button after either clicking an entry in the list window or using
  79.    the scroll up/down buttons to select the desired entry.  Alternatively,
  80.    to randomly pick a restaurant from the current list, press the "Wheel" 
  81.    button to activate the Wheel Of Food.
  82.  
  83. ---------------------------------------------------------------------------
  84.  
  85. EDITING THE DATABASE ON THE PILOT
  86.  
  87.       To create a new restaurant entry, choose "Create New Record" from
  88.    the Edit menu (shortcut Stoke-C).  Alternately, to edit a existing 
  89.    entry, select it in the restaurant list and choose "Edit Record" 
  90.    from the Edit menu (shortcut Stroke-E).  
  91.    
  92.       Either of these options will bring up the editing screen, which 
  93.    resembles the Information screen.  Enter a restaurant name, 
  94.    description, and check off all checkboxes that apply.  Note that 
  95.    you must select at least one food category, or the record can 
  96.    never be shown.
  97.  
  98. ---------------------------------------------------------------------------
  99.  
  100. EDITING DATABASES ON A PC
  101.  
  102.       When you hotsync your pilot, the most current TealMeal database 
  103.    file is stored on the PC in a directory called BACKUP\, which resides 
  104.    in a directory named after your User ID.  This file is called 
  105.    "TEALMEAL.PDB".
  106.    
  107.       To edit the database file on a PC, run the included program MEAL2TXT
  108.    to convert the PDB file into a text file, following the prompts for 
  109.    a source .DBS file to read and a target .TXT file to create.
  110.    
  111.       After modifying the database, use the program TXT2MEAL to convert 
  112.    the text file back into a database (DBS) file which can be installed 
  113.    back onto the pilot using the pilot application installer.
  114.  
  115. ---------------------------------------------------------------------------
  116.  
  117. TEXT FILE FORMAT
  118.  
  119.    The text file format is as follows:
  120.  
  121.    #
  122.    # 
  123.    # <5 comment lines>
  124.    #
  125.    #
  126.    <Restaurant Name 1>
  127.       <Food Type>   <Food Type>   <Food Type>   <Food Type>...
  128.       <Options> <Options> <Options>...
  129.    <Description>
  130.    <Description>
  131.    <Description>
  132.    <Description>
  133.    >>>
  134.    <Restaurant Name 2>
  135.       <Food Type>   <Food Type>   <Food Type>   <Food Type>...
  136.       <Options> <Options> <Options>...
  137.    <Description>
  138.    <Description>
  139.    <Description>
  140.    <Description>
  141.    >>>
  142.  
  143.    ... and so on
  144.  
  145.  
  146.    Acceptable <Food Type> entries are
  147.       American
  148.       Chinese
  149.       Fastfood
  150.       French
  151.       Indian
  152.       Italian
  153.       Japanese
  154.       Meditrrn
  155.       Mexican
  156.       Sandwich
  157.       Thai
  158.       Other
  159.  
  160.    Acceptable <Options> entries are
  161.       Fast
  162.       Cheap
  163.       Nice
  164.       Outside
  165.       Card
  166.  
  167. ---------------------------------------------------------------------------
  168.  
  169. CONTACT INFO
  170.  
  171.    TealMeal 2000 is By Vince Lee, TealPoint Software
  172.    (c) 1997 All Rights Reserved.
  173.  
  174.  
  175.       TealPoint Software
  176.       454 Las Gallinas Ave, Suite #318
  177.       San Rafael, CA  94903-3618
  178.  
  179.    We look forward to hearing from you.
  180.  
  181.    Please visit us at www.tealpoint.com, or
  182.    email us at contact@tealpoint.com.
  183.  
  184.    Thank you.
  185.  
  186. ---------------------------------------------------------------------------
  187.  
  188. DISCLAIMER
  189.  
  190.       We at TealPoint Software are committed to providing quality,
  191.    easy-to-use software. However, this product is provided without 
  192.    warranty and the user accepts full resposibility for any damages, 
  193.    consequential or otherwise, resulting from its use.
  194.  
  195.       This archive is freely redistributable, provided it is made 
  196.    available only in its complete, unmodified form with no additional 
  197.    files and for noncommercial purposes only.  Any other use must have 
  198.    prior written authorization from TealPoint Software.  
  199.  
  200.    Unauthorized commercial use includes, but is not limited to:
  201.    
  202.       1) A product for sale.
  203.       2) Accompanying a product for sale.
  204.       3) Accompanying a magazine, book or other publication for sale.
  205.       4) Distribution with "Media", "Copying" or other incidental costs.
  206.       5) Available for download with access or download fees.
  207.  
  208.    This program may be used on a trial basis for 30 days.  The program will
  209.    continue to function afterwards.  However, if after this time you wish to 
  210.    continue using it, please register with us for the nominal fee listed in 
  211.    the program.
  212.