CalConvert for Pilot documentation
Version 1.1 - January 1997 

©1996-97 Alessandro Levi Montalcini
C.so Re Umberto 10
10121 Torino
Italy

mailto:alm@torino.alpcom.it
http://persoweb.francenet.fr/~alm
ftp://ftp.alpcom.it/software/mac/LMontalcini
ftp://ftp.alpcom.it/software/mac/LMontalcini/alm.html

Shareware: $10 cash
  This program is distributed as shareware: if you use it please
honor the shareware system by sending me US $10 cash or the same
amount in your local currency. You may want to fill out the
provided registration form and print it, or you can simply write
down your name, address and email address, specify the version
and name of this program, and stuff everything in an envelope
along with the money. Any comments, suggestions and bug reports
should be sent via email because I only receive my snail mail
every once in a while.

Introduction
  CalConvert for Pilot is a small shareware utility that does
integer arithmetic calculations and converts integer values to
decimal, hexadecimal, octal, binary and to a sequence of four
ASCII characters. The conversion may be signed or unsigned; you
can always enter a signed value, it gets converted to unsigned
if needed. The result can be calculated either as a word (2
bytes) or as a long word (4 bytes). The Return character start
the conversion; tab and the vertical arrow characters move you
from one editing field to another.

Notes
  The binary field is too small to show all the binary digits of
large numbers, so the last ones (least significant ones) are not
displayed. Since the binary format is usually pretty useless
when dealing with large numbers, and since adding code to take
care of it would waste more of your Pilot's precious memory, I
chose not to fix this problem.

The calculator
  You may enter mathematical or logical expressions in the field
labeled "Math", i.e. things like "(12*(128-$20))<<2+2^8"; the
result is shown in all the other fields of the window when you
draw a Return character or click the "=" button. If the
expression can't be parsed correctly, CalConvert beeps and all
the other fields are set to zero. The next paragraphs explain
the syntax and operators you may use in your mathematical
expressions.

Syntax of the math field
  xxx (x=0-9) is a number
  $xxx (x=0-9,A-F) is an hexadecimal number
  -xxx, -$xxx, $-xxx are negative numbers
  '(' and ')' can be used as usual, nesting allowed
  spaces are allowed between numbers and operators
  no spaces are allowed inside numbers or operators
  all numbers are interpreted as 32-bit signed integers

Order of the operators
(operators in the upper lines are calculated first,
operators in the same line are calculated sequentially)
	
   ^   **
   *   /   :   %   <<  >>
   &   |   \   AND OR  XOR
   +   -
   =   ==  !=  <>  <   >   <=  >=

Arithmetic operators

  +     add
  -     subtract
  *     multiply
  /     divide
  :     divide
  %     remainder
  ^     power
  **    power

Logical operators
(return 1 if true, 0 if false)

  =     equal to
  ==    equal to
  !=    not equal to
  <>    not equal to
  <     less than
  >     greater than
  <=    less or equal
  >=    greater or equal

Bitwise operators

  <<    bit shift left
  >>    bit shift right
  &     bit and
  AND   bit and
  and   bit and
  |     bit or
  OR    bit or
  or    bit or
  \     exclusive or
  XOR   exclusive or
  xor   exclusive or

Version history
1.1 - Added support for octal conversions.
1.0 - First public Pilot release.

Distribution
  This software is ©1996-97 Alessandro Levi Montalcini. It can
be freely distributed as long as it is not modified and there's
no charge for it, but it may not be included in any commercial
package without my consent.
  All online services and bulletin boards may make it available
to their users at no charge other than the normal connection
fees.
  All non-profit user groups may distribute it at no charge.
  All magazines may publish it on floppy disk or CD-ROM without
asking me first, as long as I get a copy of the issue containing
my software.
  All CD-ROM shareware collections and CD-ROM magazines may
include it without my prior consent, as long as I get either a
copy of the CD-ROM or an offer to buy the CD-ROM at a discounted
price.
  All redistribution companies such as Pacific HiTech, AMUG,
Celestin or Educorp may distribute it, as long as I get a copy
of each media containing my software and a catalog of the
company's offerings (where applicable).
  You may find the latest version of all my Macintosh and Pilot
shareware and freeware programs by anonymous ftp to
ftp.alpcom.it, inside the /software/mac/LMontalcini directory.
The ALM Share and ALM Free packages, which contain most of my
Mac stuff and can be registered at a very low price, are also
available there.

Disclaimer
  This software should never cause any damage, but you're using
it at your own risk. As an independent software developer, I can
make no warranties whatsoever on it.

Have fun! And don't forget to register your shareware, so that
more cool inexpensive utilities can see the light in the future.