home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d801 / convert.lha / Convert / Convert.doc < prev    next >
Text File  |  1993-01-24  |  10KB  |  184 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                                    
  6.            ___     ___   _                  _____  ____   _______    
  7.           /   \   /   \  |\    | \        / |      |   \     |       
  8.          |       |     | | \   |  \      /  |      |    )    |       
  9.          |       |     | |  \  |   \    /   |---   |___/     |       
  10.          |       |     | |   \ |    \  /    |      |   \     |       
  11.           \___/   \___/  |    \|     \/     |____  |    \    |       
  12.                                ¯            ¯                        
  13.                                                                      
  14.                                                                      
  15.  
  16.                                                 
  17.                         Version 2.0 - Shareware  
  18.                                                  
  19.                                                  
  20.  
  21.                                                 
  22.                           © 1992 Mike Fuller     
  23.                                                  
  24.                                                  
  25.  
  26.  
  27.   INTRODUCTION
  28.  
  29.   CONVERT is a programme that provides the means to easily convert numerical
  30.   values between international, imperial and US systems of measurement.
  31.   It does this in twelve different fields of measurement including area,
  32.   capacity, density, energy, fuel consumption, length, power, pressure,
  33.   speed (velocity), temperature, volume and weight.
  34.   CONVERT is so easy to use that you may never need to read this doc file
  35.   but I have made it comprehensive for the benefit of everybody.
  36.  
  37.   This is the freely distributable version which does not have the ARexx port
  38.   or any startup options and displays an About notice when CONVERT is
  39.   started and closed.  This version may be distributed freely as long as this
  40.   doc file is included and a reasonable (ie. not more than AUD $5) copying fee
  41.   is charged for the disk.  It may not be included on any commercial disk
  42.   except where I give express permission. (Fred Fish has that permission)
  43.   This version is still shareware, so if you use it regularly you are
  44.   legally and morally obliged to register as a user and receive the resulting
  45.   benefits.
  46.  
  47.   See below for details about obtaining the registered version.
  48.  
  49.   USING CONVERT
  50.  
  51.   Installing CONVERT is simply a matter of dragging its icon into your
  52.   preferred directory.  There are no additional files required.
  53.   To start the programme, simply double-click on the CONVERT icon.
  54.   For CLI or shell users, run CONVERT, either after CD'ing to its parent
  55.   directory or by providing a full path. (eg. run df1:Convert/Convert )
  56.   An About window will be displayed initially; after reading the message
  57.   carefully, just click on this window to remove it.
  58.  
  59.   NOTE: The registered version has several startup options not available in
  60.   this version, including allowing you to start the program in an iconised
  61.   form and setting the positions of the windows.  The annoying but necessary
  62.   About notice will also be missing.
  63.  
  64.   CONVERT has been designed to be as flexible and easy to use as possible.
  65.   You can operate CONVERT using the mouse, the keyboard or any combination
  66.   of both.  The registered version also has an ARexx port for batch or
  67.   interactive processing from a shell or another ARexx compatable programme.
  68.  
  69.   The main window displays a numeric keyboard, twelve measuring-system
  70.   gadgets (buttons) and a set of string gadgets (boxes) with accompanying
  71.   descriptive text.  The current measuring-system gadget will be hilighted
  72.   as will the current string gadget (by its different coloured text).
  73.  
  74.   To select a different measuring-system unit, simply click on the relevant
  75.   button.  Alternatively, you may select a unit by pressing the keyboard-
  76.   equivalent letter for that unit.  Each unit has a hilighted letter to
  77.   indicate its keyboard-eqivalent.  eg. press c to select Capacity,
  78.   r to select Pressure etc.
  79.  
  80.   To select a different string gadget, click in the relevant box.
  81.   Alternatively, you may cycle through the string gadgets by pressing the
  82.   up or down cursor (arrow) keys.
  83.  
  84.   NOTE: When a string gadget is active (indicated by the visible cursor
  85.         in the current gadget), the keyboard equivalents for selecting
  86.         units or changing string gadgets will not work. (Its obvious why
  87.         if you think about it)  To enable keyboard control (ie. deactivate
  88.         the string gadget) simply press the Return key. To reactivate
  89.         the string gadget, press Return again.
  90.  
  91.   To enter a number, click on the numbers on the window's keyboard or use
  92.   the real keyboard's numeric keys (the string gadget must be active to
  93.   enter numbers via the real keyboard).  To convert the number, either click
  94.   on the window's Enter button or press the Return key on the real keyboard.
  95.   To clear the numbers, click on the CA button on the window's keyboard.
  96.   The real keyboard equivalent is the Del (delete) key.
  97.  
  98.   To iconise the window, click on the Zoom gadget (the small titlebar gadget
  99.   just to the left of the Depth gadget).  The keyboard equivalent is A -I
  100.   (Hold down the Right Amiga key and press the I key).  This is a toggle
  101.   function, so to return to the main CONVERT window, repeat the action.
  102.   NOTE: This is not available in this version for those using the 1.2 or
  103.   1.3 operating system, but registered users will get 2.0 and 1.3 versions
  104.   which will both have this function.
  105.  
  106.   To quit CONVERT, click the CloseWindow gadget on the left side of the
  107.   titlebar or press A -Q  (Right Amiga - Q)
  108.   The About notice will be displayed for a set time (allowing you to
  109.   reread the important message) and then the program will close.
  110.  
  111.   ACCURACY OF COMPUTATION
  112.  
  113.   The unit values are stored internally with an accuracy of up to ten
  114.   significant digits and all computations are done in double-precision to
  115.   ensure the maximum accuracy of conversion.  Many scientific sources were
  116.   researched to get the most accurate values and the program has been
  117.   tested thoroughly to give you the best results possible.
  118.  
  119.   Very large or very small absolute values are displayed in exponential
  120.   format, which allows the most significant digits to be displayed and still
  121.   retain accuracy of size.  For those people not familiar with this format,
  122.   only the more significant digits are displayed along with an exponent.
  123.   This exponent indicates to what power of 10 the number should be multiplied
  124.   by to get its approximate value and is indicated by an e followed by
  125.   a + or - sign and a number.  As an example, the number 123000000000
  126.   is actually 1.23 times 100000000000 (10 to the 11th power) and would be
  127.   shown as 1.23e+11 which is certainly easier to type in.  Try entering
  128.   1.23e+99 in normal form!
  129.   Similarly, a very small absolute value like 0.000000000000056 is actually
  130.   5.6 times 0.00000000000001 (10 to the minus 14th power or 1/10 to the 14th)
  131.   and would be shown as 5.6e-14
  132.  
  133.   You may enter values in the string gadgets in exponential format if you
  134.   wish (Don't forget to include the + or - sign after the e).
  135.  
  136.   DISCLAIMER & BUGS
  137.  
  138.   Although this product has been tested thoroughly for accuracy and function,
  139.   NO liability can be accepted by me for any damage or loss incurred whilst
  140.   using CONVERT.  If you find any problem, however, I would appreciate being
  141.   told about it.
  142.  
  143.   COPYRIGHT
  144.  
  145.   CONVERT is Copyright © Mike Fuller 1992, with all rights reserved.
  146.   This freely-disributable version is shareware, so if you use it for more
  147.   than just trying out the programme, you are legally and morally obliged to
  148.   pay me for the fully registered version.
  149.  
  150.   REGISTRATION
  151.  
  152.   To register as a user of CONVERT, send $20.00 (Australian) to the address
  153.   below.  ($20 AUD is equivalent to less than $14 US or £9 UK at the time of
  154.   writing, which makes it a very cheap programme.)  This will entitle you to
  155.   a disk with the fully functional CONVERT programme, including the ARexx
  156.   port, startup-options, full documentation and no About notice to annoy
  157.   you.  The registered version, despite the extra functionality, is actually
  158.   over 5K smaller than this version.  As a bonus, you will also get several
  159.   of my other programmes on the disk.
  160.  
  161.   If you wish a different measuring-system field as a replacement to one
  162.   already in the programme, send an additional $10 AUD and I will try very
  163.   hard to give you this.  Of course, your $10 will be refunded if it is
  164.   unsatisfactory.  Don't forget to specify which field (density, temp etc.)
  165.   is to be replaced.
  166.  
  167.   The money should be either cash (in any currency) or an Australian bank
  168.   cheque.  Do not send cheques from banks of other countries; it costs a
  169.   fortune to cash them here.  Please post to:
  170.  
  171.         Mike Fuller
  172.         4 Sonego Ave
  173.         Kelmscott
  174.         Western Australia  6111
  175.  
  176.  
  177.   If you wish to discuss the programme, or anything else, please phone me on
  178.   09 390 9350 at any reasonable time. (Overseas people will need to add the
  179.   ISD code of course)
  180.  
  181.  
  182.  
  183.  
  184.