home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / areafon3.zip / AREAFON.DOC < prev    next >
Text File  |  1990-02-08  |  19KB  |  507 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     AREAFON
  13.  
  14.                                   Version 3.0
  15.  
  16.                                    3/1/1990
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                              Quick Reference Guide
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                                 Distributed by
  37.  
  38.  
  39.                                  Bulletronics
  40.                                 P.O. Box 49743
  41.                               Atlanta, Ga. 30359
  42.  
  43.  
  44.                                Bulletronics BBS
  45.                                 (404) 396-3630
  46.                              24 Hour/7 Day Service
  47.  
  48.  
  49.  
  50.  
  51.                          Copyright (c) 1989 by Lou Hlad
  52.                               All Rights Reserved
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.     TABLE OF CONTENTS
  62.  
  63.  
  64.  
  65.  
  66.                 Introduction                                    1
  67.  
  68.                 License Agreement                               2
  69.  
  70.                 Warranty                                        2
  71.  
  72.                 Shareware vs. Freeware                          3
  73.  
  74.                 Getting Started                                 4
  75.  
  76.                 Technical Considerations                        4
  77.  
  78.                 Using Main Selection Panel                      5
  79.  
  80.                 Modifying the AREAFON.DAT Table                 6
  81.  
  82.  
  83.  
  84.                 Appendix A:
  85.                    Order Form                                   8
  86.  
  87.                 Appendix B:
  88.                    Comments Form                                9
  89.  
  90.  
  91.               AREAFON Version 3.0 Quick Reference Guide              Page 1
  92.  
  93.  
  94.  
  95. INTRODUCTION
  96.  
  97.  
  98.  
  99.  
  100. AREAFON is a fast table-lookup program which displays the areacodes, city
  101. names, and country codes of the international dialing system. An optional
  102. personal phone directory may be imbedded in the database as well. AREAFON
  103. uses a common, popular user interface which resembles the Lotus Corporation
  104. schema of their Lotus 1-2-3 package.
  105.  
  106. The actual tables are provided in the file AREAFON.DAT and may be updated
  107. by the user as outlined in Appendix A.  This is necessary as new codes are
  108. defined by expanding phone availability. Additional city names may also be
  109. inserted in the table as desired. This tabular construction makes AREAFON an
  110. "open-ended" program which can't suffer the fate of becoming "out-of-date".
  111.  
  112. Files provided with AREAFON.ZIP for user testing include:
  113.  
  114.                 AREAFON.EXE    - the executable program
  115.                 AREAFON.DAT    - the data table required
  116.                 AREAFON.DOC    - this documentation
  117.  
  118. AREAFON.EXE is FULLY functional. The data file AREAFON.DAT contains an
  119. excellent sampling of over 750 lines of data. This table is nearly at the
  120. maximum limit of 760 lines imposed by the compiler. Lines past 760
  121. are simply ignored by the program. Since the foreign country code dialing
  122. lines are at the rear of the file, you may use all 760 lines for U.S. data
  123. if you wish. Only the foreign country code screen will be affected. Lines
  124. which fall after the 760 limit are ignored by the program and need not be
  125. removed.
  126.  
  127. Users may customize file AREAFON.DAT to their liking. Any lines may be
  128. removed. Lines may be added (as long as they follow the prescribed format).
  129. Future releases of this program will remove the line limitation. Only
  130. registered users will have access to improved versions of AREAFON.EXE.
  131.  
  132. Registration of this program is $20.00. It entitles users to support from
  133. the Bulletronics BBS at 404/396-3630. Improved versions may be downloaded
  134. with special instructions given only to registered users. The authors will
  135. consider customized versions of this software at a nominal price. Note that
  136. the Registration Form is at the rear of this documentation.
  137.  
  138. This software was written in Borland's fine TURBO PASCAL 5.5 compiler.
  139.  
  140.  
  141.  
  142.             AREAFON Version 3.0 Quick Reference Guide              Page 2
  143.  
  144.  
  145.  
  146.     License Agreement
  147.     -----------------
  148.  
  149.     AREAFON is protected by United States Copyright Law and International
  150.     Treaty provisions. All rights are reserved. Non-registered users of
  151.     AREAFON are licensed only to use the program on a trial basis for the
  152.     sole purpose of determining whether or not it meets their requirements.
  153.     All other uses require registration.
  154.  
  155.     Any other use of non-registered copies of AREAFON by any person,
  156.     business, corporation, government organization, or any other entity
  157.     is strictly forbidden and is a violation of this license agreement.
  158.  
  159.     Registration permits a user a license to use AREAFON on a single computer.
  160.  
  161.     All users are granted a limited license to copy AREAFON for the trial use
  162.     of others, with the following additional conditions:
  163.  
  164.         AREAFON must be distributed in unmodified, complete form, including
  165.         this Quick Reference Guide and License Agreement.
  166.  
  167.         AREAFON may not be distributed in conjunction with any other product
  168.         without the written permission of Bulletronics.
  169.  
  170.         No fee, other than a bonafide disk duplicating fee not to exceed
  171.         $6.00, may be charged for AREAFON.
  172.  
  173.  
  174.     Warranty
  175.     --------
  176.  
  177.     Bulletronics makes no warranty of any kind, express or implied, including
  178.     without limitation, any warranties of merchantability and/or fitness for
  179.     a particular purpose. Bulletronics will not be liable for any damages,
  180.     whether direct, indirect, special or consequential arising from a failure
  181.     of this program to operate in the manner desired by the user. Bulletronics
  182.     shall not be liable for any damage to data or property which may be caused
  183.     directly or indirectly by use of the program.
  184.  
  185.     IN NO EVENT WILL BULLETRONICS BE LIABLE FOR ANY DAMAGES, INCLUDING ANY
  186.     LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
  187.     ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM
  188.     BY AY OTHER PARTY.
  189.  
  190.     The License Agreement and Warranty shall be construed, interpreted, and
  191.     governed by the laws of the state of Georgia.
  192.  
  193.  
  194.            AREAFON Version 3.0 Quick Reference Guide              Page 3
  195.  
  196.  
  197.     Shareware Vs. Freeware
  198.     ----------------------
  199.  
  200.     Shareware is a type of software which is marketed on a "try before you
  201.     buy" concept. It is not meant to be "freeware". Many hundreds of hours
  202.     go into the development of these packages. If you find they meet your
  203.     needs, please register your copy and pay the modest fee. Please do not
  204.     make the mistake of illegally using unregistered packages for corporate 
  205.     business purposes. This submits your company to legal ramifications.
  206.  
  207.     Purchase orders are accepted for unlimited copy licenses only. Upon
  208.     payment, you will receive a letter confirming that you have been granted
  209.     an unlimited copy license.
  210.  
  211.     Your contribution supports the creation of good, inexpensive software
  212.     created by independent people who enjoy bringing a good product to the
  213.     American public and earning their living this way. This is professional
  214.     software without the shrinkwrap.
  215.  
  216.     If the package does not meet your needs, please erase it from your
  217.     computer. If the package "almost" meets your needs, please contact us
  218.     to discuss a modification. Modifications of the program as well as a
  219.     unique AREAFON.DAT table are possible.
  220.  
  221.  
  222.            AREAFON Version 3.0 Quick Reference Guide              Page 4
  223.  
  224.  
  225. Getting Started
  226. ---------------
  227.  
  228. AREAFON requires no setup. It only requires that the included data
  229. file AREAFON.DAT be found by the executable module. Make sure that
  230. either the two files are in the same directory or they are located
  231. in the established path environment of the computer.
  232.  
  233. To execute AREAFON.EXE:
  234.                                  
  235.       C:\>  AREAFON            (Yes, that's all folks!)
  236.  
  237.  
  238.       Note: If you put AREAFON.EXE and AREAFON.DAT in a directory
  239.             accessible via your PATH command, it can be executed
  240.             from any directory on that hard drive.
  241.  
  242.  
  243.  
  244. Technical Considerations
  245. ------------------------
  246.  
  247. AREAFON is written entirely in Borland's Turbo Pascal version 5.5.
  248. Module AREAFON.EXE is the compiled version.
  249.  
  250. This program has been tested on CGA, EGA, VGA, and Hercules graphics
  251. cards. It works equally well on all these types. Color is displayed
  252. when supported by the card and monitor. AREAFON works on 8086, 80286, 
  253. 80386, and 80486 computers as well.
  254.  
  255. The compiler indicates that the program requires about 16,000 bytes for
  256. code area and 64,592 for data storage for a total of just over 80,000.
  257. This version of the program is limited to 760 lines of data. Future versions
  258. now being written will have no such limitations.
  259.  
  260. There is usually no need to modify AREAFON.DAT.  However, from time to
  261. time, new areacodes and countrycodes are announced. They can be
  262. added to data file AREAFON.DAT using any ASCII text editor. If the user
  263. wishes to imbed a personal phone directory within AREAFON.DAT, a format for
  264. doing so is defined. A file record layout is detailed in a following section.
  265.  
  266.  
  267.  
  268.            AREAFON Version 3.0 Quick Reference Guide              Page 5
  269.  
  270.  
  271.  
  272. Using Main Selection Panel
  273. --------------------------
  274.  
  275. The main selection panel is a "point and shoot" slidebar interface   
  276. which allows the user to select:
  277.  
  278.     1). All the areacodes assigned in the world.
  279.     2). The city names included in the AREAFON.DAT table.
  280.     3). A user's personal phone directory in the AREAFON.DAT table.
  281.     4). The assigned country codes of all foreign countries.
  282.         Foreign city codes are also provided where required. To dial
  283.         these countries, one must dial "011" + Country Code +
  284.         City Code + local number.
  285.     5). The entire database file AREAFON.DAT. This allows text scans on
  286.         ANYTHING to verify the current contents of the file.
  287.  
  288. Text scanning is accomplished by selecting a screen display, then hitting the
  289. F1 key to bring up the pop-up text scan window, and entering a string of
  290. text for which to search. Upper/lower case is ignored in the search.
  291.  
  292. Depending upon the initial screen selected, the text search finds any
  293. matching subset of that body of data. If you choose to view the entire
  294. database (selection D of the menu), you can search for ANYTHING in file
  295. AREAFON.DAT. If the matched records exceed one screen, the PgUp/PgDn keys
  296. will show you the remaining data on successive screens.
  297.         
  298.  
  299.  
  300.            AREAFON Version 3.0 Quick Reference Guide              Page 6
  301.  
  302.  
  303.  
  304. Modifying the AREAFON.DAT Table
  305. -------------------------------
  306.  
  307. The data table that this program references is completely contained in
  308. module AREAFON.DAT and may be edited using any ASCII test editor. This
  309. should not be necessary unless some previously-unassigned areacode becomes
  310. assigned or some new foreign country code is defined. If this happens,
  311. add the new data into the file using the following code conventions.
  312.  
  313. All the areacode records are at the front of AREAFON.DAT and are sorted
  314. numerically by areacode. There are some city records inserted within their
  315. respective areacode sections. Most of the major American cities have been
  316. included in the database. Since there are thousands of cities and towns,
  317. this table may never be "complete", but it very usable in its present form.
  318.  
  319. At the rear of AREAFON.DAT are all the foreign country code records. If you
  320. have no interest in foreign dialing, you may delete all these records and
  321. have more room for U.S. city name data. Up to 760 lines of data are now
  322. supported under AREAFON 3.0.  The next version will have unlimited table
  323. capacity.  Only registered users will have access to future unlimited
  324. versions of AREAFON and the online BBS support.
  325.  
  326. If the user wishes to build a private phone directory within the file
  327. AREAFON.DAT, this is allowable. A special "type 4" record is defined below
  328. to appear when the "PhoneBook" selection is made from the main menu. These
  329. lines also count toward the 760 line limit.
  330.  
  331. This program employs no record sorting of any kind to ensure immediate
  332. response. If records are entered alphabetically in AREAFON.DAT, they will
  333. appear alphabetically on the screen. Remember that the text search window
  334. should be used to locate text of interest. This is usually only one or two
  335. lines. This program is amazingly useful without any sorting since it zeroes
  336. in so quickly on the desired information.
  337.  
  338.  
  339.  
  340.            AREAFON Version 3.0 Quick Reference Guide              Page 7
  341.  
  342.  
  343.  
  344.  
  345. Here is a sample of some typical lines from AREAFON.DAT:
  346.  
  347.  
  348.    |--- column 4 has record type code
  349.    |
  350. 2011NJ Northern New Jersey         <<<<<  Areacodes at front (type 1 record).
  351. 2161OH Northeastern Ohio           <
  352. 2162OH         Cleveland           <    << City lines follow their parent
  353. 2162OH         Youngstown          <       areacode lines. City name starts
  354. 9161CA Northeastern California     <       always in column 16. These need
  355. 9181OK Northeastern Oklahoma       <       type=2 in column 4 to identify
  356. 9191NC Eastern North Carolina      <       them as city name records.
  357. 9194NC 834-3333 Mom's House        <    << Private phone directory records
  358. 9194NC 732-1234 Sis's House                (type 4).
  359. -------------------------------------------------------------------------
  360. 2133YY Algeria                  <
  361. 6843YY American Samoa           <<<<<< Country codes at rear. (Type 3 recs.)
  362.  333YY Andorra                  <      The countries have a "YY" where the
  363.  333ZZ    628- All Points       <      state abbreviation would go and the
  364.  543YY Argentina                <      foreign cities have a "ZZ" to aid
  365.  543ZZ      1- Buenos Aires     <      the program in identifying them.
  366.  543ZZ     51- Cordoba          <
  367.  
  368.  
  369. Here are field definitions in the 32 character record above:
  370.  
  371. Cols
  372. ----
  373. 1-3   Areacode or Country Code
  374.  
  375.   4   Type of Record (tells program on which screen to display)
  376.                 0 = Unassigned Areacode Record
  377.                 1 = Assigned North American Area Code Record
  378.                 2 = City Name Record (Keep in alphabetical order under
  379.                                       the appropriate Area Code Record)
  380.                 3 = Country Code Info Record (either country or foreign city)
  381.                 4 = Private PhoneBook Directory Records for this user
  382.  
  383. 5-6   State Abbreviation    (Type 1 Record) (Type 2 Record) (Type 4 Record)
  384.                or
  385.       Country Abbreviation (Canada, Mexico, Puerto Rico -- CN, MX, PR)
  386.                or
  387.       "YY" W/ Country Name  (Type 3 Record)
  388.       "ZZ" W/ Foreign City  (Type 3 Record)
  389.  
  390. 7-32 Text Field   Any Text may appear in this field. City names are
  391.                   placed in column 16 by convention for display uniformity.
  392.  
  393.                   On a private PhoneBook directory (type 4) record, put the
  394.                   7-digit phone number starting in column 8 and the name
  395.                   of the phoned party in column 17 for display uniformity.
  396.  
  397.  
  398.  
  399.                             ORDER FORM
  400.                             ==========
  401.  
  402.  
  403.         TO:                                            FROM:
  404.  
  405.    Bulletronics                     Name: __________________________________
  406.    P.O. BOX 49743
  407.    Atlanta, Ga. 30359            Company: __________________________________
  408.  
  409.    404/396-3630 BBS Data         Address: __________________________________
  410.  
  411.    1200/2400 baud 24 Hrs.        Address: __________________________________
  412.  
  413.                              City, State: ________________________ _________
  414.                                                                     Zip Code
  415.    Date: ________________   Phone Number: __________________________________
  416.  
  417.  
  418.  
  419.                   AREAFON -- Current Version 3.00
  420.                   -------------------------------
  421.  
  422.      One registration with Source Code and BBS Support....... $20  _________
  423.  
  424.      -or-
  425.  
  426.     2 to  4 computers .... at  $15 each.    # computers ___ x $15  _________
  427.  
  428.      -or-
  429.  
  430.     Unlimited Copy License.... $75.                                _________
  431.  
  432.  
  433.     Please add $5.00 for shipping/handling if software is
  434.     requested on diskette. It may be downloaded for free from
  435.     Bulletronics BBS with proper security clearance after
  436.     registration.                                                  _________
  437.  
  438.  
  439.     Georgia residents add 5% sales tax.                            _________
  440.  
  441.                                                                =============
  442.  
  443.                                                   Total Enclosed   _________
  444.  
  445.  
  446.  
  447.     Diskette Format (choose one)   5.25" Disk  ____   3.5" Disk  ____
  448.     (Please add $5.00 to order cost if diskette is desired)
  449.  
  450.  
  451.                                                            Bulletronics 1990
  452.  
  453.  
  454.  
  455.                          COMMENTS FORM
  456.                          =============
  457.  
  458.  
  459.    Your comments about this software and documentation are welcome.
  460.    Please take the time to fill out this form or contact us through
  461.    our Bulletin Board at 404/396-3630.
  462.  
  463.   
  464.  
  465.    Name: __________________________________ Title: _________________________
  466.   
  467.    Company: __________________________________
  468.  
  469.    Address: __________________________________
  470.  
  471.    Address: __________________________________
  472.  
  473.    City, State: ________________________ _________
  474.                                           Zip Code
  475.  
  476.    Date: ________________   Phone Number: ___________________________________
  477.  
  478.  
  479.  
  480.                        AREAFON --  Version 3.00
  481.                        ------------------------
  482.  
  483.    __________________________________________________________________________
  484.  
  485.    __________________________________________________________________________
  486.  
  487.    __________________________________________________________________________
  488.    
  489.    __________________________________________________________________________
  490.    
  491.    __________________________________________________________________________
  492.    
  493.    __________________________________________________________________________
  494.    
  495.    __________________________________________________________________________
  496.    
  497.    __________________________________________________________________________
  498.    
  499.    __________________________________________________________________________
  500.    
  501.    __________________________________________________________________________
  502.    
  503.  
  504.    Send this form to:    Bulletronics
  505.                          Post Office Box 49743
  506.                          Atlanta, Ga. 30359 
  507.