home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / fac135.zip / FAC.DOC < prev    next >
Text File  |  1990-11-16  |  48KB  |  1,022 lines

  1.  
  2.  
  3.                      Find Area Code (FAC), Version 1.35
  4.  
  5.                              Copyright (c) 1990
  6.                              All Rights Reserved
  7.  
  8.  
  9.                      Developed and Marketed as Shareware
  10.                                      by
  11.                               Michael K. Molloy
  12.                           8531 East Dry Creek Place
  13.                              Englewood, CO  80112
  14.                            CompuServe: 72737, 3237
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                          F I N D   A R E A   C O D E
  21.  
  22.                           D O C U M E N T A T I O N
  23.  
  24.  
  25.     Table of Contents
  26.  
  27.       o Introduction
  28.       o Files Included
  29.       o Installation
  30.       o Using FAC from the MSDOS Command Line
  31.       o Using FAC as a Popup TSR Program
  32.       o What Are Swapping TSRs?
  33.       o Advanced Options and Configuration
  34.       o Error Conditions
  35.       o Technical/Compatibility Notes
  36.       o How to Reach the Author
  37.       o Alternative Uses
  38.       o Final Remarks
  39.       o Quick Reference List of FAC Options
  40.  
  41.  
  42.     Introduction
  43.     ------------
  44.  
  45.     Find Area Code (FAC) is an MSDOS utility which can quickly locate
  46.     U.S. and international telephone area codes.  FAC performs its
  47.     search using any part of an area code, city, state, or country and
  48.     shows matches almost instantly.  The program can also do "fuzzy"
  49.     searches, allowing you to use approximate spellings to find matches.
  50.  
  51.     FAC uses an ASCII data file (FAC.DAT) which you can change, update,
  52.     or add to whenever you like.  There are about 120 U.S. area codes in
  53.     the database, and about 150 foreign countries with over 450 city
  54.     codes.
  55.  
  56.     You can run FAC from the MSDOS command line or you can make it
  57.     memory resident (also known as a popup or Terminate and Stay
  58.     Resident [TSR] program).  When you install FAC as a memory resident
  59.     program, you can choose between a small (7K of RAM) swapping version
  60.     with a short (less than 2 second) delay while it swaps into memory
  61.     from disk, or you can have an instantly available popup which
  62.     requires about 120K of RAM.
  63.  
  64.     The program automatically senses and supports all of the 25/43/50
  65.     line modes used in most CGA/EGA/VGA video cards and pops up in the
  66.     current mode, using the screen most appropriately for that mode.
  67.     FAC's window can be moved around on the screen by using the cursor
  68.     keys.  You can also "zoom" FAC's window to use the full screen.
  69.  
  70.     Although you didn't pay anything to get this copy of FAC, FAC is not
  71.     a free program.  It is distributed on a "shareware" basis.  If you
  72.     try the program and continue to use it, I ask you to send me $10.00
  73.     (ten dollars) to make it possible to continue to develop affordable
  74.     software like this.  Though the program is not "crippled" in anyway,
  75.     this shareware version will remind you (with a brief delay as you
  76.     exit the program) to register the program.  You'll see this reminder
  77.     about every fifth time you use FAC.  Naturally, the registered
  78.     version of the program won't do this.
  79.  
  80.     FAC is one of many area code finder utility programs, but I think
  81.     you'll find it is unsurpassed in speed, ease of use, convenience,
  82.     and price.  As far as I know, it is the ONLY area code finder
  83.     capable of being installed as a 7K memory resident program.
  84.  
  85.     When you register, you'll receive a disk with the latest version of
  86.     the program and a utility to stamp your serial number on all future
  87.     versions of the program.  Once you have registered FAC, you are
  88.     always entitled to the latest version at anytime.  You can either
  89.     download the latest version from CompuServe, a BBS, or other
  90.     computer service or I'll send you the latest release for only the
  91.     cost of sending the disk.  You can either send me a SASE floppy
  92.     mailer with your floppy, or just send me $3.50 and I'll furnish the
  93.     floppy, mailer, and postage.
  94.  
  95.     If you send $20, I'll send you the Turbo Pascal 5.5 source code
  96.     (less code licensed only to me).  I'll include the public domain
  97.     RLINE (public domain) and TP String (shareware) files, as well (see
  98.     Technical/ Compatibility Notes, below).  I can't include any of
  99.     TurboPower Software's Object Professional units or source code.  You
  100.     should still be able to figure out what's going on and whether you
  101.     want to get Object Professional (you will!).  Obviously, if you
  102.     purchase the source code it's only for your personal use (you can't
  103.     distribute it or sell it).  Contact me for reasonable site license
  104.     and quantity discount information.
  105.  
  106.     Please feel free to distribute the program to anyone you wish.
  107.     Please don't distribute:  1) modified versions; and 2) registered
  108.     versions.
  109.  
  110.  
  111.     Files Included
  112.     --------------
  113.  
  114.     FAC only requires that two files be present: FAC.EXE and FAC.DAT,
  115.     but comes with other documentation files.  The complete FAC package,
  116.     distributed as FACXXX.ZIP (where XXX is the version number), has the
  117.     following files (the " ~ " means the file MUST be present to run the
  118.     program):
  119.  
  120.                FAC.EXE ~  The executable program
  121.  
  122.                FAC.DAT ~  The Area Code database, an ASCII file which
  123.                           you can modify in any way you like.
  124.  
  125.           STAMP-SN.EXE -  (Only for registered users.  See Installation.)
  126.  
  127.             README.1ST -  Description of program and summary of features
  128.  
  129.             UPDATE.LOG -  History of changes/versions
  130.  
  131.               FAC.DOC  -  Documentation (you're reading this now)
  132.  
  133.  
  134.     Installation
  135.     ------------
  136.  
  137.     You can put Find Area Code's files in any directory.  The FAC.EXE
  138.     and FAC.DAT files can be anywhere on the disk as long as you set a
  139.     path to them with the MSDOS PATH statement.  Note that FAC.DAT need
  140.     not be in the same directory as FAC.EXE as long they are both on the
  141.     PATH.  For example, if you put FAC's files in the C:\UTIL directory,
  142.     you would need to have a PATH statement in your AUTOEXEC.BAT file
  143.     which might look something like this:
  144.  
  145.                    PATH=C:\;C:\DOS;C:\MISC;C:\UTIL;C:\MENU
  146.  
  147.     You need about 120K of disk space and 128K RAM to run the program
  148.     from the MSDOS prompt (non-TSR mode).  To use the program as a
  149.     swapping TSR, you must have an additional 240K of free disk space
  150.     for the swap files.  A hard disk is recommended.
  151.  
  152.     When you register FAC, you'll receive an additional program which is
  153.     used to "stamp" a registered serial number on your copy (and all
  154.     future copies) of your program.  Stamping the serial number also
  155.     disables the random delay/message reminding you to register the
  156.     program.
  157.  
  158.     To run this program, type "STAMP-SN" at the MSDOS prompt, and press
  159.     ENTER.  You'll be asked for the name of the EXE file to modify
  160.     (since FAC.EXE could be renamed to whatever you want).  If you're
  161.     using FAC.EXE, just press ENTER.  If the file is found on the PATH,
  162.     it will be stamped with a serial number identified with your
  163.     registration.  BE SURE to save you copy of STAMP-SN.EXE so you can
  164.     use it with future releases of FAC.
  165.  
  166.     If you're a user of various executable-file compression utilities
  167.     like LZEXE, PKLITE, or EXEPACK, you MUST run STAMP-SN on the
  168.     unmodified (uncompressed) original file BEFORE you use on of these
  169.     utilities.  If you try to run STAMP-SN on a compressed EXE file,
  170.     you'll be unable to stamp the serial number.
  171.  
  172.     If you are a registered user of FAC, you MAY NOT give anyone a copy
  173.     of the serial number stamped program, nor may you give anyone the
  174.     STAMP-SN.EXE program.
  175.  
  176.     Using FAC from the MSDOS Command Line
  177.     -------------------------------------
  178.  
  179.     First, you must know how to invoke FAC from the MSDOS command line
  180.     prompt.  Type "FAC /H" (or "FAC /?" or "FAC /" or "FAC ?") then
  181.     press ENTER and you'll see a complete list of options you have for
  182.     using FAC.  Don't be alarmed at all the options.  FAC is very simple
  183.     to use and really requires only one thing--a string to search for.
  184.     All the options are for more advanced use.  FAC is designed to be
  185.     very easy to use without reference to documentation or help screens.
  186.  
  187.     FAC will immediately search for area code information if you enter
  188.     the search string as an MSDOS parameter after the program name.  If
  189.     you wish, you can simply type "FAC" to start the program without a
  190.     parameter.  You'll be prompted for a search string once inside the
  191.     program.  For example, suppose you wanted to know the area code for
  192.     Boulder, Colorado.
  193.  
  194.     At the MSDOS prompt, type: "FAC boulder" (without the quotes, of
  195.     course) then press ENTER.  The program will start, a window will
  196.     popup on the screen, and the program automatically begins its
  197.     search.  Almost instantly, you'll see information about the area
  198.     code for Boulder.  The first column in the display window has the 3
  199.     digit area code 303 (international area codes aren't necessarily 3
  200.     digits).  The next column shows the 2 character postal abbreviation
  201.     for Colorado, CO.  The third column shows the full name of the
  202.     state.  The last column shows the major cities in this particular
  203.     area code.  Notice Boulder appears in this list.  When you've
  204.     finished with the program, just press Esc and you'll exit back to
  205.     MSDOS.
  206.  
  207.     Let's take another example.  Suppose someone leaves you a note to
  208.     call someone in a 309 area code.  You don't recognize this area code
  209.     and it's inconvenient to look up the area code in the phone book.
  210.     You type "FAC 309" then press ENTER.  Almost instantly, you learn
  211.     that the 309 area code includes Peoria, Molina, and Rock Island,
  212.     Illinois.
  213.  
  214.     Searching for an international area code is almost exactly the
  215.     same. Just type in a city name, say Paris.  The program will display
  216.     the country code in the first column, the country name in the next
  217.     column (there is no postal abbreviation for most foreign countries),
  218.     and a list of major cities and city codes for that country in the
  219.     last column. Each city code is listed in parentheses immediately
  220.     after the city name. So you know the country code for France is 33
  221.     and the city code for Paris is 1.
  222.  
  223.     You get the idea.  By typing "FAC X" where X is any alphanumeric
  224.     string, you can quickly search the area code database.  You can
  225.     search by area code, state postal abbreviation, state name, country,
  226.     city, or any portion of thereof.  The search string can be in any
  227.     combination of upper or lower case letters and numbers.
  228.  
  229.     NOTE: If you use only two characters, the program assumes you want
  230.     to search for two-letter state postal abbreviations which appear
  231.     only in the first 7 characters of each line.  The program doesn't
  232.     look at anything else on the line except these first 7 characters.
  233.  
  234.     Once you're inside the program, you can search for other area code
  235.     information by entering another search string at the prompt.  Search
  236.     strings are limited to 11 characters.  To edit your entry, press
  237.     Backspace, or press Esc to erase your entire entry. If you press Esc
  238.     once more, you'll exit the program.  You can make any number of
  239.     searches before exiting the program.  Remember, just press Esc to
  240.     exit the program (Ctrl-C or Ctrl-Break will also exit).
  241.  
  242.     While you're inside FAC, you can get help by pressing F1.  This
  243.     shows you that F1 gets help, F2 toggles the "Fuzzy" search mode, and
  244.     Esc exits the program.  See Advanced Options and Configuration for a
  245.     full discussion of the very powerful fuzzy search mode.
  246.  
  247.     Sometimes, your search string will find more information than can be
  248.     displayed in the window.  If the screen fills up with information,
  249.     the program will pause and prompt you to press the Esc key to stop
  250.     displaying information from the current search, or press any other
  251.     key to continue displaying information.  If you press Esc to stop
  252.     displaying information, you'll be returned to FAC's prompt.  Pressing
  253.     Esc once more will exit the program.
  254.  
  255.     If FAC doesn't find a match for your search string in its data file,
  256.     you'll see a brief message in the center of the window saying that
  257.     the string couldn't be found.
  258.  
  259.     Once you've experimented with FAC, you may notice that sometimes it
  260.     pops up in the upper half of your screen and sometimes it pops up in
  261.     the lower half.  Why?  FAC looks at where the cursor is positioned
  262.     and brings up the FAC window in the opposite half of the screen
  263.     you're working in.  This insures the program doesn't obscure
  264.     something you may need to see while you're using the program.
  265.  
  266.     The other thing you may have noticed is that FAC pops up in whatever
  267.     mode (25, 43, or 50 lines) your video card is in.  FAC automatically
  268.     checks to see how many lines you're using at the moment and adjusts
  269.     its windows accordingly.  FAC isn't designed to support 40 column
  270.     mode, but will safely pop up (although you won't like what you see).
  271.     FAC won't popup at all when you're in graphics mode.
  272.  
  273.     You can reposition FAC's window anywhere on the screen by pressing
  274.     the cursor keys.
  275.  
  276.     To "zoom" the FAC window to take up the full screen, press F10.
  277.     Press F10 again, and the window will "unzoom."
  278.  
  279.  
  280.     Using FAC as a Popup TSR Program
  281.     --------------------------------
  282.  
  283.     More often than not, when you're at your computer and you need area
  284.     code information, you're in the middle of doing something else.  To
  285.     use FAC as described above, you must save your work, exit the
  286.     program you're using, then invoke FAC.  FAC would tell you what you
  287.     need to know, then you would have to restart your original program,
  288.     go back to where you left off, and try to go back to work.
  289.  
  290.     It would be much more convenient if you could simply have FAC
  291.     immediately "popup" over whatever you're doing, give you the
  292.     information you need, then go away, leaving you exactly where you
  293.     were.  Not only would it be more convenient, it would save a lot of
  294.     your valuable time.
  295.  
  296.     FAC can do this.  All you have to do is tell FAC to install itself
  297.     as a "popup" or memory resident program.
  298.  
  299.     You'll also see this type of program called a TSR, which stands for
  300.     Terminate & Stay Resident.  A TSR is installed or loaded once from
  301.     the MSDOS command line.  It stays in memory even while you're doing
  302.     other things, and watches to see when you press a special key or key
  303.     sequence to activate it.  This special key sequence is known as a
  304.     "hotkey".  When you press the hotkey, the program starts.
  305.  
  306.     Here's how to install FAC as a memory resident, popup program.  At
  307.     the MSDOS prompt, type: "FAC /I" (without the quotes) then press
  308.     ENTER.  FAC will then install itself in memory as a TSR.  When it
  309.     has successfully installed itself, it will describe how it has been
  310.     installed.  In this case, you will use FAC's defaults.
  311.  
  312.     Once you've installed FAC as described above, you can press FAC's
  313.     hotkey to pop it up wherever you are.  FAC's hotkey is
  314.     <Alt><LeftShift><F>.  To press this key sequence, press and hold the
  315.     "Alt" key, press and hold the Shift key on the left side of your
  316.     keyboard, then press the F key. As soon as all three keys are
  317.     pressed, FAC will "wakeup" and activate itself.
  318.  
  319.     FAC will draw its window on the screen right over the top of
  320.     whatever you're doing.  Don't worry.  When FAC is done, it will
  321.     return the screen to exactly the way it found it.
  322.  
  323.     When you invoke the TSR version of FAC as installed above, it works
  324.     somewhat differently than it does when you start it from the MSDOS
  325.     prompt.  Recall that when you run the program from the MSDOS prompt,
  326.     you must enter a parameter (search string) so FAC knows what to
  327.     search for. When FAC operates as a TSR, it can read the text string
  328.     (state, area code, city, etc.) you want to search for right off the
  329.     screen by looking at the word "under" or to the left of where you
  330.     have the cursor positioned!  (You can turn off reading the search
  331.     string from the screen by using the /G switch.  See Advanced Options
  332.     and Configuration.)  If the cursor isn't in a word or just to the
  333.     right of a word, no search string will be passed to FAC, but it will
  334.     still pop up.  Reading the search string from the screen can save
  335.     you time typing in what to search for and it can avoid errors you
  336.     might make while typing.
  337.  
  338.     So, what happens?  You press the hotkey, FAC pops up over your work,
  339.     reads the text "under" the cursor, and immediately begins its
  340.     search. After it finds and displays a match, it prompts you for
  341.     another search. Now the program operates exactly the way it does
  342.     when used from the MSDOS prompt.
  343.  
  344.     If you use the cursor keys to reposition the normal FAC window, the
  345.     position you choose will be retained the next time you press the
  346.     hotkey.  Note that this means that because you've repositioned the
  347.     window, it may pop up and obscure text near the cursor.  If this is
  348.     a problem or you want to "reset" window positioning to pop up in the
  349.     opposite half of the screen from the cursor, just press F10 (once if
  350.     you are zoomed, twice if you aren't zoomed) and the automatic
  351.     positioning will be restored.
  352.  
  353.     You can press F10 to zoom FAC's window to take up the full screen,
  354.     and the program will "remember" to pop up in this mode the next time
  355.     you press the hotkey.
  356.  
  357.     When you want to exit, press Esc, and FAC will collapse its window,
  358.     and restore your screen and cursor location exactly the way it
  359.     appeared when you pressed the hotkey.
  360.  
  361.     What Are Swapping TSRs?
  362.     -----------------------
  363.  
  364.     You may have noticed that when you pressed the hotkey, a reverse
  365.     video message appeared on the bottom of the screen which said
  366.     "Swapping in..."   Similarly, when you pressed Esc to exit the
  367.     program, "Swapping out..." appeared.  These messages tell you the
  368.     program is swapping into and out of memory (RAM) from disk.  Why
  369.     does the program do this?
  370.  
  371.     Swapping TSRs are relatively new.  When they install, they take a
  372.     snapshot of the complete program and write it out to a "swap file"
  373.     on disk, then free up all but a tiny portion of memory (which holds
  374.     the portion of the program which watches for the hotkey and then
  375.     does the actual swapping to/from disk).  When swapping TSRs pop up
  376.     over your existing program, they may also have to take a snapshot of
  377.     your application and write it to disk before it swaps the rest of
  378.     the TSR in. So why do we want to put up with all this swapping in
  379.     and out?  Doesn't this cause delays?  Why can't the program just pop
  380.     up instantly like my other TSRs?
  381.  
  382.     Well, like everything else in the world, there are tradeoffs.  In
  383.     order to run full-featured, advanced programs, it takes memory
  384.     (RAM).  The more full-featured the program, the more memory it
  385.     takes.  Unfortunately, memory is a limited resource and
  386.     "full-featured" often translates to "memory-hungry."  FAC has many
  387.     features but still only requires about 128K of RAM to run.  This
  388.     isn't a problem if FAC is the only program you want to run, but it's
  389.     a big problem if you want FAC to be loaded as a TSR at the same time
  390.     you're running other (full-featured) programs.
  391.  
  392.     When FAC is installed as a swapping TSR, it only requires about 7K
  393.     of RAM to watch for you to press the hotkey and then swap what
  394.     you're doing out and swap itself in.  With all the other TSRs you
  395.     use and the other programs you run, you need all the help you can
  396.     get.  The TSR swapping technology FAC uses helps you optimize all
  397.     the memory you have with very little impact on how you use the
  398.     program.  As computers continue to become faster and more powerful,
  399.     you'll see more and more swapping TSRs.
  400.  
  401.     The time you spend waiting on swapping is relatively trivial
  402.     compared to the time it takes to leave your application, then
  403.     return.  On XT class computers, swapping delays are only about 1 or
  404.     2 seconds.  On 286 class computers, delays are usually less than 1
  405.     second.  On 386 and 486 class computers, delays are usually less
  406.     than .5 seconds.  Of course swapping delays can be affected by a
  407.     wide range of hardware and software variables.  Fast hard disks with
  408.     1:1 interleaves and high data transfer rates make a huge difference,
  409.     even when used on an 808X CPU.  If you're able to use a RAM Disk, or
  410.     disk caching (hardware or software) you'll find swapping delays to
  411.     be negligible or even unmeasurable.  See the section below on
  412.     Advanced Options and Configuration for information on how to reduce
  413.     swapping delays.
  414.  
  415.     The bottom line: I think the tradeoffs (disk swapping delays) are
  416.     completely acceptable given the tremendous savings in your precious
  417.     RAM. I think you'll think so, too!  (Note:  future versions of FAC
  418.     should allow swapping to either extended or expanded memory.)
  419.  
  420.  
  421.     Advanced Options and Configuration
  422.     ----------------------------------
  423.  
  424.     FAC has several different options or "switches" you can use to
  425.     customize the way FAC works when you invoke the program or install
  426.     it as a popup.  Again, FAC is designed to be very easy to use, and
  427.     you may be perfectly happy with FAC's performance when you use its
  428.     default options.
  429.  
  430.     Switch options are always preceded by either a "/" or a "-" and can
  431.     be upper or lower case letters.  Remember, to see a complete list of
  432.     all FAC's options, just type "FAC /H" at the MSDOS prompt and press
  433.     ENTER.  Here's a quick summary of FAC's switches:
  434.  
  435.           /F     Enables "fuzzy search" mode
  436.           /I     Loads popup/TSR with defaults
  437.           /N     No swapping; used with /I
  438.           /M     Suppresses swapping messages; used with /I
  439.           /P     Path for swap files; used with /I
  440.           /G     Don't read text from screen on popup; used with /I
  441.           /U     Unload popup from memory, if possible
  442.           /X     Don't use exploding windows
  443.           /Z     Use a "zoomed" window which uses the full screen
  444.  
  445.     Most of these switches can be used in either of two ways: 1) as
  446.     command line switches, entered when the program is run; or 2)
  447.     entered as part of an environment variable called "FAC". If you
  448.     wanted the program to use the fuzzy search mode, you could simply
  449.     enter  "FAC bolder /f" and the search would take place, using the
  450.     fuzzy search.  But, what if you wanted FAC to ALWAYS start in
  451.     (default to) fuzzy mode?  This is where the FAC environment variable
  452.     would be used.  Use the SET command to assign a string to the FAC
  453.     environment variable:
  454.  
  455.                                SET FAC=/f
  456.  
  457.     If you entered this before running FAC or had this line in your
  458.     AUTOEXEC.BAT file, FAC would always start in fuzzy mode without
  459.     having to enter it on the command line when you start the program.
  460.  
  461.     Suppose you always wanted FAC to use fuzzy search mode, zoomed
  462.     windows, non-exploding windows, and when installed as a TSR: no
  463.     swapping messages with a swap file path of d:\temp and without
  464.     getting search strings from the screen.  Instead of entering each of
  465.     these switches each time you run the program, you would use the
  466.     following environment variable entry, preferably in your
  467.     AUTOEXEC.BAT file:
  468.  
  469.                       SET FAC=/f /Z -x /M -pd:\temp /g
  470.  
  471.                                ^  ^  ^  ^  ^         ^
  472.     Fuzzy mode ----------------+  |  |  |  |         |
  473.     Zoomed window ----------------+  |  |  |         |
  474.     Non-exploding window ------------+  |  |         |
  475.     Swapping messages off --------------+  |         |
  476.     Swap path -----------------------------+         |
  477.     Don't get search string from screen -------------+
  478.  
  479.     Now, every time FAC is run the above settings will be the defaults.
  480.     If you install the program as a TSR, these settings will be the
  481.     default settings unless you change them after invoking the program
  482.     with the hotkey.  If you change them while TSR, that change will
  483.     remain effective until the next time you change it.
  484.  
  485.     Note the use of both a slash and dash as switch characters and the
  486.     mixed use of upper and lower characters.  You can use all FAC option
  487.     switches in the SET FAC environment variable except /I and /U.  You
  488.     can use any combination of switches in any order.  Invalid switch
  489.     settings will be ignored.  If you enter a swap path with the /P
  490.     switch, it will be checked for validity prior to program execution.
  491.  
  492.     The following is a complete description of all FAC option switches.
  493.  
  494.  
  495.     The "/F" Switch
  496.     ---------------
  497.  
  498.     Used for both non-TSR and TSR.  Can be used in the FAC environment
  499.     variable.
  500.  
  501.     The /F switch says, "Use a 'fuzzy' search method which doesn't
  502.     require an exact spelling to get a match."  When you use the /F
  503.     switch, you tell the program to use a powerful text matching
  504.     technique called the soundex algorithm.  Soundex searches attempt to
  505.     match words based on the way they sound rather than by how they're
  506.     spelled.  If you aren't sure how a city, state, or country is
  507.     spelled, or you're getting a 'not found' message with the string
  508.     you're using, try the /F switch.
  509.  
  510.     There is a price to pay for the soundex searching method: speed.
  511.     Searches may take up to 10 times as long as normal "exactly spelled"
  512.     searches, but this is well worthwhile if it's the only way you can
  513.     find what you're looking for.  You may also get a lot more seemingly
  514.     unrelated "hits" from a fuzzy search, but this is normal.  After
  515.     all, you're looking for anything that remotely resembles or sounds
  516.     like your search string.
  517.  
  518.     Since fuzzy searches take longer, you may need to stop the search
  519.     before it completes.  You can press any key during the fuzzy search
  520.     and it will stop and return to the program's prompt.
  521.  
  522.     Once you're inside FAC, you can use the F2 key to toggle between
  523.     normal searching and fuzzy searches (there's an indicator on in the
  524.     top center of the window frame when you're in fuzzy mode).  If
  525.     you've installed FAC as memory resident program, the program will
  526.     remember whether you were in fuzzy mode the last time you used it.
  527.  
  528.     Examples: "FAC Colorawdo /f"
  529.               "FAC springfeild /f"
  530.  
  531.     In both these examples, the program would immediately start
  532.     searching for the specified strings, but the 'Fuzzy Search'
  533.     indicator would be on at the top center of the window frame, and you
  534.     would also see a flashing message telling you the search is in
  535.     progress.  The first example would give you "hits" for Colorado,
  536.     even though it's misspelled.  The second example would find three
  537.     instances of Springfield as you might expect, but also yields Palm
  538.     Springs, Steamboat Springs, Colorado Springs, and Big Spring.
  539.  
  540.  
  541.     The "/X" Switch
  542.     ---------------
  543.  
  544.     Used for both non-TSR and TSR.  Can be used in the FAC environment
  545.     variable.
  546.  
  547.     This option or program "switch" applies to FAC when run from the
  548.     MSDOS prompt (non-memory resident mode) or when you install it as a
  549.     popup.  If you use the "/X" switch, FAC will disable its use of
  550.     exploding windows. Exploding windows don't change the way the
  551.     program searches or the way you use it, it just changes how the
  552.     program looks when it starts and finishes.
  553.  
  554.     If you want to disable exploding windows when you run the program
  555.     from the MSDOS command line (non-TSR), just put the /X switch after
  556.     your search parameter.
  557.  
  558.     Example:  "FAC boulder /x"
  559.  
  560.     When the program starts, the window would appear instantly on the
  561.     screen instead of being exploded onto the screen.
  562.  
  563.  
  564.     The "/Z" Switch
  565.     ---------------
  566.  
  567.     Used for both non-TSR and TSR.  Can be used in the FAC environment
  568.     variable.
  569.  
  570.     This option applies to FAC when run from the MSDOS prompt
  571.     (non-memory resident mode) or when you install it as a popup.  If
  572.     you use the "/Z" switch, FAC will "zoom" its window to take up the
  573.     entire screen.
  574.  
  575.     Example:  "FAC TX /Z"
  576.  
  577.     When the program starts, the window takes up the entire screen.  You
  578.     might want to use this option if you're viewing lists of area codes
  579.     or all the area codes for one state.
  580.  
  581.  
  582.     The "/I" Switch
  583.     ---------------
  584.  
  585.     Used to install FAC as a swapping or non-swapping TSR.  Can NOT be
  586.     used in the FAC environment variable.
  587.  
  588.     The /I switch says, "Install FAC as a memory resident program using
  589.     its defaults and/or other switches." If you use /I by itself, the
  590.     program will install itself using several predefined defaults, all
  591.     of which can be changed by using other switches.
  592.  
  593.     If you use /I alone to install FAC, the following defaults are used:
  594.  
  595.       - Swapping to disk is enabled.
  596.       - Messages which tell you swapping is happening are enabled.
  597.       - The disk and directory path FAC uses for swap files is the same
  598.         disk/directory where FAC found FAC.DAT.
  599.       - Exploding windows are enabled (see the /X switch above).
  600.  
  601.     After you use the /I switch to install FAC, you will see a status
  602.     message which describes the state of each of the above defaults.
  603.  
  604.     Note that if FAC is already installed, you won't be able to install
  605.     a second copy.  If you try to install it again, you'll get an error
  606.     message and the installation will abort.
  607.  
  608.     If you don't have enough disk space for the swap files, you'll get
  609.     an error message and FAC won't install as a TSR.
  610.  
  611.     After you install FAC as a TSR, don't move or rename the FAC.DAT
  612.     file or you will probably get dumped from the TSR when you try to
  613.     use it.
  614.  
  615.     Please note that you can't pop up FAC when you're using a program
  616.     which is currently in graphics mode.  If you try to pop it up,
  617.     you'll hear a beep and nothing else will happen.
  618.  
  619.     Also, be aware that since FAC swaps the currently running program
  620.     out so it can become active, you could have a problem with some
  621.     programs, especially communications programs.  In this case, you
  622.     should run the program in non-swapping mode (/N).  It still isn't
  623.     advisable to pop up any TSR when a communications program if data is
  624.     coming in or going out.
  625.  
  626.     FAC should work fine with most other TSRs.  The only problem you may
  627.     encounter is when you don't load FAC last among other TSRs.  This
  628.     won't hurt anything, but you may not have access to your other TSRs
  629.     when FAC is swapped in (since it may have swapped the other TSR(s)
  630.     out of RAM). If FAC isn't in use, or it's been installed as a
  631.     non-swapping TSR, you shouldn't have a problem with TSRs loaded
  632.     after it.
  633.  
  634.     Don't attempt to install FAC while you're "shelled out" of other
  635.     programs.  For example, you can drop temporarily to MSDOS from many
  636.     programs, but you should never try to install FAC while you're doing
  637.     so.  This also applies to many menuing programs like PowerMenus and
  638.     AutoMenu.  These programs can leave a portion of themselves in
  639.     memory.  You should never try to install FAC as a TSR from any menu
  640.     program.  Completely exit from any other program before attempting
  641.     to install FAC as a TSR.  You may run FAC from the MSDOS prompt
  642.     (non-TSR) while shelled out of another program if you wish.
  643.  
  644.     Example:  "FAC /I"
  645.  
  646.     This would install FAC as a TSR with the defaults described above.
  647.  
  648.     What follows is a more detailed discussion of these defaults, how
  649.     you can change them, and why you might want to.
  650.  
  651.  
  652.     The "/N" Switch
  653.     ---------------
  654.  
  655.     Used with /I to install FAC as a non-swapping TSR.  Can be used in
  656.     the FAC environment variable.
  657.  
  658.     The /N switch says, "NO swapping; don't use the swapping TSR mode;
  659.     keep the entire TSR in RAM."  This will give you instant access to
  660.     FAC when you press the hotkey, but requires about 120K of RAM.  If
  661.     you have plenty of RAM, you need FAC to be available instantly, and
  662.     you use programs which won't miss the memory FAC requires in this
  663.     mode, use the /N switch.
  664.  
  665.     The default is a swapping TSR.
  666.  
  667.     Example:  "FAC /I /N"
  668.  
  669.     This would install FAC as a non-swapping TSR.
  670.  
  671.  
  672.     The "/M" Switch
  673.     ---------------
  674.  
  675.     Used with /I when installing FAC as a swapping TSR.  Can be used in
  676.     the FAC environment variable.
  677.  
  678.     The /M switch says, "don't put the swapping in/out... messages at
  679.     the bottom of the screen when swapping."  The program doesn't work
  680.     any differently, except that you won't see the messages.  If you use
  681.     a RAM disk for swapping, the swapping messages might be an
  682.     unnecessary distraction.
  683.  
  684.     The default is to have swapping messages appear.
  685.  
  686.     Example: "FAC /I /M"
  687.  
  688.     This would install FAC as a swapping TSR, but swapping messages
  689.     would be disabled.
  690.  
  691.  
  692.     The "/P" Switch
  693.     ---------------
  694.  
  695.     Used with /I when installing FAC as a swapping TSR.  Can be used in
  696.     the FAC environment variable.
  697.  
  698.     The /P switch, when followed by a complete path specification, says,
  699.     "put the swap files in the specified disk/directory."  The path
  700.     specification must be a valid, already existing disk/directory, and
  701.     must be less than 127 characters.  Do not put a backslash on the end
  702.     of the path specification (unless you're using the root directory of
  703.     the specified disk).  In other words, use the same format for the /P
  704.     path specification that you would for a normal DOS PATH statement.
  705.  
  706.     The main reason you would use this switch would be to tell FAC to
  707.     use a RAM disk. If you have a RAM disk, with at least 240K of space,
  708.     you should use the /P switch to significantly speed up swapping. If
  709.     you use /P to swap to RAM disk, you may wish to use the /M switch to
  710.     disable the swapping in/out messages.
  711.  
  712.     It's highly inadvisable to use a removable (floppy) disk for the
  713.     swap path.  You won't harm anything, but you could lock up your
  714.     machine and have to reboot if the disk isn't there when swapping
  715.     needs to occur.
  716.  
  717.     Whether you use the /P option or not, FAC generates either one or
  718.     two swap files, named FAC-SWP1.$$$ and FAC-SWP2.$$$, each about 70K
  719.     in size, located wherever FAC.DAT was found (unless you specify
  720.     otherwise with the /P switch).  These files are marked with both
  721.     System and Hidden attributes to make it less likely you will
  722.     accidentally delete them.  If they are deleted after FAC is loaded,
  723.     and you try to pop up the program, you'll get an error message and
  724.     you'll have to reboot.  When you successfully unload FAC, the swap
  725.     files are deleted.  If you reboot or turn your machine off, the
  726.     file(s) will remain, but will be written over the next time FAC is
  727.     loaded as a TSR.
  728.  
  729.     The default is to put swap files in the same disk/directory where
  730.     FAC.DAT was found.  If you aren't sure where this is, run FAC with
  731.     no parameters and look at the default determined by the program at
  732.     run time.
  733.  
  734.     Examples: "FAC /I /Pd:"
  735.               "FAC /I /Pc:\junk
  736.  
  737.               "FAC /I /Pc:\temp\" <=== WRONG!! No backslash after the path!
  738.  
  739.  
  740.     The first example would install FAC as a swapping TSR with the swap
  741.     files located on the D: drive.  The second example would use a swap
  742.     file directory called C:\JUNK.  The third example is an invalid path
  743.     name and would give an error.
  744.  
  745.  
  746.     The "/G" Switch
  747.     ---------------
  748.  
  749.     When used with /I; don't get search strings from the screen in TSR
  750.     mode.  Can be used in the FAC environment variable.
  751.  
  752.     The /G switch says, "When you popup FAC, don't read the text to
  753.     search for off the user's screen; just ask for a string."  This
  754.     switch prevents you from grabbing the search string from the screen
  755.     and requires you to enter it yourself.
  756.  
  757.     The default is to read the screen for the text to search for.
  758.  
  759.     Example: "FAC /I /G"
  760.  
  761.     This example disables reading the text from the screen when FAC is
  762.     popped up.
  763.  
  764.  
  765.     The "/U" Switch
  766.     ---------------
  767.  
  768.     Attempts to uninstall FAC (in TSR mode) from memory, and delete swap
  769.     files, if they exist.  Can NOT be used in the FAC environment
  770.     variable.
  771.  
  772.     The /U switch says, "If it is safe to do so, remove FAC from RAM as
  773.     a swapping or non-swapping TSR, free up associated memory, and
  774.     delete any swap files which may have been created."  Use the /U
  775.     switch if you need to uninstall the program.  "If it is safe to do
  776.     so" means just that.  If FAC isn't installed as the last TSR, you
  777.     won't be able to uninstall it.  (You may be able to uninstall FAC by
  778.     using something like the Mark/Release TSRCOM utilities, but even
  779.     then, you must remove FAC and all TSRs loaded after it.  If you plan
  780.     to frequently uninstall FAC you should load it last.  Of course if
  781.     you load FAC last, then you won't be able to unload TSRs loaded
  782.     before it.  Naturally, you can uninstall any TSR by rebooting your
  783.     machine.
  784.  
  785.  
  786.     Error Conditions
  787.     ----------------
  788.  
  789.     FAC is very friendly and shouldn't give error messages unless
  790.     there's really something you need to fix.  Here are some error
  791.     messages FAC could generate and why you might get them:
  792.  
  793.     - "Error while trying to find/open FAC.DAT"   Make sure FAC.DAT
  794.     exists and that the disk and directory containing FAC.DAT is on your
  795.     MSDOS path.
  796.  
  797.     - "XXXX is an invalid path name!"  You've specified an incorrect
  798.     path when using the /P switch or the path you've specified is too
  799.     long (the limit is 127 characters)
  800.  
  801.     - "FAC isn't loaded!"  You've tried to uninstall FAC (as a TSR) when
  802.     it wasn't previously loaded.  Use the /I option to install it.
  803.  
  804.     - "Unable to unload FAC.  Probably isn't safe to do so!"  This isn't
  805.     really an error message; it just means that the program can't
  806.     uninstall itself, probably because there's another TSR or program
  807.     loaded after it.  Try rebooting if you have to unload it.
  808.  
  809.     - "XXXX not found."  This, too, isn't really an error message.
  810.     You'll get this message any time you searched for string and it
  811.     wasn't found.  The string you're searching for may not be in FAC.DAT
  812.     or you may need to check your spelling.  Try the fuzzy search mode
  813.     if you aren't sure of the spelling.
  814.  
  815.     - "FAC is already memory resident!"  You're trying to install FAC
  816.     after it's already been loaded.  Use FAC /U to uninstall it.
  817.  
  818.     - "Unable to go TSR.  Do you have enough swap file disk space on
  819.     X:?"  This message means FAC couldn't go TSR, probably because you
  820.     don't have enough RAM, or you don't have enough disk space for the
  821.     swap files.
  822.  
  823.     - "Couldn't make window!"  There was a memory allocation error when
  824.     FAC tried to draw its window.  You probably don't have enough RAM to
  825.     run FAC.
  826.  
  827.  
  828.     Technical/Compatibility Notes
  829.     -----------------------------
  830.  
  831.     Find Area Code runs on IBM PC compatibles (clones) using MSDOS 3.X.
  832.     I've not tested the program under MSDOS 4.X.  I'm pretty sure the
  833.     program won't work with DOS 2.X since 2.X handles paths differently.
  834.     It might work if you're in the same directory as the data file.
  835.  
  836.     One of the reasons the program searches so quickly is RLINE, Don
  837.     Strenczewilk's excellent Turbo Pascal OOP text file handling unit.
  838.     RLINE allows you to define a "file of lines" object.  In addition,
  839.     FAC can search at a rate of over 800 lines per second on an XT with
  840.     a slow hard disk!  Thanks to Don for graciously donating his code to
  841.     the public domain!
  842.  
  843.     Another reason the program is so fast is due to Richard Winkel's
  844.     TPSTR. TPSTR (Ver 1.21) is a Turbo Pascal Unit with about 30
  845.     REXX-like string procedures and functions, all carefully crafted in
  846.     assembly language.  Richard's licensing fee is very reasonable ($10)
  847.     and you get all the Turbo Pascal and assembly source code.  Highly
  848.     recommended!
  849.  
  850.     The excellent TSR swapping system and windowing comes from Object
  851.     Professional 1.02 from TurboPower Software.  If you do any
  852.     programming in Turbo Pascal 5.5, you owe it to yourself to use
  853.     Object Pro!
  854.  
  855.  
  856.     How to Reach the Author
  857.     -----------------------
  858.  
  859.                  Michael K. Molloy
  860.                  8531 East Dry Creek Place
  861.                  Englewood, CO  80112
  862.                  CIS: 72737, 3237
  863.  
  864.     I also frequent the MicroManiac!, Tom Gettys' fantastic Wildcat BBS
  865.     (303-673-9470) in Lafayette, CO.  His board should always have the
  866.     latest version of Find Area Code (and hundreds of other fresh
  867.     uploads!).
  868.  
  869.  
  870.     Alternative Uses
  871.     ----------------
  872.  
  873.     You may have thought to yourself as you used FAC, "Hmmm, if I can
  874.     pop FAC up anywhere as a tiny TSR, and if I can change the contents
  875.     of the FAC.DAT file, why can't I put my own personal information
  876.     into it and quickly and conveniently search for it when I need it?"
  877.     You can, and I hope you will.
  878.  
  879.     I think the ease of modifying FAC's database is a very valuable
  880.     feature. In fact, one of the reasons I decided to write "yet another
  881.     area code finder" was the frustration I had with the fact you
  882.     couldn't modify, correct, update, or add to some of the other area
  883.     code program data files.
  884.  
  885.     My own personal use of FAC goes far beyond just using it to hunt
  886.     down area codes.  Here's what I do.
  887.  
  888.     I have (you probably do, too if you're any kind of computer nut) a
  889.     database of friends and relatives with which I maintain a quick
  890.     reference phone list.  Periodically, I use my database program to
  891.     generate a report which I print to disk.  The report looks something
  892.     like this:
  893.  
  894.     John Doe            555-555-5555  1234 Anywhere St., Anyplace, CO  12345
  895.     Joe's Software Shop     555-1234  (open 24 hours)
  896.     Jay's Hardware Emporium 555-9876  (Closes at 6pm)
  897.     Jim Smith               555-0000  (Keep trying; has teenagers on phone)
  898.        .
  899.        .
  900.        .
  901.     (you get the idea)
  902.  
  903.     I use an editor to paste the ASCII information into the front of my
  904.     FAC.DAT file, and presto! I have a 7K popup database of our family
  905.     and friends.  I put the information at the front only to improve
  906.     search times for the information I need most frequently; it can be
  907.     anywhere, in any format, in any order since every character of the
  908.     entire FAC.DAT file is searched every time (except when your search
  909.     string is only 2 characters; that tells the program you're searching
  910.     for a state postal abbreviation in the first 7 characters; be
  911.     careful with that!).
  912.  
  913.     Obviously, if you change the data file to reflect your own data, it
  914.     could be used for almost anything.  Just remember, the program is
  915.     line-oriented--all the information for one "record" must be on the
  916.     same line.  Each line in the data file is limited to 119 characters.
  917.     If lines are longer than 119 characters, they'll be truncated when
  918.     they are displayed.  The program will automatically wordwrap lines
  919.     of up to 119 characters when the "record" is displayed.
  920.  
  921.     I guess the way I use FAC makes it kind of a "poor man's personal
  922.     information manager (PIM)".  I've found that FAC is far superior to
  923.     LIST and other text file handling programs when it comes to ease of
  924.     use and search speed.
  925.  
  926.     FAC certainly isn't offered as any kind of free format database
  927.     package, but I think it bridges an important gap between a
  928.     full-blown database application and a tattered piece of paper taped
  929.     above your computer desk.
  930.  
  931.     I think this capability gives FAC significant "value added."  I hope
  932.     you agree and see another reason to support the program financially
  933.     with your registration.
  934.  
  935.     Use your imagination!  If you come up with radical or useful new
  936.     applications for Find Area Code "engine", please let me know.
  937.  
  938.     Final Remarks
  939.     -------------
  940.  
  941.     Many thanks to my wife, Bobbea, for her friendship, love, and
  942.     support in every aspect of my life.
  943.  
  944.     Thanks to Tom Gettys for his patient and valuable beta test feedback
  945.     and for having the best BBS in Colorado!
  946.  
  947.     I've made every effort to provide the correct area codes and foreign
  948.     country city codes.  If you find errors or additions, please send
  949.     them to me on CompuServe.
  950.  
  951.     NOTE: If I get registrations and user support for this program, I'll
  952.     add other valuable features in future versions:
  953.  
  954.            - XMS/EMS swapping support
  955.            - Install/clone program to set user defaults (colors/hotkey/etc.)
  956.            - Multiple data file handling ("subject" databases?)
  957.            - Mouse support?
  958.            - You tell me!!
  959.  
  960.     If FAC doesn't do what you think it should, or you'd like for it to
  961.     do something else, I would be happy to develop a customized version
  962.     of the program for anyone who wants one (for a reasonable fee).
  963.  
  964.     I'd appreciate bug reports, new feature requests, comments,
  965.     performance problems, constructive criticism, suggestions,
  966.     additions, and/or corrections regarding Find Area Code.
  967.  
  968.     Enjoy!
  969.  
  970.     |\    /| /
  971.     | \  / |/
  972.     |  \/  |\  /|
  973.     |ike   | \/ |olloy
  974.  
  975.     ------------------------------------------------------------------------
  976.  
  977.                        Quick Reference List of FAC Options
  978.                        -----------------------------------
  979.  
  980.  
  981.           FAC                 Shows brief help information
  982.  
  983.           FAC <String>        Searches for String. Can be any part of or
  984.                               all of a City, State, Country, or Area
  985.                               Code. If String is 2 characters then a
  986.                               search on U.S states only is assumed.  Not
  987.                               a TSR
  988.  
  989.           FAC <String> /F     Enables "fuzzy search" mode to find
  990.                               approximate spellings
  991.  
  992.           FAC /I              Loads popup/TSR with defaults:
  993.                                - Swapping on
  994.                                - Swapping messages on
  995.                                - Swap file path = same path FAC.DAT found on
  996.                                - Exploding windows on
  997.                                - Read search string from screen
  998.  
  999.           FAC /I /N           Loads popup; no swapping (instant popup mode
  1000.                               but requires 120K RAM)
  1001.  
  1002.           FAC /I /M           Loads popup; suppresses swapping messages
  1003.  
  1004.           FAC /I /Pc:\temp    Loads popup: path for swap files = c:\temp
  1005.                               Specify RAM disk if available/possible
  1006.  
  1007.           FAC /I /G           Don't read text from screen on popup (when
  1008.                               used with other parameters)
  1009.  
  1010.           FAC /U              Unloads popup from memory, if possible;
  1011.                               deletes swap files
  1012.  
  1013.           FAC /X              Don't use exploding windows (when used
  1014.                               with other parameters)
  1015.  
  1016.           FAC /Z              Use a "zoomed" window which uses the full
  1017.                               screen (when used with other parameters)
  1018.  
  1019.     ------------------------------------------------------------------------
  1020.  
  1021.     *** End of FAC.DOC ***
  1022.