home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / hpclc098.zip / readme < prev    next >
Text File  |  2002-11-13  |  15KB  |  381 lines
  1. =======================================================================
  2. HPcalc        for OS/2 2.x, 3.x 4.x
  3. -----------------------------------------------------------------------
  4. version 0.98
  5.  
  6.  
  7. Copyright (c) Les Chan, 1993-1995
  8. Copyright (c) Steven H. Levine 2002
  9.  
  10. email (internet): ae151@freenet.carleton.ca
  11. =======================================================================
  12.  
  13.  ********
  14. * NOTICE * <----------------------------------------------------------<
  15.  ********
  16.     If you have access to email and if you have not already done so, you are
  17. required to send me a brief message stating the version of HPcalc you are
  18. using and where you onbtained it. You only need to do this for the first
  19. version you use. This is only so that I personally have some idea of the
  20. number of users of this program. This is not to gauge the market for
  21. shareware, this and future versions HPcalc for OS/2 will remain a free program.
  22. Also, the more people that send email the more likely I will update the program.
  23.  
  24.  
  25. Table of Contents
  26. =================
  27. Notice
  28. Description
  29. Installation
  30. Numlock Information
  31. Keyboard shortcuts
  32. Keyboard shortcuts for DEC-HEX-OCT mode
  33. Statistical Functions
  34. Customization
  35. Contents of Archive
  36. Licensing
  37. Planned features for future versions
  38. History of changes
  39.  
  40.  
  41. Description
  42. ===========
  43.     This program is an Free RPN calculator with a layout similar to that of
  44. the HP 41c.  HPcalc is meant to be a simple scientific calculator and does not
  45. have programmability unlike the real HP 41c calculator.  Thus all the functions
  46. which pertain to programming are absent.  Although there are additional 
  47. functions/modes not on the real 41.   The keyboard and mouse may be 
  48. used to operate this calculator.
  49.  
  50.     The startup size of HPcalc is set up for 1024x768. For those who prefer 
  51. a smaller window size, there is a configuration submenu
  52. under the File menu item.  Also configurable is the option to display
  53. the full XYZT stack.
  54.  
  55.     To use Decimal to Hexadecimal to Octal calculation and conversion modes,
  56. select it from the Functions menu.  When in the HEX-DEC-OCT mode all
  57. operations are performed on signed 32 bit numbers.
  58.  
  59.     An ini file is used for constant memory. The size and location of the
  60. window is saved on exit.  All data registers are saved as well as the
  61. display and angle modes. 
  62.  
  63.  
  64. Installation
  65. ============
  66. HPcalc.exe can reside in any directory.
  67.  
  68.     A constant memory file called HPcalc.INI is created in the same directory
  69. where HPcalc.EXE is located.  If an HPcalc.INI is found in the current directory,
  70. it will be used instead.  As a third alternate, the INI file may be used by
  71. specifying it as a parameter on the command line or with program objects. eg.
  72.  
  73. [C:\SOMEDIR] HPcalc d:\location\HPcalc.ini
  74.  
  75. This allows you to setup a normal calculator program object and
  76. a Hexadecimal calculator, etc.
  77.     
  78. Note: you may use the os2 defined file C:\NOWHERE  as a valid ini file
  79. if you do not want to have constant memory operation.
  80.  
  81. Note: 1
  82. If you use some code page other than 437(US) as the default, some symbols such
  83. as the Sigma may not appear correctly. The solution is to change the code page
  84. before you start HPcalc, you may set up a command file to start HPcalc,
  85. an example command file is:
  86.  
  87. CHCP 437
  88. START C:\pathtocalculator\HPcalc.exe
  89. CHCP 850
  90.  
  91. Note: 2
  92. The following abstract from the OS/2 help applies:
  93.  
  94.  If you try to start a program from the program-name 
  95.  choice of the pop-up menu of a folder and the 
  96.  program does not start or displays an error message, 
  97.  you can stop the name of the folder from being sent 
  98.  to the program by doing the following: 
  99.  
  100.     1. Point to the program object whose name was 
  101.        added as a choice on the pop-up menu. 
  102.     2. Click mouse button 2. 
  103.     3. Select Settings. 
  104.     4. Select the Program tab. 
  105.     5. Type the following in the Parameters field: 
  106.  
  107.           %
  108.        
  109.     6. Close the Settings notebook. 
  110.   
  111. Numlock Information
  112. ===================
  113. I have had some request to turn numlock on when HPcalc starts up. I had
  114. intended to inplement this feature when I found out how to do it. But
  115. upon further thought I have decided that this is a global issue for
  116. the desktop. There are people that want the numlock on all the time like
  117. me but there also those who do not want it on.
  118.  
  119. For those who want numlock on I think the optimal solution would have
  120. been for IBM to place such a option in the desktop settings. But next
  121. best thing is to run a program from the startup folder or in startup.cmd
  122. file to turn it on. I have found a nice small and free program written by 
  123. a team os/2 member which does this and more called keybset.zip at
  124. ftp-os2.nmsu.edu(128.123.35.151):/os2/xxxx
  125.  
  126.  
  127. Keyboard shortcuts
  128. ==================
  129. HPcalc is not case sensitive.
  130. p - pi                        Down arrow - Roll down     
  131. q - square root               Up arrow - Roll Up         
  132. g - LOG                       Shift-Insert - paste       
  133. n - LN                        Insert - paste             
  134. s - SIN                       Shift-Delete - copy        
  135. c - COS                       Delete - paste             
  136. t - TAN                       Enter - enter              
  137. o - STO                       Backspace - backspace      
  138. r - RCL                       Left arrow - backspace     
  139. h - CHS                       Ctrl - shift               
  140. e - EEX                       - - minus                  
  141. l - Lastx                     + - plus                   
  142. k - Cls (Clear Stack)         * - multiply               
  143. v - 1/x (1 oVer x)            / - divide                 
  144. u - Σ+                        % - %                      
  145. m - MOD                       ^ - y^x                    
  146. a - toggle angle modes        . and , - decimal separator
  147.  
  148. Keyboard shortcuts for DEC-HEX-OCT mode
  149. =======================================
  150. a-f - Hexadecimal digits
  151. m - change between DEC-HEX-OCT modes
  152. n, & - and
  153. | - or
  154. ^ - xor
  155. < - shift left
  156. > - shift right
  157.  
  158.  
  159. Statistical Functions
  160. =====================
  161. Slope - slope of linear regression line
  162. Intercept - intercept of linear regression line
  163. Correlation - Correlation factor
  164. X' - estimated X given Y from linear regression
  165. Y' - estimated Y given X from linear regression
  166. pop.SDEV - population Standard deviation
  167. yPx - permutations : y!/(y-x)!
  168. yCx - combinations : y!/(x!(y-x)!)
  169.  
  170.  
  171. Customization
  172. =============
  173. -> Size of the HPcalc Window
  174. There are two sizes that is available for HPcalc a large and a small size.
  175. The size is changed by toggling the Menu item File->Configuration->Small Window.
  176.  
  177. -> Display of XYZT
  178. HPcalc can display the standard X stack register or the complete XYZT stack.
  179. This is changed by toggling the Menu item File->Configuration->XYZT Mode.
  180.  
  181. -> Thousands Separator
  182. HPcalc can separate thousands by using a ",".
  183. This is changed by toggling the Menu item File->Configuration->1000s Separator.
  184.  
  185. -> Some Customization of Fonts
  186. There are five separate fonts that can be save for each of the large and small
  187. displays. The procedure to change the fonts is by the use of drag and drop.
  188. Step 1 has to be performed first in order for the fonts to be saved correctly,
  189. although it may be omitted if you wish to only change fonts in steps 2-4.
  190. Step 0 can be done at any time before step 5)
  191.  
  192. 0) drop the font onto the menu bar to change the menu font.
  193. 1) drop the font onto the background to change all the gold text as well as all
  194. the functions(sin, cos, etc.)
  195. 2) drop the font onto the <- key to change the back space as well as the
  196. four arithmetic operators +, -, *, /
  197. 3) drop the font onto the 0 button to change the font for all 10 digits
  198. 4) drop the font onto the X display register to change the font for
  199. all four stack registers.
  200. 5) Exit the program from the Menu File->Exit or F3 to save the changes
  201. abort the changes by alt-F4 or chose close from the command menu.
  202.  
  203. The program must be exited and restarted for the font changes to be properly
  204. displayed. 
  205.  
  206. -> Restoring to the Initial State
  207. If things are really messed up (eg. you chose some really horrible fonts and
  208. can't get back to something reasonable) just delete the ini file and
  209. the program will use built in defaults to start HPcalc.
  210.  
  211.  
  212. Contents of Archive
  213. ===================
  214. HPcalc.exe              The executable
  215. ReadMe                  This file
  216. file_id.diz             Short description for BBS systems
  217.  
  218. Verification information from Infozip's zip/unzip:
  219.  Length  Method   Size  Ratio   Date    Time   CRC-32     Name ("^" ==> case
  220.  ------  ------   ----  -----   ----    ----   ------     ----   conversion)
  221.   74752  Defl:X   31774  58%  10-06-95  23:30  2586a7d5   HPcalc.exe
  222.  
  223. Licensing
  224. =========
  225. This program is Provided free of charge.
  226. Although this program is free, donations are welcome and should
  227. speed up bug fixes and addition of features by enabling purchase of
  228. better tools and documentation.  They can be sent to the author at:
  229.  
  230.         Les Chan
  231.         710 Melbourne Ave. Unit 3
  232.         Ottawa, ON, Canada
  233.         K2A 4C8
  234.  
  235. If you send a donation and have an email address, I will
  236. notify and/or email you new versions as they become available.
  237. Bug reports and suggestions are welcome regardless.
  238.  
  239. email(internet):  ae151@freenet.carleton.ca
  240.  
  241.  
  242. NO WARRANTY
  243. ===========
  244.    BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  245. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  246. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  247. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  248. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  249. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  250. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  251. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  252. REPAIR OR CORRECTION.
  253.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  254. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  255. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  256. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  257. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  258. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  259. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  260. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  261. POSSIBILITY OF SUCH DAMAGES.
  262.  
  263.  
  264.  
  265. Planned features for future versions
  266. ====================================
  267. Listed in no specific order of priorities
  268.  
  269. - saving of drag and drop colors
  270.   Note: I am having trouble with this, if you know about the difference
  271.   between palette and RGB colors for use with Presentation Parameters, 
  272.   please contact me if you want to see this feature.
  273. - user configurable constants
  274.  
  275.  
  276. History of changes
  277. ==================
  278. - = bug fix
  279. + = added feature
  280. # = operational change
  281.  
  282.  2002-11-13: Steven H. Levine <steve53@earthlink   >
  283.   
  284.    - interface.c: avoid startup traps when stack[0] zero
  285.    - interface.c: turn off debug code (created j file)
  286.    - lxlite .exe
  287.    - makefile: add DEBUG support
  288.    - makefile: automate zip build
  289.    - Release version 0.98
  290.  
  291. version 0.97 - 1995 October (Released)
  292. ------------
  293. - disable menu functions in DEC-HEX_OCT mode
  294.  
  295. version 0.96 - 1995 October
  296. ------------
  297. - copying to clipboard has been fixed
  298. # the top left corner now stays put when changing configurations which
  299.   affect the size of the window
  300.  
  301.  
  302. version 0.95 - 1995 March (Released)
  303. ------------
  304. - icon for the program was not displayed in program object, now works
  305. - miles-km conversions were out by a factor of 1000
  306. - going from 2.5 (etc.) to HMS and back to HR gave incorrect results due
  307.   to LSB behaviour in division.
  308. - invalid menu items now disabled in HEX-OCT mode
  309. + you can now use the comma for entering the decimal separator
  310. + Linear regression and estimation
  311. + factorial, Population sDev, clear stack
  312. + combinations and permutations
  313. + labels for XYZT registers
  314.  
  315. version 0.94 - 1995 February (Released)
  316. ------------
  317. - Menu Title "Functions" Shortened to "Funcs" to fix display problem with
  318.   small windows at 1280x1024
  319. + saving of Fonts
  320. + as the default, HPcalc.ini is now created in the directory where HPcalc.exe
  321.   is located but it still will use the HPcalc.INI if it exist in the current 
  322.   directory
  323. + Hyperbolic functions
  324. + Some Constants
  325. + some metric conversions
  326.  
  327. version 0.93 - 1994 May 23 (Released)
  328. ------------
  329. - keys that require shift not working are fixed (the keys that did on work
  330.   vary with the keyboard used, ie. on the US keyboard <shift><=+>)
  331. + add instructions for people not using the 437(US) code page
  332.  
  333. Version 0.92 1994 March 10 (Released)
  334. ---------------------------
  335. + thousands separators
  336. + ->HMS and ->HR
  337. + add FEX mode (same as FIX mode except that overflows and underflows into
  338.   ENG instead of SCI)
  339. + add Roll Up function to up arrow.
  340. + add MOD(ulus) function
  341. - fixed bug with large number of digits copyed to clipboard in FIX mode
  342. - fixed cut and paste problems in DEC-HEX-OCT modes
  343. - fixed cut and paste menu displaying the wrong accelerator keys
  344.  
  345. Version 0.9  1993 August 8 (Released)
  346. ---------------------------
  347. - Hexadecimal <-> Octal <-> Decimal conversion modes
  348.   and associated functions
  349. - summation functions
  350.  
  351. Version 0.8  1993 April 17 (Released)
  352. ---------------------------
  353. - Constant memory mode operation
  354. - Large and Small Window mode with appropriate fonts
  355. - FIX mode works again
  356. - no longer requires emx.dll
  357. - xyzt display option
  358. - yellow shift key
  359. - eng mode displays properly
  360.  
  361. Version 0.7a  1993 March 25 (Released)
  362. ---------------------------
  363. -window location fixed, so that whole window is displayed on VGA
  364. -pressing EEX by itself and then performing an operation gave 
  365.  incorrect results, now fixed.
  366. -double keys fixed, work under xfeel.
  367. -change to nonsizable border since, sizing is not valid for now
  368. -better looking icons:   
  369.     The sysmenu icon is now a more legible black
  370.  and background color icon, like the standard os2 windows.
  371.     Drop shadow for main icon (if you created
  372.  a program object for previous versions; to get the new main icon,
  373.  Go to settings, delete last 'E' from filename, click on parameters,
  374.  add 'E' back to filename.)
  375. -Add a few additional keybaord accelerators
  376.  
  377. Version 0.7   1993 March (Released)
  378. ------------------------
  379. -Initial beta release
  380.  
  381.