home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / UTIL / ZC.LZH / zipcode.doc < prev   
Text File  |  1995-01-13  |  4KB  |  99 lines
  1. ZipCode Version 1.0
  2. (c) January 1995 by
  3. Joel Mathew Hegberg
  4.  
  5. ZipCode is a simple utility to quickly look up a person's city and state
  6. given their US Postal zip-code.  There are currently two flavors of
  7. ZipCode... one for all OS-9/68000 systems (using termcap), and one for
  8. K-Windows based systems.  They both work identically, only the K-Windows
  9. version is a little more flashy.
  10.  
  11. Before you can use this utility, you must place the (massively large)
  12. zipcodes.txt file in your /dd/SYS directory so ZipCode can find it!
  13.  
  14. There are two ways you can use this utility.  First, you can give it a
  15. zip-code as an argument, and the city/state will be displayed.  Like
  16. this:
  17.  
  18. zc  60115
  19.   or
  20. kzc 60115
  21.  
  22. The second way is giving no arguments.  In this case, ZipCode runs like
  23. an application until you exit it.  Simply type in a zip-code in the
  24. space provided and press the [ENTER] key to look up the corresponding
  25. city/state.  You can then type a new zip-code (over the current one) to
  26. do another search.  You may use the left/right arrow keys to edit the
  27. current zip-code if you wish.  If you want to clear the zip-code field,
  28. press 'C'.  To exit ZipCode, press 'Q'.
  29.  
  30. You may be confused as to what "copy" (the 'Y' key) does.  There is a
  31. Global OS-9 Clipboard proposal in the works to allow OS-9 applications
  32. to share information between one another.  ZipCode is compliant with
  33. this proposal.  Copy merely copies the city/state information to the
  34. Global OS-9 Clipboard, from which you can paste it into a document (or
  35. whatever) from another OS-9 application which is complaint with the
  36. clipboard proposal.
  37.  
  38. Finally, some necessary notes regarding this software, source code, and
  39. the zipcodes.txt data file. 
  40.  
  41. ZipCode was written by Joel Mathew Hegberg, (c) January 1995.  Both
  42. versions of the utility (zc and kzc) are released to the public domain
  43. for the good of the OS-9 community at large.  They may not be sold for
  44. profit.  If you wish to include the software for free with another
  45. product, please contact the author via email at "JoelHegberg@delphi.com"
  46. and obtain permission first.
  47.  
  48. The source code for the termcap version of ZipCode (zc) is also released
  49. to the public domain for educational purposes.  To avoid confusion, no
  50. one may not release modified versions of the source code under the name
  51. "ZipCode".  If you want to release a modified variation of this utility,
  52. please select a different name.
  53.  
  54. The 'zipcodes.txt' data file was dug up on the net.  Below, please find
  55. the "readme" file which was attached to the file when I found it. 
  56. Unfortunately, I do not know who the person is who wrote the "readme"
  57. file. 
  58.  
  59.  
  60. Best wishes,
  61.  
  62. Joel Mathew Hegberg
  63.  
  64.  
  65. ===========================================================
  66. file: zipcodes.readme
  67. ===========================================================
  68.  
  69. This was uploaded last year by myself.  Since then I have added a few
  70. new zip codes and have converted the cities to upper and lower case
  71. instead of all caps as in the original copy.
  72.  
  73. Below is what was originally attached to the zip code file.  All credit
  74. is due to the below.  I assume NO CREDIT at all! (Or blame)
  75.  
  76. ---------
  77.  
  78. The zip code file was prepared by Brian Chaumer.  He was kind enough to
  79. copy the file from the Master tape distributed by the US Postal Service,
  80. and send it to me.  In return for this great favor, I have researched
  81. the copyright status, and obtained permission from the Postal Service to
  82. upload the file to CIS.  It is current as of Feb.  1988.  There only
  83. restriction is that it cannot be sold, but must be distributed freely. 
  84. This only applies to the master file.  There is no restriction with what
  85. you do with the data once you include it in a database. 
  86.  
  87. The file is a tab delimited text file.  It can be easily imported into
  88. any database or file management software.  It consists of 3 fields in
  89. the following order - the zip code, the two letter state code, and the
  90. city.  The city names and state codes are all uppercase. 
  91.  
  92. I hope you get some benefit from the file.  I know that several of my
  93. potential customers were very excited when I told them that they would
  94. hardly ever have to type in a city and state, and if they did, it would
  95. only be once. 
  96.  
  97.  
  98.  
  99.