Kalk 3.0.12 Information Page | |||||||||||||||||||

Introduction | |||||||||||||||||||

KALK is a RPN calculator with statistical computation functions.
You can upload it into your pilot with your install.exe
Application (WinDOS) or with pilot-xfer (Unix) as any
other application. Download kalk3010.zip.
(Under UNIX, use unzip -L to uncompress to get lowercase
filenames.)
| |||||||||||||||||||

Whats new? | |||||||||||||||||||

Fixed a glitch in display mode 'all' - finally. | |||||||||||||||||||

General Usage | |||||||||||||||||||

The register you are editing is the 'X' register. One above you
have the 'Y' register. You should remember this to understand
the labels on some of the buttons. For example: y^x means
that you have to type the base and then the exponent. After
pressing ENTER the base will move from the X to the Y register
and the eponent will be entered into the X register afterwards.
| |||||||||||||||||||

Kalk and the Clipboard | |||||||||||||||||||

Kalk can Copy the X register into the clipboard as is.
Whenever you Paste from the clipboard, the contents of
the clipboard ist being interpreted as normal keystrokes.
This is only intened to allow copying and pasting of numbers -
but you can also paste | |||||||||||||||||||

Preferences | |||||||||||||||||||

The Preferences Menu lets you select different modes
in which Kalk should work.
- Display lets you select the number of digits to
be displayed and the way, numbers are being printed.
**All**- Prints all relevant digits.
**Fixed**- Prints only the requested number of digits after the period and switches to exponential display only of the number does not fit into the display. (That's the mode you normally want).
**Sci**entific- Same as fixed but shows always the exponent.
**Eng**ineering- Same as Sci, but makes the exponent a multiple of three.
- In All and Fixed mode the digits may be grouped in thousands (or nibbles or words depending on the base).
- Angle Mode lets you select the units to use for angles.
**Radian**- A full circle is 2*Pi=6.28
**Degree**- A full circle is 360.
- Base delect the base in which the numbers are being displayed. Only in Decimal mode fractions are being displayed. YOu can enter only digits which are valid in the current Base mode. In order to type hexgesimal numbers 'a' to 'f', you have to use the corresponding keystrokes.
| |||||||||||||||||||

Statistical Functions (German
version) | |||||||||||||||||||

You can enter pairs of numbers into KALK on which it tries to
do linear regression analysis. This means that it tries to find
line which approximates the cloud of points you entered.
Well, this is not a course in statistics, but here is a short explanation of the functions anyway:
| |||||||||||||||||||

KALK questions | |||||||||||||||||||

**What does KALK mean?**- It's the way Germans procounce calc. Also, it means chalk, an important tool for matematicans to do calculations :-).
**How can I get the Menu (or Preferences or the Copy command)? There is no title bar to tap on.**-
You have to use the "old" way to access the menu, which is tapping
the lower left button. This was the only way to get the menu until
Palm OS 3.0.
You can also use the popup menu stroke (lower left to upper right) if you want to get quick access to the menu commands. **What is RPN? Where is the '=' Key?**-
RPN means "reverse polish notation". On RPN calculators you have
to type operations after you have typed in all arguments.
Eg: "
`3 ENTER 4 +`" instead of`3 + 4`. The ENTER is needed to separate the two arguments. RPN calculators do not have the '=' key. **Why RPN?**- With RPN you do not need brackets. Moreover, it is much easier to reuse results from previous computations. All arguments are being put on the "stack". Whenever you type an operation, the calculator will get as much arguments as it needs from the stack and put the result back on the stack. And, RPN is much cooler. :-)
**What's a stack?**- A stack is some kind of storage where you can put things on and get it from in the order "last in - first out".
**When I press ENTER the last entered value has been duplicated!**-
The value is not really duplicated because after pressing ENTER
the "stack lock" is on, which means that entering a digit will
not push the number again. The contents of the X register will be
replaced by the new digit.
That's the way my HP 42S behaves. I know that there are other models - even in HP calculators. But the advantage of this version is that pressing ENTER twice will push the X register twice in an intuitive way. **Kalk prints wrong results!**-
If you are using an old version of Kalk, upgrade to 3.0 as it uses a double precision library with far better accuracy. However, calculations like `PI sin`will never show 0. This is due to the limited precision all numeric calculators use. More surprisingly,`180 sin`in "degree" mode also has a problem: As MathLib only supports radian, I have to transform into radian and lose precision. Sorry folks :-)If you get wrong results and you are sure that the result is worse than it could be, tell me about computation you need to have improved. In display mode "all" Kalk before 3.0.9 sometimes just "showed" the wrong number but did calculate with the right one. **Where are the keys 'a' to 'f' for entering hexagesimal digits?**- There aren't any. You can enter letters by using the regular keysotrokes. The 'E' Button is not for entering the hexagesimal digit 'e' :-) Note: You can also enter digits by keystroke.
**Can I see more numbers from the stack?**- No problem, just press the up or down button to scroll though the stack.
| |||||||||||||||||||

