
This tar file contains version 1.04 of Calc, an advanced desk
calculator for GNU Emacs.

"Calc"  Copyright 1990  Dave Gillespie
                        256-80 Caltech
                        Pasadena CA 91125
                        daveg@csvax.cs.caltech.edu, cit-vax!daveg



From the Introduction to the manual:

  "Calc" is an advanced calculator and mathematical tool that runs as
  part of the GNU Emacs environment.  Very roughly based on the HP-28/48
  series of calculators, its many features include:

    * Choice of algebraic or RPN style entry of calculations.
 
    * Arbitrary precision integers and floating-point numbers.
 
    * Arithmetic on rational numbers, complex numbers (rectangular and polar),
      error forms with standard deviations, open and closed intervals, vectors
      and matrices, quantities with units, and simple algebraic expressions.
 
    * Mathematical operations such as logarithms and trig functions.
 
    * Programmer's features (bitwise operations, non-decimal integers).
 
    * Number theoretical features such as prime factorization and arithmetic
      modulo M for any M.
 
    * Algebraic manipulation features, including symbolic calculus.
 
    * Kill and yank to and from regular editing buffers.
 
    * Easy programming using keyboard macros, algebraic formulas,
      algebraic rewrite rules, or Lisp code.



To install Calc:

  1. Create a directory for Calc
  2. "cd" to that directory
  3. Place calc-1.04.tar.Z in the directory (be sure to ftp it in binary mode)
  4. Type "uncompress calc-1.04.tar.Z"
  5. Type "tar xvf calc-1.04.tar"
4,5. Alternatively: "zcat calc1.04.tar.Z | tar xvf -"
  6. Follow the instructions in the file "INSTALL".



The files contained in this tar file are:

  README		This very file.

  INSTALL		Installation instructions (excerpted from the manual).

  calc.el		The main source file.  This contains just the basic
			arithmetic functions, and is kept small for fast
			loading.  130K.

  calc-ext.el		The rest of the Calculator source.  This file is
			auto-loaded the first time you use an advanced Calc
			command.  473K.

  calc.elc		The byte-compiled version of Calc.  You can make
  calc-ext.elc		these yourself from calc.el and calc-ext.el if you
			prefer; use the M-x byte-compile-file command.
			(Not available in shar distribution; 84K + 358K.)

  calc.texinfo  	Documentation for Calc.  This can be turned into
			a printed manual and also into on-line help.  474K.
			Beware: printed, this is over 200 pages!

  macedit.el		A handy utility for editing keyboard macros; good
			for using Calc as a programmable calculator.  19K.


Calc is written entirely in Emacs Lisp, for maximum portability.
You do not need to recompile Emacs to install and use Calc.

You will need about two megabytes of disk space to hold Calc with
its Info documentation.

See the file INSTALL for installation instructions.  If you're impatient,
use `M-x load-file' to load `calc.elc' and `calc-ext.elc', then type
`M-x calc' to run the Calculator.  Type `?' for help; read `calc.texinfo'
for the complete documentation.

Don't even try to run Calc in uncompiled (.el) form!  It's far too slow.


I am anxious to hear about your experiences using Calc.  Send mail to
"daveg@csvax.cs.caltech.edu", or "cit-vax!daveg".  A bug report is most
useful if you include the exact input and output that occurred, any
modes in effect (such as the current precision), and so on.  If you
find Calc is difficult to operate in any way, or if you have other
suggestions, don't hesitate to let me know.  If you find errors
(including simple typos) in the manual, let me know.  Even if you find
no bugs at all I would love to hear your opinions.

The latest Calc tar files and patches are available for anonymous FTP on
csvax.cs.caltech.edu [131.215.131.131].  Look in the "pub" subdirectory.

Thanks,

								-- Dave





Summary of changes to "Calc"
------- -- ------- --  ----

Version 1.04:

 * Included a copy of revision history (from README) in calc.el.

 * Added the "calc-split" feature to split calc-ext.el into smaller bits.

 * Changed calc-unpack to unpack floats and fractions, too.

 * Added "mant", "xpon", and "scf" functions for decomposing floats.

 * Fixed a bug in the "y" command with positive prefix arguments.

 * Rearranged binary shift/rotate command keys to be a bit more convenient.

 * Fixed a bug in which simplifying "(0/0) * 2" crashed with a Lisp error.

 * Made `H F' [ffloor] and friends faster for very large arguments.

 * Made calc-define-del more robust.

 * Handled pasting of data into the Calculator using the mouse under X.

 * Made overlay-arrow variables buffer-local to avoid interference.

 * Fixed a problem in which Calc Trail buffer got stuck after a C-x C-w.


Version 1.03:

 * Changed math-choose to compute n-choose-m faster when m is large.

 * Fixed some problems with TeX mode.

 * Fixed a bug that prevented `b s' from working without a prefix argument.

 * Added "calc-eval" function.

 * Improved calc-grab-region.


Version 1.02:

 * Fixed a bug in Tutorial: telephone pole height/distance were switched!

 * Fixed a few other things in the manual.

 * Added "full-calc" command.

 * Added "calc-insert-variables" (`Z I') command.

 * Quick Calc now works even if you are already in the minibuffer.

 * Fixed a bug in math-mul-bignum-digit which affected math-and, etc.

 * Definition of "Hectares" was wrong in units table.

 * Fixed a bug in calc-execute-kbd-macro concerning undo and refresh.

 * Bound "calc-undo" to `C-x u' as well as `C-_' and `U'.

Version 1.01:

 * Added a tutorial section to the manual.

 * Next and Prev for node Strings in the manual were reversed; fixed.

 * Changed "'bignum" in calc-isqrt-bignum-iter to "'bigpos".

 * Fixed a bug that prevented "$" from working during algebraic entry.

 * Fixed a bug caused by an X (last-X) command following a K (macro) cmd.

 * Fixed a bug in which K command incorrectly formatted stack in Big mode.

 * Added space between unary operators and non-flat compositions.
   (Otherwise, "-(a/b)" in Big mode blended the minus sign into the rule!)

 * Fixed formatting of (-1)^n in Big mode.

 * Fixed some problems relating to "not" operator in Pascal language mode.

 * Fixed several bugs relating to V M ' and V M $ sequences.

 * Fixed matrix-vector multiplication to produce a vector.

 * Introduced Z ` ... Z ' commands; renamed old Z ' to Z #.

 * Fixed various other bugs.

 * Added calc-settings-file variable suggested by C. Witty.


Version 1.00:

 * First official release of Calc.

 * If you used the Beta test version (0.01), you will find that this
   version of Calc is over 50% larger than the original release.
   General areas of improvement include much better algebra features;
   operations on units; language modes; simplification modes; interval
   arithmetic; vector mapping and reduction.  Other new commands include
   calc-fraction and calc-grab-region.  The program has been split into
   two parts for faster loading, and the manual is more complete.

