home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / pmcalc32.zip / pmcalc_e.HLP (.txt) < prev    next >
OS/2 Help File  |  2000-03-26  |  76KB  |  984 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.   pmCalc 
  5.  
  6. Version 3.2, March 2000 
  7.  
  8.    o  does not try to simulate a real calculator: For example, it does not have 
  9.       an "=" button. The notation of the formulas is like in a programming 
  10.       language. Nevertheless, there is a calculator-like mouse interface. 
  11.  
  12.    o  is Shareware. Without a registration key, you will get sometimes an info 
  13.       screen at the beginning - there's no other limitation. 
  14.  
  15.    o  is a true 32 bit program, available for Win95/NT and OS/2. 
  16.  
  17.    o  recalculates the result after every keystroke. You have an entry field 
  18.       and a separate result field. If a formula is incomplete or erroneous, 
  19.       pmCalc will display a detailed error message instead of the result. You 
  20.       can choose between different output formats. 
  21.  
  22.    o  supports easy transfer of input and output through the clipboard. 
  23.  
  24.    o  enables calulating with variables: X in the main entryfield will be 
  25.       replaced by the contents of the X entryfield. 
  26.  
  27.    o  recalculates variables like X if the result is given: for this regression 
  28.       in one dimension, press the reg button 
  29.  
  30.    o  supports scientific functions (press the fct button for an extended 
  31.       keyblock). 
  32.  
  33.    o  offers programmers functionality: hexadecimal, octal, binary and Ascii 
  34.       input, overflow simulation of integer variables (press the prg button). 
  35.  
  36.    o  remembers the last 20 inputs (last20 list) and saves formulas 
  37.       permanently. 
  38.  
  39.    o  supports hypertext online help. Press the help button and after that the 
  40.       button you want to have explained. You can simply press F1, too. Press 
  41.       help two times to get the help contents. 
  42.  
  43.    o  calculates with double precision floating point values, so you have 15 
  44.       correct digits. 
  45.  
  46.    o  has got a Pentium bug correction; the overflow simulation works correctly 
  47.       even with a defective Pentium II. 
  48.  
  49.  
  50. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  51.  
  52.  Copy the files of the pmCalc Archive to your harddisk into a new directory of 
  53. your choice. Then start INSTALL.CMD from the new, final directory. You will get 
  54. a program object "pmCalc" on your desktop. 
  55.  
  56. You can make a program object on your desktop using the program template in 
  57. your template folder. 
  58.  
  59. Please note that pmCalc has got a system menu (single clicking the left close 
  60. button). 
  61.  
  62. If you want to have pmCalc with colors, type into the program object settings 
  63. notebook parameter field: 
  64. color:COLORSMP 
  65.  
  66. pmCalc can be started with a lot of program parameters, so you can create 
  67. several program icons with different arguments. 
  68.  
  69. A nice idea to start pmCalc without the launchpad * 
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 3. Important items ΓòÉΓòÉΓòÉ
  73.  
  74.   See all clear, clipboard, input, last20 list, output format. 
  75.  
  76. You see, pmCalc can have colors. 
  77.  
  78.  
  79. ΓòÉΓòÉΓòÉ 4. Notation of the formulas ΓòÉΓòÉΓòÉ
  80.  
  81.  subchapters: 
  82. keyboard and mousebuttons 
  83. Ignored characters 
  84. Order of operators 
  85. Notation of floating point numbers 
  86. upper and lower case letters 
  87.  
  88. next chapter: 
  89. Output format 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 4.1. keyboard and mousebuttons ΓòÉΓòÉΓòÉ
  93.  
  94.  You can use the mouse buttons or the keyboard by typing directly into the main 
  95. entryfield or in the V, W, X and Y variable entryfields. To learn the notation 
  96. of pmCalc formulas, use the mouse buttons. 
  97.  
  98. (See important items) 
  99.  
  100. pmCalc offers a useful feature for generating brackets when using the mouse for 
  101. input. If your input is 1+2 and you want to multiply the result by 3, simply 
  102. enter 
  103.  *  *  3 . 
  104. pmCalc automatically changes the input into (1+2)*3 . 
  105. This feature works with * , / , pwr and the programmers operators. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 4.2. Ignored characters ΓòÉΓòÉΓòÉ
  109.  
  110.  You can always use spaces in your formulas; they will be ignored, even within 
  111. a number. 
  112.  
  113. You can write comments in brackets [ ], also several times. You can use the 
  114. keyboard or the com (comment) button. 
  115.  
  116. In hexadecimal numbers, you are allowed to use ":", which will be ignored. So a 
  117. hex-number can be #h12dc:0bf7 . 
  118.  
  119.  
  120. ΓòÉΓòÉΓòÉ 4.3. Order of operators ΓòÉΓòÉΓòÉ
  121.  
  122.  The order of calculating the operators without brackets is the following: 
  123.  
  124.    o  ' ( min ) min'sec (see minutes) 
  125.    o  ^ ( pwr ) to the Power of 
  126.    o  programmers operators 
  127.    o  / divide, * multiply 
  128.    o  - minus, + plus 
  129.  
  130.  
  131.  You can change the order by using parenthesis (  ). There is no limit of 
  132.  levels. 
  133.  
  134.  
  135. ΓòÉΓòÉΓòÉ 4.4. Notation of floating point numbers ΓòÉΓòÉΓòÉ
  136.  
  137.  Floating point numbers can be written with dot or comma, like 12.34 or  12,34 
  138. . You can use thousand-commas (American) or thousand-dots (German) like 
  139. 10,000.00 or 10.000,00 . pmCalc interprets commas and dots as equivalent. The 
  140. last dot/comma will be interpreted, other dots/commas aren't interpreted. For 
  141. example: 1,23.4.5.6.78 is the same as 123456.78 . 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 4.5. upper and lower case letters ΓòÉΓòÉΓòÉ
  145.  
  146.  Note that pmCalc is case-sensitive. The name of the constant 3.1415... is Pi, 
  147. not pi, the name of the constant 2.7182... is Eul not eul (Euler constant). 
  148. Also you aren't allowed to write functions like sin() with capital letters. If 
  149. you aren't sure, use the mouse buttons to learn the notation. Hex numbers 
  150. aren't case sensitive. 
  151.  
  152.  
  153. ΓòÉΓòÉΓòÉ 5. Output format ΓòÉΓòÉΓòÉ
  154.  
  155.  subchapters: 
  156. General  precision  fraction  min sec 
  157.  
  158. next chapter: 
  159. special features 
  160.  
  161.  
  162. ΓòÉΓòÉΓòÉ 5.1. General ΓòÉΓòÉΓòÉ
  163.  
  164.  You can choose how the result will be shown (output format). Enter a big 
  165. number and try the options in the drop down field. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 5.2. precision ΓòÉΓòÉΓòÉ
  169.  
  170.  With precision, you can enter the number of digits behind the dot. Note that 
  171. "precision 0" changes the result 2.4 to 2. If you press X< to copy the result 
  172. into the X field, "2" with the value 2.000 is copied and not 2.4. 
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 5.3. fraction ΓòÉΓòÉΓòÉ
  176.  
  177.  With the output format "fraction", pmCalc converts a floating point number 
  178. into a fraction. For example type 2.35888888 and you will get 2123/900. 
  179. Sometimes, this can take half a second because pmCalc has to employ a "trial 
  180. and error" strategy. 
  181.  
  182. Now enter a random digit like 2.36428754732 and change the precision. A higher 
  183. precision will force a small delay and very high precision will generate an 
  184. error "correct fraction not found". 
  185.  
  186.  
  187. ΓòÉΓòÉΓòÉ 5.4. min sec ΓòÉΓòÉΓòÉ
  188.  
  189.   /60 hour min sec divides the result by 60. For example 121 will be shown as 
  190. 2 h 1 min . Choosing result min'sec together with the "min" button, you can 
  191. simply calculate time: 18'21 - 14'43 = 3'38 . 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 6. special features ΓòÉΓòÉΓòÉ
  195.  
  196.  special features 
  197.  
  198. subchapters: 
  199. Minutes  Percent button  Pentium bug  Float on top  Changing colors  special 
  200. buttons 
  201.  
  202. next chapter: 
  203. V, W, X and Y entryfields 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 6.1. Minutes ΓòÉΓòÉΓòÉ
  207.  
  208.  You can enter hours, minutes and seconds: 2'30"45. ' and " are interpreted 
  209. similarly, so 2'30'45 is also allowed. 
  210. It's calculated as: 
  211.  
  212. h + min/60 + sec/3600 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 6.2. Percent button ΓòÉΓòÉΓòÉ
  216.  
  217.  The percent button always relates to the last operator: 
  218.  
  219.  1000+25% = 1250 
  220.  1000-25% =  750 
  221.  1000*25% =  250 
  222.  1000/25% = 4000 
  223.  
  224. You can use parenthesis (  ) with the percent button, also variables like X are 
  225. allowed. 
  226.  
  227.  1000+(12+13)% 
  228.  1000+X% 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 6.3. Pentium bug ΓòÉΓòÉΓòÉ
  232.  
  233.  pmCalc has an automatic Pentium bug correction. When you have a defective 
  234. Pentium (the old first ones built in 1994-1995) and enter a division where 
  235. defective Pentiums don't find the correct result, you will get the correct 
  236. result and hear a beep. For example 5505001/294911 , the correct result is 
  237. 18,66665197 ; the wrong result would be 18,66600093 . 
  238.  
  239. Also the Pentium II processor has got a bug: Sometimes the processor doesn't 
  240. give a correct overflow warning if a big number doesn't fit a smaller variable 
  241. (see programmers functions). Because pmCalc has got a different strategy 
  242. (pmCalc compares the content of the smaller variable with the old double 
  243. value), overflow simulation works correctly even with a defective Pentium II. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 6.4. Float on top ΓòÉΓòÉΓòÉ
  247.  
  248.  If you choose "Float on top" in the pmCalc System Menu (single clicking the 
  249. left close button), the pmCalc window is always on top of all windows. This can 
  250. be useful if another program fits the whole screen. 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 6.5. Changing colors ΓòÉΓòÉΓòÉ
  254.  
  255.  If you have nothing to do (e. g. making boring phone calls), you can drag and 
  256. drop OS/2 system colors to the pmCalc buttons and entryfields, see color 
  257. sample. To change the color of the font instead of the button, press Ctrl while 
  258. dropping. To store the colors in a file, you have to enter a program parameter 
  259. in the pmCalc program object settings notebook parameter field: 
  260.  
  261. color:filename 
  262.  
  263. As default, the file has to be placed in the directory where PMCALC.EXE is 
  264. located. The file format is binary, so you can't edit the file. The file 
  265. COLORSMP is a sample color file. 
  266.  
  267. If you have spent a lot of time changing colors, make a copy of your color 
  268. file. Sometimes pmCalc corrupts the color file. * 
  269.  
  270. If you think your colors are very nice, you can send the file to me by email. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 6.6. special buttons ΓòÉΓòÉΓòÉ
  274.  
  275.   AC all clear. Clears the main, X and Y entryfields, saves the old input in 
  276. the last20 list 
  277.  
  278.  EXP exponent. 1.0e3 means 1.0 * 10^3 = 1000 
  279.  
  280.  pwr means x power of y  (x^y) 
  281. sample: 2^4 = 2*2*2*2 = 16 
  282.  
  283.  1/ 1/(x): reciprocal of x 
  284.  
  285.  undo restores the last input which was not changed for 2.5 seconds. 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 7. V, W, X and Y entryfields ΓòÉΓòÉΓòÉ
  289.  
  290.  In the V, W, X and Y field, you can enter numbers or formulas which can be 
  291. changed without changing the main entry field. For example, the formula in the 
  292. main entry field is "(X+Y)/2", and the X field is "5", the Y field is "3+4", 
  293. pmCalc replaces the X and Y characters in the main entry field with the 
  294. occurences of the X and Y field in brackets: 
  295.  
  296. ((5)+(3+4))/2 
  297.  
  298. The result is 6. 
  299.  
  300. Note that there's a regression mode where you can recalculate variables like X 
  301. when the result is known. 
  302.  
  303. With clipvar you can set the values of the V to Y variables from the clipboard. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 8. Regression ΓòÉΓòÉΓòÉ
  307.  
  308.  If you have got a formula with variables X, Y, V, W and the result is given, 
  309. you can recalculate the value of a variable, e. g. 
  310.  
  311. 3*X^2 + 8*X + 3 = 206 
  312.  
  313. What's the value of X ? To get an answer, do the following: 
  314.  
  315.    o  Enter the formula without the equal character in the main entry field and 
  316.       without the number on the right side of the equals sign 
  317.    o  you can optionally enter a value of your choice into the X field 
  318.    o  press the reg button 
  319.    o  enter 206 in the regression entry field 
  320.    o  press the X? button. 
  321.  
  322.  
  323.  pmCalc has to employ a "trial and error" strategy, but it works very fast, 
  324.  hardly without any delay. 
  325.  
  326.  With the = button near the regression entry field, the contents of the pmCalc 
  327.  result field is copied into the regression entry field. 
  328.  
  329.  With the precision spinbutton, you can influence the regression: a precision 
  330.  of 4 will calculate the X value to 4 decimal places. Because of rounding 
  331.  effects, it's possible that the regression doesn't hit the result exactly, 
  332.  e.g. in the pmCalc result field there's 19.9997 even if the regression entry 
  333.  field is 20. 
  334.  
  335.  It can happen that if the X field is empty, pmCalc does not find any X value 
  336.  or, if there are more than one possible X values, it does not hit the result 
  337.  you are interested in. In these cases, you can enter a start value in the X 
  338.  field which is near the result. For example enter X*X into the main entry 
  339.  field, 400 into the regression entry field and -1 into the X field. Then 
  340.  pmCalc finds the X value -20. (There are two correct values: 20 and -20.) 
  341.  
  342.  A good start value can reduce regression calculating time. 
  343.  
  344.  
  345. ΓòÉΓòÉΓòÉ 9. Clipboard ΓòÉΓòÉΓòÉ
  346.  
  347.  subchapters: 
  348. General 
  349. Using Z and autoclip simultaneously 
  350. Export and Import of a formula 
  351. hidden pmCalc 
  352. clipvar: setting V-Y values 
  353.  
  354. next chapter: 
  355. Saving formulas - the last20 list 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ 9.1. General ΓòÉΓòÉΓòÉ
  359.  
  360.  pmCalc can be used with the Clipboard (Clipboard = Z ). 
  361. You can enter a formula like sin(Z/3) "sine of (Clipboard divided by 3)". The 
  362. clipboard may contain a number or a formula. 
  363.  
  364. When autoclip is on, pmCalc automatically writes the result into the clipboard. 
  365.  
  366.  
  367. ΓòÉΓòÉΓòÉ 9.2. Using Z and autoclip simultaneously ΓòÉΓòÉΓòÉ
  368.  
  369.  Using Z and autoclip simultaneously: Every time you copy a number or a formula 
  370. to the clipboard (from another application), pmCalc will grab it and substitute 
  371. it for every Z in its formula. Then the result will be placed into the 
  372. clipboard automatically. So you can use pmCalc in the background. 
  373.  
  374. To test the clipboard function, I recommend using the OS/2 "show clipboard" 
  375. program. * 
  376.  
  377.  
  378. ΓòÉΓòÉΓòÉ 9.3. Export and Import of a formula ΓòÉΓòÉΓòÉ
  379.  
  380.  If you want to export a formula into another application, you can copy it into 
  381. the clipboard by pressing the Z< button next to the main entry field. For To 
  382. re-use the formula, you copy it back to the clipboard and then press the Z> 
  383. button in pmCalc. 
  384.  
  385. pmCalc can save a formula itself. 
  386.  
  387. Note that you are allowed to write comments in brackets [ ]. 
  388.  
  389. You can put several lines from an editor into the clipboard. Pushing the Z> 
  390. button or using the Z variable, pmCalc will change every "Return" into a "+". 
  391. Remember that spaces will be ignored. 
  392.  
  393. With the button = > Z , you can write the input and the result in the clipboard 
  394. simultaneously, for example 
  395.  
  396. 1+1 = 2.0000 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 9.4. hidden pmCalc ΓòÉΓòÉΓòÉ
  400.  
  401.  If your input is a simple "Z" in the main entry field and autoclip is on, you 
  402. can use pmCalc completely in the background. Copying a formula from your editor 
  403. into the clipboard will automatically return the result into the clipboard. 
  404.  
  405. It can be useful to put the pmCalc-window at the bottom of your desktop, so 
  406. only the result field and the Z-field is shown and everything below the result 
  407. field is outside the desktop. 
  408.  
  409.  
  410. ΓòÉΓòÉΓòÉ 9.5. clipvar: setting V-Y values ΓòÉΓòÉΓòÉ
  411.  
  412.  When clipvar is on, you are enabled not only to set the Z value, also the  V 
  413. to Y values. To do so, enter a formula containing the Z variable. I you don't 
  414. use all other variables, first use Y , then X and so on. If you copy a new 
  415. value into the clipboard, not only Z gets the new value. Also the  Y variable 
  416. gets the old Z value, the X variable the old Y value and so on. So you can set 
  417. all the variable values by copying values to the clipboard, beginning with the 
  418. V value. 
  419.  
  420. To test this functionality, write into the entry field: 
  421.  
  422. X+Y+Z 
  423.  
  424. and into an editor 
  425.  
  426.  
  427. Then mark each of the three numbers and place the three numbers to the 
  428. clipboard, one after another. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 10. Saving formulas - the last20 list ΓòÉΓòÉΓòÉ
  432.  
  433.  subchapters: 
  434. The Last20 List  Saving formulas  Loading formulas  Default formula 
  435.  
  436. next chapter: 
  437. Programmers functionality 
  438.  
  439.  
  440. ΓòÉΓòÉΓòÉ 10.1. The Last20 List ΓòÉΓòÉΓòÉ
  441.  
  442.  pmCalc remembers the last 20 inputs. Every input immediately before pressing 
  443. AC will be placed in the last20 list. In other words, the  AC button saves the 
  444. old input and deletes the entry field. 
  445.  
  446. With the up and down buttons near the main entry field, you can reuse older 
  447. inputs. 
  448.  
  449. The current input is lost if you don't press AC , e.g. when recalling a last20 
  450. list entry. 
  451.  
  452. If you exit pmCalc, the last 20 inputs will be saved in the text file 
  453. LAST20.TXT. You can edit this file with an text editor. 
  454.  
  455. You can use your own formula files: A program parameter containing ".TXT" or 
  456. ".PMC" is a filename which is used instead of "LAST20.TXT". So you can drop 
  457. your special formulas to the pmCalc program object. Making an association 
  458. "*.PMC" enables you to start the formula file directly with double-click. 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ 10.2. Saving formulas ΓòÉΓòÉΓòÉ
  462.  
  463.  If the input begins with a comment, e.g. 
  464.  
  465. [simple] X + Y*2 
  466.  
  467. and you press AC , the formula will be placed in the last20 list  permanently. 
  468. That means, in the file LAST20.TXT you can have a lot of formulas beginning 
  469. with "[" and 20 normal inputs not beginning with "[". 
  470.  
  471. When changing a formula which is already part of the last20 list (that means, 
  472. it begins with the same comment) the old entry in the last20 list is replaced 
  473. when pressing AC . 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ 10.3. Loading formulas ΓòÉΓòÉΓòÉ
  477.  
  478.  If you type only the leading comment of a formula which is already part of the 
  479. last20 list, the formula will be expanded automatically (!). 
  480.  
  481. To try this, simply enter 
  482.  
  483. [sq] 
  484.  
  485. for the square equation formula which is already part of the last20 list. If 
  486. there are any characters (e.g. a space) after the comment brackets, the 
  487. expansion won't work. 
  488.  
  489.  
  490. ΓòÉΓòÉΓòÉ 10.4. Default formula ΓòÉΓòÉΓòÉ
  491.  
  492.  If you enter a formula beginning with 
  493.  
  494. [default] 
  495.  
  496. (in lower case letters), the formula always appears when starting pmCalc. 
  497.  
  498. Note that you can start pmCalc with different last20 lists by using the program 
  499. parameter filename.txt or filename.pmc. With the file association *.pmc, you 
  500. can easy start different pmCalc's with different default formulas. 
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ 11. Programmers functionality ΓòÉΓòÉΓòÉ
  504.  
  505.  Press the prg button for an extended keyblock. 
  506.  
  507. subchapters: 
  508. numeric forms 
  509. Programmers operators 
  510. Simulation of integer operations 
  511.  
  512. next chapter: 
  513. Scientific functions 
  514.  
  515.  
  516. ΓòÉΓòÉΓòÉ 11.1. numeric forms ΓòÉΓòÉΓòÉ
  517.  
  518.  For hexadecimal input, you can press the hex button or you can write $ or #h. 
  519. After that, a 32-bit numeric value (from 0 to to 4294967295) is expected. ":" 
  520. is ignored. 
  521.  
  522. Other numeric forms and ASCII characters are entered with the buttons oct , 
  523. bin , ASCII or with a hash followed by the characters o for octal, b for binary 
  524. and a for ASCII. So the decimal number 100 can be written as: 
  525.  
  526. 100 
  527. $64 
  528. #h64 
  529. #h0000:0064 
  530. #o144 
  531. #b0110 0100 
  532. #ad 
  533.  
  534. Remember that you are always allowed to use spaces. You can also choose these 
  535. numeric forms in the output format. 
  536.  
  537.  
  538. ΓòÉΓòÉΓòÉ 11.2. Programmers operators ΓòÉΓòÉΓòÉ
  539.  
  540.  The Programmers window offers you new operators. In addition to + , - , / ,  * 
  541. , you have got the bitwise operators 
  542.  
  543.  and  indicates by the character & 
  544.  or | 
  545.  xor \ 
  546.  shl < (shift left) 
  547.  shr > (shift right) 
  548.  mod ~ (modulo) 
  549.  
  550.  not is a function and takes the form not (X) 
  551.  
  552. The choice of integer variables (long/short/char) has no influence on other 
  553. operators and functions besides the operators shown above. 
  554.  
  555. Modulo calculates the rest of a division, for example 11 modulo 7 = 4. If the 
  556. Programmers Window is closed and all calculations are made by Double floating 
  557. point variables, you can use the modulo operator nevertheless. Modulo is 
  558. calculated then with floating point variables: So Modulo is not an Integer 
  559. specific operator. 
  560.  
  561. If you want to understand the effect of these operators, use the binary input 
  562. and output of pmCalc. 
  563.  
  564.  
  565. ΓòÉΓòÉΓòÉ 11.3. Simulation of integer operations ΓòÉΓòÉΓòÉ
  566.  
  567.  pmCalc lets you calculate with specific integer variables. You can choose 
  568. between 3 * 2 settings: variables of 4, 2 and 1 byte, and signed or unsigned. 
  569. E.g. with the calculation of not(1) and the unsigned setting you will get three 
  570. different results, dependent on the variables you choose. 
  571.  
  572. You can simulate overflow, underflow and trunctation of integer variables. If 
  573. one of theses events occurs, on the programmers window "calc overflow!" is 
  574. displayed and in the pmCalc result field you will see the "wrong" result. 
  575.  
  576. Example: Use "unsigned char" and calculate 255+3. Because a char has only 256 
  577. different values, you will get an overflow and the result is 2. 
  578.  
  579. pmCalc 3.1 offers you four different messages: 
  580.  
  581.    o  var overflow 
  582.    o  var truncate 
  583.    o  calc overflow 
  584.    o  calc underflow 
  585.  
  586.  
  587.  If the value which was not calulcated by an operator does not fit the selected 
  588.  variable size, "var overflow/truncate" is shown. If the event occurs while 
  589.  calculating two values with an operator, "calc overflow/underflow" is shown. 
  590.  The messages can appear simultaneously. 
  591.  
  592.  For Pascal programmers: The expressions long, short, char are the C synonyms 
  593.  for LONGINT, INTEGER, BYTE. "Unsigned short" is a WORD. In Pascal, LONGINT and 
  594.  INTEGER are signed, BYTE is unsigned. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 12. Scientific functions ΓòÉΓòÉΓòÉ
  598.  
  599.  pmCalc supports scientific functions (press the fct button for an extended 
  600. keyblock). 
  601.  
  602. subchapters: 
  603. Trigonometric Functions  Logarithmic functions  other functions 
  604.  
  605. next chapter: 
  606. program parameters 
  607.  
  608.  
  609. ΓòÉΓòÉΓòÉ 12.1. Trigonometric Functions ΓòÉΓòÉΓòÉ
  610.  
  611. sin(x)   sine of x
  612. cos(x)   cosine of x
  613. tan(x)   tangent of x
  614. asin(x)  arcsine: inverse function of sin(x)
  615.                       asin(sin(x)) = x
  616.   acos(x)  arccosine: inverse function of cos(x)
  617.   atan(x)  arctangent: inverse function of tan(x)
  618.  
  619.   Pi     the constant Pi (3,1415...)
  620.  
  621.  With the checkbutton degree you can choose between degree and radian input. 
  622.  If degree is activated, trigonometric functions are running with degrees. For 
  623.  example, sin(90) is 1.0000. If you turn degree off, you can enter radian 
  624.  input. The equivalent input would now be sin(Pi/2). 
  625.  
  626.  
  627.  
  628.                              degree and radial values
  629.  
  630.  
  631.  
  632.  
  633.                         Figure of Sine, Cosine and Tangent
  634.  
  635.  
  636.  
  637.  
  638.   Sine and Cosine curve
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ 12.2. Logarithmic functions ΓòÉΓòÉΓòÉ
  642.  
  643. ln(x)   natural logarithm of x
  644. log(x)   logarithm of x, base 10
  645.  
  646. Eul    the euler constant (2.71828...)
  647.  
  648. Eul^x is the inverse function of ln(x). 
  649. 10^x is the inverse function of log(x). 
  650.  
  651.  
  652. ΓòÉΓòÉΓòÉ 12.3. other functions ΓòÉΓòÉΓòÉ
  653.  
  654. frac(x)  fraction:  frac(67.89) = 0.89
  655. int(x)   integer part:  int (67.89) = 67.00
  656. abs(x)   absolute value:  abs(12) = 12  abs(-12) = 12
  657.  
  658. fac(x)   x!  factorial of x
  659.                       fac(4) = 1*2*3*4 = 24
  660.                       floating point numbers are converted by int(abs(x))
  661.  
  662.   sqr(x)   square of x, equal to x^2
  663.   sqrt(x)  square root of x, equal to x^(1/2)
  664.  
  665.  
  666. ΓòÉΓòÉΓòÉ 13. program parameters ΓòÉΓòÉΓòÉ
  667.  
  668.  pmCalc can be started with several program parameters. Note that most entries 
  669. are case-sensitive, the order makes no difference. So you can create several 
  670. pmCalc program icons with different parameters. 
  671.  
  672. Program parameters can be entered in the "parameter" field of the pmCalc 
  673. program object settings notebook. 
  674.  
  675. A number specifies the output precision. 
  676.  
  677. A double-quoted string specifies the output format. It has to match exactly one 
  678. of the strings available in the output format field. 
  679.  
  680. input:sin(X)*2 starts pmCalc with the formula "sin(X)*2" in the main entry 
  681. field. Note that you have to use quotes if you have got spaces in your formula, 
  682. e.g. "input:sin(X) * 2" . You can also choose a default entry by using the 
  683. default formula. 
  684.  
  685. autoclip makes the autoclip checkbox on when starting pmCalc. 
  686.  
  687. radial turns the "degree" checkbox off when starting pmCalc, degree turns it 
  688. on. 
  689.  
  690. iconized starts pmCalc iconized, maximized starts pmCalc maximized. Clicking 
  691. into the "pmCalc" entry of the tasklist shows pmCalc. 
  692.  
  693. Filename.txt or Filename.pmc uses a specific file for the Last20 list  instead 
  694. of the default LAST20.TXT file. 
  695.  
  696. color:filename is for loading and saving position and button colors in the file 
  697. "filename". 
  698.  
  699. Examples: 
  700.  
  701. "scientific (exp)" 10 
  702.  
  703. 2 "thousand-comma" 
  704.  
  705. input:Z autoclip iconized 
  706. starts pmCalc to use in the background. 
  707.  
  708.  
  709. ΓòÉΓòÉΓòÉ 14. About pmCalc ΓòÉΓòÉΓòÉ
  710.  
  711.  subchapters: 
  712. Shareware registration 
  713. bugs and improvements 
  714. Disclaimer 
  715. Contacting the author 
  716. Another pmCalc program 
  717. Plot functions 
  718. the name "pmCalc" 
  719. other programs 
  720. About this hypertext 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ 14.1. Shareware registration ΓòÉΓòÉΓòÉ
  724.  
  725.  This program is Shareware. If you register pmCalc, you will get a registration 
  726. code you have to enter in the pmCalc main entry field and select "process 
  727. registration" in the system menu. A new pmCalc.exe file is not necessary. 
  728.  
  729. The registration fee is 25 Dollars or 22 Euro . 
  730.  
  731. When ordering more than one licenses, you will get a 30% discount for every 
  732. additional license. 
  733.  
  734. If you live in America then please contact BMT micro . See BMTORDER.TXT for 
  735. details. 
  736.  
  737. BMT Micro, Inc. 
  738. 910-791-7052 Voice / 910-350-2937 Fax 
  739. finger tbrad@wilmington.net for PGP public key 
  740. http://www.bmtmicro.com 
  741. ftp.bmtmicro.com/bmtmicro 
  742. alternate E-Mail:  bmt01@ibm.net 
  743.  
  744. If you can send Deutsche Mark (for example you live in Germany), my bank 
  745. account Number is: Dresdner Bank Ottobrunn (Germany), Bank Code 700 800 00, Nr. 
  746. 075 64 62 400. The fee in Deutsche Mark is 45 DM . 
  747.  
  748. My E-Mail address is: 
  749. Martin@vr-transport.de 
  750.  
  751. My postal address is: 
  752.  
  753. Dr. Martin Vieregg 
  754. Emdenstr. 11 
  755. D-81735 M╨ænchen 
  756. Germany 
  757.  
  758.  
  759. ΓòÉΓòÉΓòÉ 14.2. bugs and improvements ΓòÉΓòÉΓòÉ
  760.  
  761.  pmCalc 2.90, 2.0 and 1.0 were available for OS/2 only. 
  762.  
  763. What's new in pmCalc 3.2 
  764.  
  765.    o  Window width can be modified (but it is not saved) 
  766.  
  767.  
  768.  What's new in pmCalc 3.1 
  769.  
  770.    o  float on top 
  771.    o  clipvar: setting variable values V to Y by using the clipboard 
  772.    o  installation program. 
  773.  
  774.  
  775.  What's new in pmCalc 3.0 
  776.  
  777.  A lot of minor improvements; system menu. First version available for 
  778.  Win95/NT. Some minor bugfixes in the new regression and programmers 
  779.  functionality. 
  780.  
  781.  What's new in pmCalc 2.9 
  782.  
  783.  Regression and new Programmers functionality. 
  784.  
  785.  What's new in pmCalc 2.0 
  786.  
  787.    o  several bugfixes 
  788.    o  binary, octal, ASCII input and output 
  789.    o  percent button 
  790.    o  fraction output 
  791.    o  last20 list, easy save and restore formulas 
  792.    o  saving colors and window position 
  793.    o  increased number of variable entryfields 
  794.    o  more detailed docu, see graphics in trigonometric functions and important 
  795.       items 
  796.    o  new buttons for "home" and "end" of the cursor in the main entry field, 
  797.       button for copying result into main entry field 
  798.    o  several new program parameters 
  799.    o  several minor improvements. 
  800.  
  801.  
  802.  Known bugs: 
  803.  The iconized window won't show the pmCalc-Icon. 
  804.  The output format - drop-down box and the precision entryfield does not 
  805.  remember colors. (Perhaps a bug in OS/2 Warp? I have no fixpacks.) 
  806.  Sometimes pmCalc corrupts the color file. (I haven't got any idea what's the 
  807.  reason.) 
  808.  
  809.  Fixed bugs in 3.2 since 3.1: 
  810.  
  811.    o  (only OS/2) When pasting data from the cliboard by using the Z variable 
  812.       or the Z> button, sometimes an arbitrary random character was added. This 
  813.       caused a calculating malfunction if the character is a digit. 
  814.  
  815.  
  816.  Fixed bugs in 3.1 since 3.0: 
  817.  
  818.    o  Since 1995 there is a bug in the formula interpreter, and there is only 
  819.       one known formula which was calculated wrong: sin(7)^2+sin(5)^2 
  820.    o  In the Programmers Window "Overflow" is shown, even it is an underflow or 
  821.       a simple trunctation. 
  822.    o  Regression with imaginary polynom functions forces cancelling the 
  823.       program, e.g.: x*x + 5*x + 2 
  824.  
  825.  
  826.  Improvements and fixed bugs 2.0 to 2.9: 
  827.  
  828.    o  fixed bug: -min'sec forces an incorrect result 
  829.    o  Saving X, Y, V, W values when pmCalc saves a formula. 
  830.  
  831.  
  832.  Improvements and fixed bugs 0.90 to 1.00: 
  833.  
  834.    o  tan() und atan() are OK now 
  835.    o  numeric overflow has got better error handling 
  836.    o  output result "normal (dot)" and "normal (comma)" 
  837.    o  comments in brackets [ ] allowed 
  838.    o  hypertext help. 
  839.  
  840.  
  841.  Of course, I can't test all possible formulas with pmCalc. It is possible that 
  842.  pmCalc calculates wrong results under certain circumstances. I would be very 
  843.  interested in knowing such bugs. Please write me an E-Mail if you find such a 
  844.  bug. 
  845.  
  846.  
  847. ΓòÉΓòÉΓòÉ 14.3. Disclaimer ΓòÉΓòÉΓòÉ
  848.  
  849.  pmCalc is provided as is and comes with no warranty of any kind, either 
  850. expressed or implied. In no event will the author be liable for any damages 
  851. resulting from the use of this software. 
  852.  
  853.  
  854. ΓòÉΓòÉΓòÉ 14.4. Contacting the author ΓòÉΓòÉΓòÉ
  855.  
  856.   Martin Vieregg, 34. I've studied economics. My main job is working in my own 
  857. consulting company. Our special subject is public transport, especially 
  858. railways. Visit http:www.vr-transport.de . The title of my doctoral (PhD) 
  859. thesis was "increasing efficiency of railway long-distance passenger traffic". 
  860.  
  861. My E-Mail address is: 
  862.  
  863. Martin@vr-transport.de 
  864.  
  865. My Homepage is: 
  866.  
  867. http://www.vr-transport.de/Martin 
  868.  
  869. Here you will get newest information about my programs, bug reports and beta 
  870. versions. 
  871.  
  872. My postal address is: 
  873.  
  874. Dr. Martin Vieregg 
  875. Emdenstr. 11 
  876. D-81735 Munich 
  877. Germany 
  878.  
  879.  
  880. ΓòÉΓòÉΓòÉ 14.5. Another pmCalc program ΓòÉΓòÉΓòÉ
  881.  
  882.  Please notice that a second "PMCALC" exists. PMCALC.ZIP for OS/2 is an IBM 
  883. employee written software, Tim Baldwin, U.K. We had both shipped our pmCalc 
  884. programs in March 95. Tim Baldwin's PMCALC imitates a real pocket calculator. 
  885. To distinguish in archives, this calculator is always shipped with the version 
  886. number in the zip file name, Baldwin's is not. Baldwin's archive is often 
  887. listed as PMCALC0. 
  888.  
  889.  
  890. ΓòÉΓòÉΓòÉ 14.6. Plot functions ΓòÉΓòÉΓòÉ
  891.  
  892.  pmCalc calculates with formulas containing variables, but it can not plot 
  893. functions. I will not include this functionality in the future because of the 
  894. the Freeware program Gnuplot. The syntax of the formula is nearly the same as 
  895. pmCalc, the main difference is the "power of" sign (pmCalc ^ GnuPlot **). You 
  896. will find a short description and download links of Gnuplot on my Homepage, 
  897. page "My favorite software". 
  898.  
  899. http://www.vr-transport.de/Martin 
  900.  
  901.  
  902. ΓòÉΓòÉΓòÉ 14.7. the name "pmCalc" ΓòÉΓòÉΓòÉ
  903.  
  904.  For our Windows users: PM (Presentation Manager) is the name of the graphical 
  905. environment of the IBM Operating System OS/2. All programs using this graphical 
  906. environment are "PM-programs". 
  907.  
  908. pmCalc was written in 1995 for OS/2 and is available for Win95/NT since 1997 
  909. (version 3.0). 
  910.  
  911.  
  912. ΓòÉΓòÉΓòÉ 14.8. other programs ΓòÉΓòÉΓòÉ
  913.  
  914.  I've also written other Freeware- and Shareware programs. Visit my Homepage 
  915. http://www.vr-transport.de/Martin 
  916.  
  917. both Win95/NT and OS/2; Linux versions for some programs are planned. 
  918.  
  919. WSedit: 
  920. Editor compatible to Wordstar: reading and writing Wordstar (DOS) files, ASCII 
  921. IBM and ISO codepage. Supports Wordstar Ctrl key commands and CUA commands. 
  922. Syntax-highlightning, Translation, spell checking, function key macro recorder 
  923. and a lot of other features. WSedit handles very large ASCII files. Freeware. 
  924.  
  925. HyperMake: 
  926. Creates HTML files, Winhelp MS HTML-Help and OS/2 Help from a more simple and 
  927. intelligent ASCII format. Automatic linking, window arrangement, helptables, 
  928. footnotes, tables and other features. Shareware if source file > 20 kB. See 
  929. hypertext 
  930.  
  931. TinyAlarm: 
  932. A simple countdown with a slider from 1 to 60, an alarm by entering alarm time 
  933. and a chime. System shutdown. Freeware. 
  934.  
  935. cd-shortcut: 
  936. instead of whole directory names you enter only substrings. Searching through 
  937. several drives and opening OS/2 WPS folders. Freeware. 
  938.  
  939. Simple Zipshell: 
  940. Packing and unpacking ZIP files by using the graphical desktop. Freeware. 
  941.  
  942. Clear: 
  943. (only OS/2) Uses also Info-Zip and let you backup your data e.g. on floppies. 
  944. You can enter filenames like *.BAK which are not copied, directories which are 
  945. skipped. Then you can enter filenames with a specific age which are deleted. 
  946. Freeware. 
  947.  
  948.  
  949. ΓòÉΓòÉΓòÉ 14.9. About this hypertext ΓòÉΓòÉΓòÉ
  950.  
  951.  I have created this hypertext by using my HyperMake hypertext software. It 
  952. creates Winhelp, OS/2 help and HTML files from one simple and intelligent ASCII 
  953. format. If a phrase is marked with an "index char", it is placed in the index 
  954. and all other occurrences in the hypertext will get a link automatically. 
  955. HyperMake also creates Helptables, and for line drawing, footnotes, window 
  956. arrangement (and so on) there are short commands. The links at the end of some 
  957. windows "subchapters... next chapter..." are created automatically. HyperMake 
  958. is Shareware for source files > 20 kB. 
  959.  
  960. Visit my homepage for more information about HyperMake. 
  961.  
  962. http://www.vr-transport.de/Martin 
  963.  
  964. End of hypertext 
  965.  
  966.  
  967. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  968.  
  969. Open the settings notebook of the desktop, open the "menu"-page and drag your 
  970. pmcalc program object into the second yellow text-window. Now you have a new 
  971. menu item in your standard-context-menu like "shutdown": "pmCalc". 
  972.  
  973.  
  974. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  975.  
  976. It happened once to me. Sorry, but I haven't got any idea what's the reason. 
  977.  
  978.  
  979. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  980.  
  981. You'll find it in the system / productivity folder