Limitations | |||||||||||||||||||

**Some illegal operations do not trigger properly.**- This is due to the implementation of the floating point routines.
**There is no visual marker wether one is using Degree or Radian**- Stay tuned, its on my to do list. However, you can always peek into the Preferences menu.
| |||||||||||||||||||

Registration | |||||||||||||||||||

This program is postcard-ware, which means that you may copy and
distribute it as far as you like. I won't charge you any fee for this.
But you may not charge anyone for this program either.
If you like KALK, you have to send send a postcard with your email
address to
Holger Klawitter Christianstr. 19 04105 Leipzig Germany(eMail reports will be thankfully accepted but do not count as registraton :-) ## If you are a shareware programmer...... keep in mind that you got my software for free. :-) | |||||||||||||||||||

Acknowledgements | |||||||||||||||||||

I would like to thank especially all developers of the Unix-tools for Pilot software development. Thanks to Wes Cherry, Jeff Dionne, Kenneth Albanowski, Ian Goldberg, Scott Grosch, Brian Swetland, and many more and thanks to USR for supplying the public with the developers handbooks. | |||||||||||||||||||

Revision History | |||||||||||||||||||

**3.0.9 (2006-07-13)**- Fixing the glitch in display mode all now really!
**3.0.8 (2006-02-21)**- Fixing a glitch in display mode all
**3.0.7 (2004-10-08)**- Fixing a glitch in angle conversion
**3.0.6 (2003-11-08)**- Some fixes for Palm OS 5.2.1 (Tungsten E)
**3.0.5 (2003-03-17)**- Some more fixes to display mode 'all'
**3.0.4 (2002-09-23)**- Fixed unloading of MathLib
**3.0.3 (25. May 2002)**- Some display fixes for mode 'all'.
**3.0.2 (25. May 2002)**- Better accuracy in display mode 'all'.
**3.0.1 (02. May 2002)**- Read local number format; allow entering "," and "." as decimal comma; small bugfixes.
**3.0 (01. May 2002)**- Improved precision (now using MathLib); digit grouping support.
**2.1.4 (07. Jan 2002)**- Got rid of single precision arithmetic at least for entering numbers.
**2.1.3 (06. Apr 2001/ 03. Dec 2001)**- Visual bugfix when displaying large exponents.
The fancy edition has now coloured buttons. **2.1.2 (31. Mar 2001)**- Kalk splittedd into slim and fancy version.
**2.1.1 (25. Jan 2001)**- removed duplicate /p menu shortcut
**2.0.0 (7. Jul 2000)**- graphical buttons and color support
**1.3.0 (Apr 15 2000)**- clipboard support
**1.2.0 (Mar 08 2000)**- lastX support
**1.1.0 (Oct 05 1999)**- Alternative bases.
**1.0.3 (Sep 23 1999)**- Some new functions, Licence for commerical usage has changed.
**1.0.2 (Jul 18 1999)**- Contact address has changed.
**1.0.1 (Jan 25 1998)**- Bugfix in display handling of engineer mode.
**1.0.0 (Aug 11 1997)**- Double precision!
**0.2.2 (Jul 28 1997)**- Bugfix in display routines
**0.2.0 (Jul 21 1997)**- More math functions, Registers, Degree support.
**0.1.3 (June 24 1997)**- Several Bugfixes. Smaller Keys.
**0.1.2 (May 23 1997)**- Fixed entering of negative exponents.
**0.1.1 (May 10 1997)**- Documentation improved. (No release change in .prc file)
**0.1.0 (May 4 1997)**- Initial public release.
| |||||||||||||||||||

Legalese | |||||||||||||||||||

KALK is Copyright (c) 1997-2006 by Holger Klawitter
Permission to use, copy, modify, and distribute this software and its documentation for any non commerical purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies. For commercial usage, please contact the author. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE AUTHOR HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. | |||||||||||||||||||

## Kalk uses the MathLib library by Rick Hübner:MathLib is a free shared library that can be used by any OS 2.0+ Pilot program that needs IEEE 754 double precision math functions. It's distributed under the terms of the GNU Library General Public License, and is freely available with full source code and documentation at the MathLib Information web page. It's not a part of Kalk; a copy is simply included in this package for your convenience. |

palminfo@klawitter.de Last modified: Thu Jul 13 09:17:38 CEST 2006