S M A R T P H O N E Instant Telephone Information Featuring - More than 340 area and country codes, with time zones - - More than 15000 towns and cities - - Zip and Postal Code Information - - "The Five-Minute Database" - - Pop-up (TSR) Operation - Copyright (C) 1986,1992 by Pinnacle Software 1. TABLE OF CONTENTS --------------------- 2. A QUICK OVERVIEW OF SMARTPHONE . . . . . . . . . . . . . . . . . . 1 2.1 Area Code Listings 2.2 "The Five-Minute Database" 2.3 Features 2.4 TSR Capabilities 2.5 System Requirements 3. HOW TO CONTACT US . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. INSTALLING SMARTPHONE . . . . . . . . . . . . . . . . . . . . . . . 4 4.1 Installation of an Archive File After Download 4.2 Installation of a Disk from a Shareware Vendor 4.3 Super-Quick Install: Pinnacle Diskette to Hard Disk 4.4 Basic Installation Concepts 4.5 Step-by-Step Installation Instructions 4.6 Upgrading from Area Code Hunter 5. USING SMARTPHONE . . . . . . . . . . . . . . . . . . . . . . . . . 9 5.1 Starting SmartPhone 5.2 The Main Menu 5.3 The Area Code Hunt Screen 5.4 The Area Code Browse Screen 5.5 Quick-Reference Database 5.6 Other Features 6. TSR (POP-UP) OPERATION . . . . . . . . . . . . . . . . . . . . . 17 6.1 What is a TSR? 6.2 TSR Startup 6.3 Technical Considerations 7. THE FIVE-MINUTE DATABASE . . . . . . . . . . . . . . . . . . . . 19 7.1 What is The Five-Minute Database? 7.2 Quick-Learn Method 7.3 Applications 7.4 What is a FIV File? 7.5 Database Format 7.6 Sample Database 8. SMARTPHONE LICENSING . . . . . . . . . . . . . . . . . . . . . . 25 8.1 Licenses for Individuals 8.2 Corporations and Institutions 8.3 Technical Support 8.4 Warranty 9. NOTES ABOUT THE LISTINGS . . . . . . . . . . . . . . . . . . . . 27 9.1 Time Zones 9.2 Spelling 9.3 International Dialing Codes ii 10. BACKGROUND INFORMATION . . . . . . . . . . . . . . . . . . . . . 29 10.1 Product History 10.2 About Pinnacle Software 10.3 Some Examples of How SmartPhone Can Help You 11. INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 iii 2. A QUICK OVERVIEW OF SMARTPHONE ---------------------------------- 2.1 Area Code Listings ----------------------- - Complete area code information for North America and the Caribbean - Every country code in the world - Town and city listings - World-wide time-zone information - Projected new area codes - "Sounds like" searches 2.2 "The Five-Minute Database" ------------------------------- - Quick reference database - Area and Zip Codes - Cities, Populations, Languages - Design your own pop-up databases - Most people can set up their first database in only 5 minutes 2.3 Features ------------- - Easy to install and use - Area Code search has exclusive multi-tasking hunt 'n' browse feature - Editor allows you to add your own comments to each area code - Can be run stand-alone or as a TSR (pop-up) 1 2.4 TSR Capabilities --------------------- - Pop-up without leaving your application program - Resident portion takes only 7K - RAM disk support for lightning-quick response 2.5 System Requirements ------------------------ - IBM PC compatible computer with 640K RAM - MS-DOS or PC-DOS version 3.00 or higher - Color or monochrome display - Hard disk (RAM disk recommended for pop-up operation) 2 3. HOW TO CONTACT US --------------------- If you have any questions about SmartPhone, or about any of our other products, we'd like to hear from you. Mail ............... Pinnacle Software CP 386 Town of Mount Royal Quebec, Canada H3P 3C6 Phone .............. 514-345-9578 (Business hours, Eastern Time) BBS ................ 514-345-8654 (24 hrs/day, up to 9600 baud v42bis) GEnie .............. T.CAMPBELL11 (Mail checked daily) CompuServe ......... 70154,1577 NOTE: If you have a modem, we invite you to call our BBS and download some software. You can download on the first call. This is no charge for this service. 3 4. INSTALLING SMARTPHONE ------------------------- NOTE: If you are upgrading from an earlier version (Area Code Hunter), please see the section entitled "Upgrading" before proceeding with your installation. 4.1 Installation of an Archive File After Download --------------------------------------------------- If you have downloaded SmartPhone via modem and have dearchived the file into a directory, the product will install itself as soon as you run it. To run it, type SP at the DOS prompt. If SmartPhone does not ask for installation information the first time you run it, it means you are running a "used" copy. This doesn't present any problems, though: simply select the SPEC option on the main menu. 4.2 Installation of a Disk from a Shareware Vendor --------------------------------------------------- If you got your copy of SmartPhone on a disk from somebody other than Pinnacle Software, refer to any special installation instructions that accompany the diskette. Once the files have been copied to their destination, you can start up SmartPhone by typing SP at the DOS prompt. 4 4.3 Super-Quick Install: Pinnacle Diskette to Hard Disk --------------------------------------------------------- NOTE: If you find that this section is not detailed enough, skip ahead to the next section for a complete explanation. If you're an experienced computer user, you can install SmartPhone quickly by inserting one of the diskettes into the A: drive and typing: A:GO If the diskette can only fit into your B: drive, insert it there and type: B:GO 5 4.4 Basic Installation Concepts -------------------------------- NOTE: The information in this section will help you understand the section that follows. If you are an experienced PC-compatible user, you can safely skip this part. A diskette is sometimes called a floppy disk. If your computer has one diskette slot, it is known as "drive A:". If your computer has two diskette slots, they are "drive A:" and "drive B:". If your computer does not have a "hard disk", the A: drive is the one that you put your DOS diskette into when you turn on your computer. SmartPhone is available on two different types of diskettes. The larger diskette fits 5.25 inch diskette drives, while the smaller diskette fits into the newer 3.5 inch diskette drives. Hard disk users are strongly urged to look up the PATH and AUTOEXEC concepts in their DOS manual. 4.4.1 Formatted Disks (If you have a hard disk, you can skip this part) If you have ONE diskette drive, you will need a NEW diskette formatted for the A: drive. If you have TWO diskette drives, you will need a NEW diskette formatted for the B: drive. To learn how to create formatted disks, look up the FORMAT command in your DOS manual. (Briefly: remove all diskettes from your computer, insert your write-protected DOS diskette into the A: drive, type A: to log to the A: drive, then type FORMAT B:) Be very careful when formatting diskettes! Any data on the diskette will be lost. 4.4.2 Inserting a Diskette A diskette goes into the diskette drive slot with very little effort; don't force it! If it doesn't go in properly, or if the computer refuses to recognize the disk, try removing it and inserting it differently: flip it over or turn it around. (Hint: The label on the diskette is always the 6 last part to go into the slot.) The larger 5.25 disk drives sometimes have a little flag or tab which must be closed before the computer will recognize that you've inserted the disk. 4.5 Step-by-Step Installation Instructions ------------------------------------------- 1. Select the SmartPhone diskette that fits into the A: drive, and insert it into that drive. Log to (i.e. select) the A: drive. You can do this by typing A: at the DOS prompt. 2. If you are installing to diskette, make sure you have a new formatted diskette handy (see "Formatted Disks", above). 3. Now run the GO program in the A: drive. You can do this by entering GO at the DOS prompt. If you are running a "DOS Shell" program, you will have to select the A: drive, then select the GO program. 4. You will then be shown a menu. Select "Install" by pressing F2. 5. You will then be shown a suggested destination for the files. In most cases, you can simply press Enter to accept the recommended destination. But if you wish to change it, it can be edited using the insert, delete and arrow keys. 6. Once the program has finished copying the files, it will return you to DOS (or your DOS shell). To start up SmartPhone, run the SP program (type SP at the DOS prompt or select SP.EXE from your DOS shell). 4.6 Upgrading from Area Code Hunter ------------------------------------ The instructions below assume that you are installing SmartPhone into a new diskette or directory. Don't install it in your old Area Code Hunter directory. If you were using Area Code Hunter version 3.0 or earlier, there are no special procedures to follow. Version 4.0, however, introduced the "Notebase" (Comments window) which enabled you to attach notes to each area code. If you want to retain your notes, switch to your Area Code Hunter directory and make a backup copy of the files: COMMENTS.DAT and COMMENTS.IDX 7 Proceed with SmartPhone installation as described in the previous sections. Then copy in the two COMMENTS files. 8 5. USING SMARTPHONE -------------------- 5.1 Starting SmartPhone ------------------------ NOTE: Starting up SP for TSR (pop-up) operation is a bit different than for stand-alone operation. This is described in section 6. 5.1.1 Starting SmartPhone from the DOS Command Line 1. (If the directory into which you installed SmartPhone is in your DOS PATH, this step is not necessary.) If you're not already there, change to the drive and directory in which you installed SmartPhone. For details about changing directories, refer to your DOS manual's description of the CD command. You now have three options: 2A. Type SP at the DOS prompt. This will pop up the main SmartPhone menu. 2B. Type SP ? at the DOS prompt. This will display some helpful information about starting up SP. 2C. Type SP followed by a "hunt" command. A "hunt" command is precisely the same as you would type in the Area Code Hunt Screen (described later). For example, to search for area code 514, you would start up SP like this: SP 514 Or if you were looking for cities that sound like "New York", you would start up SP this way: SP ?New York (The "?" indicates a "Sounds like" search. Hunt commands are described in more detail, later) When started up in this manner, SP returns to the DOS prompt as soon as you have finished viewing the area code information. 9 5.1.2 Starting SmartPhone from a DOS Shell DOS shells vary in design, so it is impossible to give instructions that will apply to all of them. In general, however, you will follow these basic steps: 1. Select the drive and directory in which you installed SmartPhone. 2. Select the program SP.EXE You will then see SP's main menu. 5.2 The Main Menu ------------------ The main menu lists the following options: F1 HUNT þ Area codes and notebase F2 DATA þ Quick-reference database F6 SPEC þ Specify location of data file, and so on F7 INFO þ General information about SmartPhone F8 FORM þ Print form to order the latest SmartPhone F10 QUIT þ Leave SmartPhone and return to DOS The first column (F1, F2, etc.) lists the function keys corresponding to each selection. The second column (HUNT, DATA, etc.) allows you to spot the item you want quickly. The third column is a detailed description of each function. To select a function, you can either: 1. Press the corresponding function key (e.g. F7 for INFO), or ... 2. Move the cursor-bar (highlighted line) up and down with the arrow keys, then press Enter when it is highlighting the item you want. At any time, you can press Esc to back up. For example, if you press Esc at the main menu, you will be returned to what you were doing when you started up SP. 10 5.3 The Area Code Hunt Screen ------------------------------ 5.3.1 The Two Parts of the Hunt Screen The Hunt screen is displayed when you select the "HUNT" option on the main menu (F1 key). The screen is divided into two parts. The top part of the screen gives examples of "Hunt Commands". The bottom part of the screen is where you actually type your hunt command. 5.3.2 Editing Keys While typing the hunt command, you can edit what you type by using the following keys: NAME OF KEY WHAT IT DOES ------------ --------------------------------------------------- Left arrow Moves the cursor one position to the left Right arrow Moves the cursor one position to the right Backspace Deletes the character just before the cursor Delete Deletes the character on top of the cursor Insert Turns Insert Mode on and off While in Insert Mode, you can move your cursor back with the left arrow key and insert characters where you type. Any characters you type push the other characters over to the right to make room. When Insert Mode is off, however, any characters you type on top of other characters will replace them. If you want to return to the main menu, you can "Escape" from the Hunt screen by pressing the Esc key. 5.3.3 Hunt Commands You can search for information in a variety of ways. You let SmartPhone know what you are looking for by the format of what you type in. This is easier than it sounds! 11 For example, if you want to find out where area code 908 is, you simply type 908, then press Enter. If you wanted to find out which area codes are used in California, you'd type California and press Enter. SmartPhone can tell the difference between numbers and letters, so it doesn't think you're looking for a city named "908" when you type 908. If you type only two letters, SmartPhone assumes you are looking for a two- letter mailing abbreviation. For example, "NY" would be found as "New York", "NJ" would be found as "New Jersey", and so on. Country codes are a little different. Since it's possible to confuse a country code with a North American area code, you must put a plus (+) sign in front of the number you asking about, so that SmartPhone knows that it's a country code. So if you wanted to find out which country used the code 63, you would enter it as +63, then press Enter. (It's the Philippines, by the way) Country names are usually distinctive, so you don't have to indicate them in any special way. If you're searching for Germany, simply type Germany, then press Enter. If you only happen to remember PART of a name, you can still search for it, by putting an equals-sign (=) in front of the part you do remember. For example, if you remember that the town ended in "octon", you would type =octon then press Enter. Note that this kind of search is considerably slower than the previously mentioned searches, because the computer has more work to do. Finally, if you don't know anything about the name of the place except an approximate pronunciation, you can use the "sounds like" search by putting a question mark (?) in front of the search text. For example, let's say somebody left a message on your answering machine but didn't say it clearly enough. All you heard was "Nork" or something like that. You would enter ?nork then press Enter. SmartPhone would find some likely candidates, such as "Newark" and "Norwich". The "sounds-like" search is slower than any of the previous search methods mentioned so far, because the computer has to evaluate the many possible ways to pronounce -- and mispronounce -- each place name. 12 5.4 The Area Code Browse Screen -------------------------------- 5.4.1 The Three Parts of the Browse Screen After you've typed in a hunt command (see the previous section), the Area Code Hunt Screen will be replaced by the Browse Screen. The Browse Screen is divided into three parts: - The Area Code Window - The City Window - The Comments Window You can make any one of these parts "active" by pressing the Tab key. When you press Tab (located on the left side of your keyboard, usually marked either Tab, or with two arrows, each pointing at a line), the active window will change to the one below it (or the top window, if the active window is the last one on the screen). Shift-Tab does the same thing, but in the other direction. For example, if the second (City) window was active and you pressed Shift-Tab, you would switch to the first (Area Code) window. An active window is surrounded by a double line; the other two (inactive) windows are surrounded by a single line. Thus, you can always tell at a glance which window is active. When the Browse Screen first appears, the Area Code Window will usually be active. One exception: if you searched for a specific area code (example: your Hunt Command was 305), then the City Window will be active. Each window is described in more detail, below. 5.4.2 The Area Code Window The top part of the Browse Screen is the "Area Code Window". This window will display one or more area codes that match what you're hunting for. For example, if you were searching for area code 908, the number 908 would appear in the Area Window. If you were searching for all area codes in New York (i.e. your hunt command was "New York" or "NY"), you'd see several area codes in this window, because New York State has several area codes. If there are more area codes than can be displayed in the area window (which is only a few lines high), you can "scroll" the window by using the down arrow key. 13 If there are more than one area code in the area window, when you push the Down Arrow key, you will notice that the highlighted bar moves down. When it reaches the bottom of the area window, the area codes scroll up. This enables you to highlight any area code in the area window. To move backwards in the list of area codes in the area window, press the Up Arrow key. The area code window also contains time zone information for any areas using North American time zones, such as Atlantic Time, Pacific Time, etc. For other areas, refer to the City Window. 5.4.3 The City Window The middle part of the Browse Screen is the "City Window". This window displays a list of cities in the area code highlighted in the Area Code Window (described previously). If there are more cities than can fit in the window, you can "scroll" the list by pressing the Up and Down arrow keys. In most cases, the cities are listed in alphabetical order. However, if there is a logical way to break up an area code into regions, and reliable data about such a division is available to us, the list may be broken up into sections. In this case, each section of the listing is separated from the other sections by a row of dots. For areas outside North America, time zone information appears in the City Window, at the end of the list of cities. This information is given as an "offset" from a standard North American time zone. For example, the United Kingdom shows a time listing as follows: Pacific + 8.0 Rocky + 7.0 Central + 6.0 Eastern + 5.0 Atlantic + 4.0 If you lived in the Pacific Time Zone, you would add 8 hours to your time to find out what time it is in, say, London. So if it was noon, it would be 8 PM in London. If it was 6 PM in the Pacific Time Zone, it would be 2 AM the next day in England. 5.4.4 The Notebase ("Comments") Window The bottom part of the Browse Screen is the "Comments Window". You can write notes in this window, and every time you call up a particular area code, the notes that are associated with it will also appear. You can write up to 25 lines of notes. For example: You enter the Hunt Command "New York". SmartPhone displays several area codes in the Area Code window (described previously). You use the Up and 14 Down arrow keys to highlight one of the area codes. Once you've selected the one you want, you tap the Tab key twice to get to the Comments Window. You type a brief note. If you make a mistake, you can use editing keys (see "Editing Keys", described previously). When you press Esc to leave the Browse Screen, your notes are saved and associated with the area code that was highlighted in the Area Code window. So whenever you select that area code in the Browse Screen, you will also see the notes that you typed. 5.4.5 Leaving the Browse Screen To leave the Browse Screen and return to the Main Menu, press Esc. One exception to this: if you started SP at the DOS command line with a Hunt Command (for example: SP Georgia), you will be returned to the DOS prompt when you press Esc. 5.5 Quick-Reference Database ----------------------------- F2 on the main menu brings up a quick-reference menu. This section features several databases containing information about the world. The databases provide information about population, capitals, zip codes, language and more. When you are displaying a database, you can scroll back and forth using your arrow and page keys. Some databases allow you to sort the data in various ways. But all that data can be a bit overwhelming. That's where the (F)ind command comes in handy. When you press the "F" key, you will be asked for some text to search for. Type in the item you're interested in. The data is then redisplayed, showing only the records that contain that data. The other data didn't get deleted, though -- it's just hidden. You can then scroll through the reduced list of data in the usual way. To restore the data to the complete list, press "F" again, then press Esc. You will once again see all the data records. SmartPhone REALLY gets smart when you write your own Quick-Reference Databases! Using a text editor and following a few simple rules, you can create your own databases, which will then be available to you to "pop-up" at any time. For details, see the section entitled "The Five-Minute Database". 15 5.6 Other Features ------------------- 5.6.2 The SPEC Option F6 on the main menu brings up a configuration screen. You can use this to customize SmartPhone's operation. For example, you can switch the display from color to monochrome (i.e. no color), or turn the sound effects on or off. 5.6.3 The INFO Option F7 on the main menu gives some general information about SmartPhone, such as how to order upgrades. 5.6.4 The FORM Option F8 on the main menu will either display or print an order form for ordering registered copies of SmartPhone. If you have a printer (on LPT1), the form will be printed. If you do not, the form will be displayed on the screen so you can note down the details. 5.6.5 The QUIT Option F10 on the main menu will return you to whatever you were doing before you started (or popped up) SmartPhone. As an alternative to pressing F10, you can press Esc. 16 6. TSR (POP-UP) OPERATION -------------------------- NOTE: TSR support is available only in the Pop-Up version of SmartPhone; it is not available in the Personal version. If you're not sure which version you have, start up SmartPhone like this: SP ? 6.1 What is a TSR? ------------------- If you want to be able to call up SmartPhone at any time, you can install it as a "Pop-up", also known as a TSR (Terminate and Stay Resident) program. This will enable you to start up SP even if you're already in another program, just by hitting a special key combination. When you're finished with SP, you'll return to your original program as if nothing had happened. 6.2 TSR Startup ---------------- To start up SmartPhone as a TSR, you have to start it up in way that is slightly different from the usual (non-TSR) start-up. At the DOS prompt, enter the command: SP -R After doing this, you will be able to "pop up" SmartPhone at any time, simply by pressing Alt-Space. Then when you've finished with SmartPhone, you will be returned to what you were doing before you popped it up! If for some reason you wish to remove SmartPhone from memory (perhaps because you need the memory for a particularly large program), enter the following unloading command at the DOS prompt: SP -U If you wish to permanently change the pop-up key from Alt-Space to something else, start up SmartPhone as follows: 17 SP -N You will then be asked to press the key combination you want to use. 6.3 Technical Considerations ----------------------------- When operated in pop-up mode, SmartPhone needs about 275K of free disk space on a hard disk or RAM disk. (SmartPhone also uses disk space for storing up to 25 lines of your comments for each area code.) "Pop-up" programs interact with other programs and each other in ways that DOS was not designed for. We can not guarantee that the pop-up feature will work on your computer in any or all circumstances. As with all pop- ups, in order to get the SmartPhone TSR working properly, you may have to experiment a bit with the settings. We particularly recommend using a RAM disk as your "swap" drive, if possible. 18 7. THE FIVE-MINUTE DATABASE ---------------------------- 7.1 What is The Five-Minute Database? -------------------------------------- Our experiments have shown that a moderately experienced computer user who wants to create databases for SmartPhone can learn the required techniques in two minutes and fifteen seconds. But we couldn't very well call our system "The Two Minute and Fifteen Second Database", could we? Thus was born "The Five-Minute Database"! 7.2 Quick-Learn Method ----------------------- If you are an experienced computer user, load a copy of the file 10CODZIP.FIV (included with SmartPhone) into your favourite text editor program. The comments at the beginning of that file explain how you can make your own Five-Minute Database file. 7.3 Applications ----------------- The Five Minute Database is designed for small collections of tabular data -- usually around 300 items. When you create a database in your SmartPhone directory, it will become available via SmartPhone. This means that you could have pop-up (TSR) access to such lists as: - Salespeople for your company, listed by region - Commonly used phone numbers - Product information - Inventory codes - Telemarketing scripts and so on. We recommend that you create a small database -- a phone list of your friends, for example -- to see how easy it is. After that, we're sure that plenty of other applications will occur to you. 19 7.4 What is a FIV File? ------------------------ Databases for The Five-Minute Database are text files with a .FIV extension. For example, SmartPhone would recognize the file MYFILE.FIV as a database, but it would not recognize the file MYFILE.TXT. FIV files are created -- and updated -- using a text editor and viewed using the DATA feature of SmartPhone. A text editor is a program for creating standard DOS text files. You can use DOS's EDLIN or EDIT, a programmer's editor (such as the Turbo Pascal editor or QEdit), or a word processing program in non-document (generic DOS text) mode. SmartPhone looks for FIV files in its home directory. So if you installed SmartPhone in a directory named C:\SP you should place your FIV files there. If there are 9 or less databases, SmartPhone will display the titles of each one on its selection menu. If there are more than 9, SmartPhone will show the first 9 that appear in the DOS DIR command. The Five-Minute Database is optimized for databases of around 200-300 records. You can define more records, but performance will be degraded. (In later versions of SmartPhone, we will allow more databases and make it practical to have more records.) 7.5 Database Format -------------------- NOTE: You may find it useful to print out a copy of the file FRIENDS.TXT (included with SmartPhone) and compare it with the information presented here. A FIV file is divided into several sections, each of which start with a special "control word" that SmartPhone recognizes. These sections are: CONTROL WORD DESCRIPTION OF SECTION ------------ ---------------------- ; (semicolon) Comment line >>TITLE Title of the database >>VERSION Version of SmartPhone required to read database >>SORT Describes the ways the data can be sorted >>HEADER Titles that describe each column of data >>FRAME Lines that are drawn around the data >>DATA The actual data These sections are described in more detail below. 20 7.5.1 Comments Any line in a FIV file that begins with a semicolon (;) is ignored. This lets you insert comments in the file. Here is an example of a comment: ; This is a comment The semicolon must appear in column 1. Comments may appear anywhere in the FIV file. 7.5.2 The >>TITLE Section The >>TITLE section defines the title of the database. This is displayed on the database selection menu when you select the DATA section of SmartPhone. One exception: if there is only one FIV file, SmartPhone selects that automatically. Here is an example of a >>TITLE line: >>TITLE My friends and their phone numbers The >>TITLE can be in upper case or lowercase, and may be abbreviated to >>TITL. It must begin in column 1, and must appear before any other control words in the file. 7.5.3 The >>VERSION Section The >>VERSION section defines the version of The Five-Minute Database required to read the database. Here is an example of the >>VERSION control word: >>VERSION 1.00 The version number given reflects the version of The Five-Minute Database, not the version of SmartPhone. The Five-Minute Database is provided as part of SmartPhone, but we consider it a separate product with its own version number. The current version is 1.00. The >>VERSION control word can be in upper case or lowercase, and may be abbreviated to >>VERS. It must begin in column 1, and must appear immediately after the >>TITLE control word. 21 7.5.4 The >>SORT Section The >>SORT section describes the various ways the data can be sorted. Here is an example of a >>SORT section: >>SORT 1 14 Sort by first name 15 28 Sort by last name 29 44 Sort by phone number The format of each sort definition line is: When the user selects a database in the DATA section of SmartPhone, they see the menu descriptions you have specified. (They do not see the start and end column information). The >>SORT section is optional. If you do not specify a >>SORT section, the data will not be sorted in any way but will be presented in the order it appears in the FIV file. If you specify only one sort line, that will be chosen automatically and the user will not be presented with a menu. The >>SORT control word can be in upper case or lowercase. The >>SORT control word and the lines following it must begin in column 1. 7.5.5 The >>HEADER Section The >>HEADER section specifies up to 8 lines of text that will appear at the top of the data when it is displayed. For example, if you had three columns of data in a database containing phone numbers for your friends, you would want to define a >>HEADER section like this: >>HEADER First Name Last Name Phone Number ---------- ------------- --------------- In this example, we have indented the column headings by two spaces because the data, when displayed, is also indented two spaces. See the >>FRAME and >>DATA sections for details. The >>HEADER control word can be in upper case or lowercase. It may be abbreviated to >>HEAD. The >>HEADER control word must begin in column 1. 22 7.5.6 The >>FRAME Section The frame section defines lines that are drawn around the data when it is displayed. The >>FRAME section MUST be three lines long (not counting the >>FRAME control word), as in the following example: >>FRAME +-------------------------------------------+ | | +-------------------------------------------+ The first line shows the text that forms the top of the box, the second line shows the lines drawn with the actual data, and the third line defines the bottom of the box. In the example given in the >>HEADER section, we described a phone-number database. Combining the two together, we could have something like this: >>HEADER First Name Last Name Phone Number >>FRAME +-------------+-------------+---------------+ | | | | +-------------+-------------+---------------+ The column headers in the >>HEADER section are indented by two spaces because the data, when displayed, is also indented two spaces, in order to allow a frame line to appear on the left side. The >>FRAME control word can be in upper case or lowercase. It may be abbreviated to >>FRAM. The >>FRAME control word must begin in column 1. 7.5.7 The >>DATA Section The >>DATA section lists the actual data, with one data record per text line. Null (empty) lines are ignored. The >>DATA control word can be in upper case or lowercase. It must begin in column 1. Bear in mind that the data following it will be indented two spaces when displayed, to allow the >>FRAME section to define a vertical line on the left side of the data display. 23 7.6 Sample Database -------------------- Combining the concepts described in the preceding sections, we produce a text file that looks like this: ; This is my database ; >>TITLE My friends and their phone numbers >>VERSION 1.00 >>SORT 1 14 Sort by first name 15 28 Sort by last name 29 44 Sort by phone number >>HEADER First Name Last Name Phone Number Comments >>FRAME +-------------+-------------+---------------+------------------------+ | | | | | +-------------+-------------+---------------+------------------------+ Timothy Campbell 514-345-9578 Pinnacle Software Leonardo Da Vinci 208-555-2343 Helicopter Repair Inc. Ronald Reagan 310-555-2922 Anecdotes 'R' Us Ronald McDonald 908-555-1414 Burger Labs This example is indented for clarity. In the actual text file, all of the control words would start in column 1. You'll notice that the data does not align with the frame; it will be indented two spaces when displayed. The example given above can be found in the file FRIENDS.TXT, included with the SmartPhone package. If you wish to experiment with it, rename it to FRIENDS.FIV so that SmartPhone will recognize it as a Five-Minute Database file. 24 8. SMARTPHONE LICENSING ------------------------ 8.1 Licenses for Individuals ----------------------------- SmartPhone and its related files, data and programs are not free. The entire SmartPhone package is a copyrighted software product created and owned by Pinnacle Software of Montreal, Quebec, Canada. SmartPhone is distributed as shareware. This means that you may freely evaluate the SmartPhone package for up to 45 days. At the end of this time, if you wish to continue using SmartPhone, you must purchase a registered copy from Pinnacle Software. To print out (or display) an order form, select "Print Form" from the main SmartPhone menu. If you do not have a printer, it will appear on your screen. Registration payments must be in U.S. dollars, drawn on a U.S. bank. Canadians may remit payment in Canadian funds drawn on a Canadian bank. Payment can be by cheque or money order. Orders paid by money order are in most cases shipped the same day. Orders paid by cheque may take a week or two to process. Upon receipt of your order, a copy of the registered version of SmartPhone will be sent to you. Distribution of registered versions of SmartPhone is strictly prohibited and will result in legal action against the distributor. 8.2 Corporations and Institutions ---------------------------------- After the 45-day evaluation period, corporations and institutions must purchase a license to continue using SmartPhone. This license allows internal use and copying of the SmartPhone package by as many machines as are licensed. The license fee is based upon the number of machines on which SmartPhone will be running. See the order form for details. Regardless of the quantity licensed, one diskette containing the registered program and documentation will be sent to you. Upon receipt, you may make as many copies of the package as are licensed. 25 Non-exclusive licenses for corporations and institutions to distribute, repackage or resell SmartPhone to third parties are available. Contact us for details. Disk vendors, clubs, user groups and computer bulletin boards may distribute the UNREGISTERED version of the software without a distribution license provided the entire unaltered SmartPhone package is included in the distribution and a fee not to exceed U.S. $9 is charged for each copy so distributed. Distribution of registered versions of SmartPhone is strictly prohibited and will result in legal action against the distributor. 8.3 Technical Support ---------------------- If you need technical support for SmartPhone or any of our other products, you may call or write to us (see "How to Contact Us"). While we reserve the right to charge (with prior notice) a fee for technical support, we are happy to provide you with a little bit of free help when you need it. You do not have to be licensed to call for technical support. Support requirements exceeding one half hour per client per product are billed (with prior notice) at a rate of $45 per hour. 8.4 Warranty ------------- SmartPhone is licensed "as is", without any warranty of merchantability or fitness for a particular purpose, performance, or otherwise. All warranties are expressly disclaimed. By using SmartPhone, you agree that neither Pinnacle Software nor any officers, directors, employees, shareholders, affiliates, owners, or other related parties will be liable to you or any third party for any use of (or inability to use) or performance of this product, or for any damages whatsoever whether based on contract, tort or otherwise even if we are notified of such possibility in advance. (Some states and provinces do not allow the exclusion or limitation of incidental or consequential damages, so the foregoing limitation may not apply to you.) 26 9. NOTES ABOUT THE LISTINGS ---------------------------- 9.1 Time Zones --------------- All time zone information is listed in relation to North American standard times. No adjustment is made for "Daylight Savings Time", since this is not used everywhere, even in North America. (For example: Newfoundland experimented with "Double Daylight Savings Time".) Standard times should be interpreted as in the following example: - Pacific 8 AM - Rocky 9 AM - Central 10 AM - Eastern 11 AM - Atlantic Noon For an explanation of how SmartPhone treats time-zones outside the standard North American time zones, refer to the section entitled "The City Window". 27 9.2 Spelling ------------- There are frequently several commonly used spellings for a foreign name. Consider Beijing versus Peking, or Rejkjavik versus Rekyavik. In some cases, we provide alternative spellings in parentheses. All occurrences of "St." and "Ste." are replaced with "St-" and "Ste-" as this is a common feature of many phone books. "San" (as in San Francisco), is left as is. Accents and other special characters are always omitted. In transliterating other names into English, various authorities apply various "rules" with varying degrees of enthusiasm. If you wish to research this dilemma, you can sometimes obtain a "style book" from your local newspaper which explains how they transliterate names. Transliteration is a problem that seriously affects SmartPhone, but we can't claim that we've come up with a solution. The problem plagues all media. A good example in recent memory is the spelling of the name of the leader of Libya. His last name was spelled "Kaddafi", "Qadaffi", with countless variations on either spelling. 9.3 International Dialing Codes -------------------------------- The international codes listed (e.g. +299 for Greenland) have been checked only insofar as they are useful in North America and the Caribbean. They may be used in other countries, but we have no way of checking the direct- dialing service offered by every country. When in doubt, consult your local telephone operator. 28 10. BACKGROUND INFORMATION --------------------------- 10.1 Product History --------------------- SmartPhone is based on a program we wrote named Area Code Hunter. AC Hunter Version 1.0 was given some minor distribution in 1988 as a simple command-line reference work. It proved both useful and popular, so we added some "friendly" features (such as a main menu) during 1990, and launched Version 2.0. Some additional fancy items were added to make Version 3.0, which was selected by "Compute" magazine to be the top-billed program of its "On Disk" feature. (See "Compute", Feb. 1991. "Compute" is published by the same people who brings us "Omni" magazine.) At that time, we only listed major population centers, giving us a database of no more than 5000 cities and towns. Version 4.0 brought in TSR support and the notebase. We were now receiving high quality, current information from various sources, enabling us to increase the database to over 11,000 cities and towns by version 4.2. After version 4.2, we added the "Five Minute Database" feature, and it became obvious that the product was more than an "Area Code Hunter", so we renamed it to "SmartPhone". There are plenty of ways that SmartPhone can be improved, and we fully intend to keep adding those improvements. It is our goal to make SmartPhone the perfect telephone companion! 10.2 About Pinnacle Software ----------------------------- Pinnacle Software is a computer consulting company based in Montreal, Quebec, Canada, and Swanton, Vermont, U.S.A. We have been issuing shareware since 1986 and are generally considered to be the most prolific authors of shareware in Canada. 29 10.3 Some Examples of How SmartPhone Can Help You -------------------------------------------------- 10.3.1 Get Fast Answers You have a problem with a computer program, and the manual gives the address of the company -- but no phone number. Use SmartPhone to zero in on the area code, then call long-distance information (1-XXX-555-1212) to get the phone number of the company. Much faster than writing a letter! 10.3.2 Fill in Missing Information You get this message on your answering machine: "My name is Fred Jones, calling from Pensacola, Florida. Please call me back at 555-3866." He forgot to leave his area code! With SmartPhone, that's not a problem! 10.3.3 Avoid Wasted Calls You check a customer's number with SmartPhone and notice that the time zone is three hours later than yours. It's 9:15 AM, so you hold off placing the call, since he's probably out having lunch. 10.3.4 SmartPhone Can Save You Money! SmartPhone can pay for itself if you sometimes work late. If you have to return calls to time zones further West, you can wait until the long- distance rates go down. For example, if you're in New York (Eastern Time), you can save money by waiting until dinner time to return calls to California (Pacific Time). When it's 6:30 PM in New York, it's 3:30 PM on the West Coast. People on the West Coast can save money when they start working a little early. If it's 7:30 AM in Anaheim, it's 10:30 AM in Boston. So you can call a wide-awake client on the East Coast while taking advantage of low off-prime-time long-distance rates. 30 11. INDEX ---------- >>DATA 20, 23 Configuration 16 >>FRAME 20, 23 Copyright 25 >>HEADER 20, 22 Corporations 25 >>SORT 20, 22 Country codes 12 >>TITLE 20, 21 Cursor 11 >>VERSION 20, 21 Cursor-bar 10 10CODZIP.FIV 19 Customize 16 3.5 inch 6 DATA 10, 20, 22, 23 5.25 7 Database 15, 19, 24 5.25 inch 6 Databases 19 A: 5-7 Daylight Savings 27 AC 29 Delete 11 Accents 28 DIR 20 Active window 13 Directory 20 Alphabetical 14 Discounts, 25 Alt-Space 17 Disk vendors 26 Applications 19 Diskette 4-7 Archive 4 Distribution 26 Area code 9, 11-13, 29 DOS 9 Area Code Hunter 4, 7 DOS prompt 7, 9, 15, 17 Arrow 14, 15 DOS Shell 7, 10 Arrow keys 10, 15 Dots 14 Atlantic 14, 27 Down Arrow 14 AUTOEXEC 6 Download 4 B: 5, 6 Drive 6, 7 Backspace 11 Eastern 14, 27 BBS 3, 26 EDIT 20 Box 23 Editing 11, 15 Browse 13 EDLIN 20 Bulletin boards 26 End column 22 Canadian 3 Equals-sign 12 Capitals 15 Esc 10, 11, 15, 16 CD 9 Evaluate 25 Central 14, 27 Evaluation 25 Cheque 25 F Key 15 City 13 F1 11 City Window 14 FIV 20, 21 Clubs 26 Five-Minute 15, 19 Color 16 Floppy 6 Column 23 FORM 10, 16 Command Line 9 Format 6 Comment 20 Frame 23 Comments 7, 13, 14, 18, 21 Friends 19, 24 COMMENTS.DAT 7 FRIENDS.TXT 20, 24 CompuServe 3 Function keys 10 Compute 29 GEnie 3 31 GO 7 RAM disk 18 Hard disk 6, 18 Records 15 Hard-disk 5 Register 16, 25 Header 22 Resident 17 Help 9 Right arrow 11 Highlight 10, 14 Rocky 14, 27 History 29 Sample Database 24 Hunt 9-11, 13, 14 San 28 Hunt Screen 9 Scroll 13, 15 Indent 22-24 Search 11, 12, 15 INFO 10, 16 Semicolon 20, 21 Insert 11 Shareware 25 Installation 4, 7 Shareware Vendor 4 Institutions 25 Shift-Tab 13 Label 6 Slot 6 Language 15 Sort 20, 22 Left arrow 11 Sound 16 License 25 Sounds like 12 Line 23 SP ? 9, 17 Lines 20, 23 SP.EXE 7, 10 Lists 19 SPEC 4, 10, 16 Log 7 Spelling 28 LPT1 16 St. 28 Mail 3 St- 28 Mailing abbreviation 12 Start 4, 17 Main menu 10, 16 Start column 22 Menu 22 Starting 9 Minutes 19 Ste. 28 Modem 4 Ste- 28 Monochrome 16 Support 26 Notebase 7, 10, 14 Swap 18 Offset 14 Tab 13, 15 Omni 29 Text editor 15, 19 Order form 16, 25 Text files 20 Pacific 14, 27 Time zone 14 Page 15 Time zones 14, 27 PATH 6, 9 Title 20, 21 Payments 25 Titles 20 Phone 3 Tranliterating 28 Pinnacle 29 TSR 9, 17, 19 Plus 12 Update 20 Pop-up 9, 15, 17, 19 Upgrades 16 Population 15 Upgrading 4, 7 Print 25 User groups 26 Print form 10 Version 20, 21 Printer 16 Warranty 26 QEdit 20 Window 13, 14 Quantity discounts 25 Word processing 20 Question mark 12 Zip codes 15 Quick Install 5 Quick-reference 10, 15 QUIT 10, 16 32