home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / HAM / PTABLE10.ZIP / PTABLE.DOC < prev    next >
Text File  |  1992-08-01  |  11KB  |  267 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                     ####    #########   
  12.                   ####### ####     ####
  13.                 ####  #####         ####
  14.               ####    ####   1.0   ####
  15.                      ####        #####
  16.                     #####     ######
  17.                    ##############                              PTable
  18.                   #####                                   Version 1.0
  19.                  #####
  20.                 #####                            (C) Victor Yiu, 1992.
  21.                #####  Table                       All rights reserved.
  22.  
  23.  
  24.         The Periodic Table Program
  25.  
  26.  
  27.     PTable 1.0 Manual                                          page 2
  28.  
  29.  
  30.  
  31.     a.   Introduction
  32.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33.  
  34.     Welcome!  I feel that you have just unzipped one of the finest 
  35.     coded programs ever to enter the shareware market.  Almost the 
  36.     finest.  Well, a great...  No, a good program.  Okay, okay, I 
  37.     admit -- it's no big heavyweight.  This is a program I have
  38.     created to utilized an excellent piece modular code that emulates 
  39.     Microsoft's pull-down menu interface.  And it also uses a fast 
  40.     SaveScreen procedure.  More on that stuff later.
  41.  
  42.     To print this file, adjust your printer to the top of a sheet and
  43.     just type "COPY PTABLE.DOC PRN" and watch the printer crank away.
  44.  
  45.     And don't forget to pass this program to your friends (with all
  46.     the files, of course) and upload it to your favorite BBS!
  47.  
  48.  
  49.     b.   Quick Run
  50.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  51.  
  52.     If you haven't figured out already, you must unzip the archive
  53.     that contains the four excellent files: PTABLE.EXE, README.1ST,
  54.     PTABLE.DOC, and ORDER.DOC.  I _know_ that you have already 
  55.     unzipped it, because otherwise you wouldn't be reading this!(1)
  56.  
  57.     Just type "PTABLE" and press enter to start the program.  When
  58.     you start, you will see a chart of the elements listed, along
  59.     with its Latin name, atomic number, and atomic weight. All of
  60.     the elements from Hydrogen to Unnilhexium.
  61.  
  62.     Use any direction key to scroll the chart.  You can try PageUp
  63.     PageDown, Home, and End also.
  64.     
  65.     Hold down <Alt> to open the menu and press <Enter>.  Again, use 
  66.     the direction keys to maneuver.
  67.     
  68.     Now, try "Complete Table" (under the Table menu or by pressing 
  69.     <F9>).  And -- you guessed it -- try the direction keys again.
  70.  
  71.     When you are aching to see the DOS prompt again, just press <Esc>
  72.     several times to quit.
  73.   
  74.         (1) Yeah, yeah, yeah.  I know... You may have received this 
  75.             program unzipped through a friend or from a disk in a 
  76.             software catalog.
  77.  
  78.  
  79.     PTable 1.0 Manual                                          page 3
  80.  
  81.  
  82.  
  83.     c.   Details, details, details
  84.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85.  
  86.     Use the arrow keys.  And anything on the numeric keypad.  You've 
  87.     heard that many times already.  Experiment. You never know what 
  88.     may happen.  Try all the keys you would normally use.  The program 
  89.     itself is pretty much self-explanatory.
  90.  
  91.     So much for details. <G>
  92.  
  93.  
  94.     d.   The story of PTable
  95.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  96.  
  97.     It all started when my good friend David Wang wrote his lousy
  98.     TABLE program in October, 1991.  Cryptic, unfriendly, ugly. (No
  99.     offense, David).  I fixed some of its code, and made a few major
  100.     facelifts, but was still unsatisfied.  So I used his data only
  101.     and created a whole program from scratch, PTable, which uses
  102.     standard CUA-compliant menus.
  103.  
  104.     From then on, David has rewritten and improved his program also.
  105.     
  106.     We shared ideas.  Every time I told him about a new improvement
  107.     in my program, he implemented it on his, and bested me by adding
  108.     another feature.
  109.  
  110.     Then, he told me about it and I, of course, added it to my
  111.     program and included another wonderful feature.  This kept on
  112.     going on and on, until we were dry of ideas (and the code of the
  113.     program was gigantic).
  114.    
  115.     Finally, I said "stop" and went through my code to weed out
  116.     unnecessary lines and to optimize it.  Ha, ha, ha -- my compiled 
  117.     version is still 5K smaller and better (in my opinion) than 
  118.     David's.  
  119.  
  120.     So that was the life of PTable.
  121.  
  122.  
  123.     e.   What language is PTable written in?
  124.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  125.  
  126.     Take a wild guess.  "Is it COBOL?"  Nope.  "Pascal?"  No again.
  127.     "Assembly language?"  At 41K?  You must be kidding.  "Okay, I've
  128.     got it -- it's bloated object-oriented C++!!!"  Wrong again.
  129.  
  130.     "I give up -- what is it?"  Well, it is one of the easiest
  131.     languages to program in.  And not to mention, powerful.  It's
  132.     QuickBASIC!!  Every single bit of code is QuickBASIC.
  133.  
  134.     This is not your average QuickBASIC program -- and I am your
  135.     everyday QuickBASIC programmer.  PTable has the tightest and
  136.     fastest code possible.
  137.  
  138.  
  139.     PTable 1.0 Manual                                          page 4
  140.  
  141.  
  142.     
  143.     Some of you QuickBASIC programmers out there may wonder how I
  144.     implemented a SaveScreen procedure.  The pull down menus you see  
  145.     uses SaveScreen.  The screen that the menu will occupy has to be 
  146.     saved before the menu is drawn.  And when the menu moves, the 
  147.     screen snip is restored to its original state.
  148.  
  149.     SaveScreen uses one of QB's undocumented statements -- "B$ASSN."
  150.     It is internally used by QB to copy fixed-length strings to
  151.     variable length strings and vice versa when needed.  It has
  152.     almost the speed of an assembler equivalent.  This wonderful 
  153.     feature was read in David Cleary's QuickBASIC Electronic 
  154.     Newsletter.  Highly recommended for pushing QB to the max.
  155.  
  156.     If you have any questions about the above, or want to ask about
  157.     my modular pull-down menu system, you are welcome to write me.  
  158.     More details below.
  159.  
  160.  
  161.     f.   Serious business
  162.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  163.  
  164.     This program is "shareware."  It is also referred to as "user-
  165.     supported software."  Its success depends on your registration.
  166.     Shareware authors don't make money off the $4 per disk that
  167.     mail-order software catalogs charge you, or the hourly rate of
  168.     some electronic services.
  169.  
  170.     I have spent many, many hours on PTable to bring the final
  171.     version of the program to you.  That, is why, I ask that you
  172.     register this program for just $7.  That's right.  All the long
  173.     hours of pain and sweat in front of the computer(2) for just $7.
  174.     If you want, you can send more!  I'd love that!
  175.  
  176.     I am allowing you 15 days for you to test and to get used to
  177.     PTable.  After this period, please either register or discontinue
  178.     using the program.
  179.  
  180.     What will you get from registering?  You will get support for this
  181.     program by mail or (if I can call collect) by phone.  You will
  182.     also get WSMaker, a high-quality word search maker, at _HALF_ the 
  183.     registration price when I release it!  WSMaker should be out
  184.     before the Winter of 1992.  I will send a letter to all registered
  185.     users notifying them when it's out.
  186.  
  187.     You can order by printing the file ORDER.DOC that came with this 
  188.     package.  Remember:  my continued program improvements depends on 
  189.     the little money I make from your contributions.
  190.  
  191.     Please don't forget to pass this program to your friends (with all
  192.     the files, of course) and upload it to your favorite BBS!
  193.  
  194.         (2)  I enjoy doing it.
  195.  
  196.  
  197.     PTable 1.0 Manual                                          page 5
  198.  
  199.  
  200.  
  201.     g.   Lisense agreement/Disclaimer/Copyright/Etc.
  202.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  203.  
  204.     This is a license agreement.  There's no doubt about that.    
  205.     It applies to all the files of PTable 1.0: PTABLE.EXE, README.1ST,
  206.     PTABLE.DOC, and ORDER.DOC.
  207.  
  208.     This software is copyrighted by Victor Yiu, the author    
  209.     of this program.  I, the copyright owner, hereby license you to:
  210.     
  211.     o  Duplicate this software under these circumstances:
  212.         > You do not alter any of the documentation, program code,
  213.           or other data
  214.         > You do not charge any fee except for the maximum of $6 to
  215.           cover the cost of shipping, duplication, and packing, etc.
  216.         > You do not, in any way, disassemble, reverse engineer, alter,
  217.           or in any other means take apart PTable
  218.         > You distribute PTable in whole, with documentation
  219.         > You do not request donations
  220.     
  221.     o   Distribute PTable to anyone you wish, by any means
  222.         electronically: through telecommunications, direct connection,
  223.         media transfer, etc. in accordance to the above stated terms.
  224.  
  225.     o   Any company or corporation wishing to use this program must
  226.         receive written permission from the author of this program,
  227.         Victor Yiu.
  228.  
  229.     o   Use PTable for the trial period of 15 days.  Using PTable 
  230.         after this date without registering is strictly prohibited!
  231.  
  232.     The copyright owner, Victor Yiu, assumes no liability to any 
  233.     damages as a consequence of the use of this program.  By running,
  234.     using, and/or distributing this program, you agree to abide by
  235.     these above terms.
  236.  
  237.     QuickBASIC is a trademark of Microsoft Corporation.
  238.  
  239.     All files are Copyright (C) Victor Yiu, 1992.  All rights reserved.
  240.  
  241.  
  242.     PTable 1.0 Manual                                          page 6
  243.  
  244.  
  245.  
  246.     h.   How to contact the author
  247.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  248.  
  249.     I can be contacted at this address:              #################
  250.                                                     #####      ######
  251.         Victor Yiu                    O N L Y  $   #####       #####
  252.         2823 Cane Field Dr.                                   #####
  253.         Sugar Land, TX 77479               for registering!  #####
  254.                                                             #####
  255.     And data at:                                           #####
  256.                                                           #####
  257.         Back To Basic BBS                                #####
  258.         (713) 470-8844                                  #####
  259.         Sysop:  Charles Evans
  260.             featuring V.32bis, BASIC programming
  261.  
  262.     It's only $7 to register!!
  263.     And you will get many additional benefits.
  264.     I would love to hear from you.
  265.  
  266.     Details and the ordering form are in ORDER.DOC.  Thanks again!
  267.