calc-vec.el (calc-histogram):
[emacs.git] / lisp / calc / README
blob4b32ada63adb1a0e155d06ba58f621aabfb5687c
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
2   Free Software Foundation, Inc.
3 See the end of the file for license conditions.
6 This directory contains Calc, an advanced desk calculator for GNU
7 Emacs.
9 "Calc"  Copyright (C) 1990, 1991, 1992, 1993, 2001, 2002, 2003, 2004, 
10    2005, 2006, 2007, 2008, 2009, 2010  Free Software Foundation, Inc.
12 Written by:
13         Dave Gillespie
14         c/o Synaptics, Inc.
15         2698 Orchard Parkway
16         San Jose CA 95134
17         daveg@synaptics.com, uunet!synaptx!daveg
19 Currently maintained by:
20      Jay Belanger <jay.p.belanger@gmail.com>
22 From the introduction to the manual:
24   "Calc" is an advanced calculator and mathematical tool that runs as
25   part of the GNU Emacs environment.  Very roughly based on the HP-28/48
26   series of calculators, its many features include:
28     * Choice of algebraic or RPN (stack-based) entry of calculations.
30     * Arbitrary precision integers and floating-point numbers.
32     * Arithmetic on rational numbers, complex numbers (rectangular and
33       polar), error forms with standard deviations, open and closed
34       intervals, vectors and matrices, dates and times, infinities,
35       sets, quantities with units, and algebraic formulas.
37     * Mathematical operations such as logarithms and trigonometric functions.
39     * Programmer's features (bitwise operations, non-decimal numbers).
41     * Financial functions such as future value and internal rate of return.
43     * Number theoretical features such as prime factorization and
44       arithmetic modulo M for any M.
46     * Algebraic manipulation features, including symbolic calculus.
48     * Moving data to and from regular editing buffers.
50     * "Embedded mode" for manipulating Calc formulas and data directly
51       inside any editing buffer.
53     * Graphics using GNUPLOT, a versatile (and free) plotting program.
55     * Easy programming using keyboard macros, algebraic formulas,
56       algebraic rewrite rules, or extended Emacs Lisp.
59 Calc is written entirely in Emacs Lisp, for maximum portability.
61 I am anxious to hear about your experiences using Calc.  Send mail to
62 "jay.p.belanger@gmail.com".  A bug report is most useful if you include the
63 exact input and output that occurred, any modes in effect (such as the
64 current precision), and so on.  If you find Calc is difficult to operate
65 in any way, or if you have other suggestions, don't hesitate to let me
66 know.  If you find errors (including simple typos) in the manual, let
67 me know.  Even if you find no bugs at all I would love to hear your
68 opinions.
72 Summary of changes to "Calc"
73 ------- -- ------- --  ----
75 Emacs 24.1
77 * Gave `calc-histogram' the option of using a vector to determine the bins.
79 * Added "O" option prefix.
81 * Used "O" prefix to "d r" (`calc-radix') to turn on twos-complement mode.
83 Emacs 23.2
85 * Added twos-complement display.
87 Emacs 23.1:
89 * Gave `j *' (cal-sel-mult-both-sides) an option to expand the
90   denominator.
92 * Use `calc-embedded-word-regexp' for finding words in
93   `calc-embedded-word' in place of delimiters.
95 * Remove version numbering; use Emacs version for reference.
97 * Added support for using registers.
99 * Added support for Yacas, Maxima and Giac languages.
101 * Added a menu.
103 * Added logistic non-linear curves to curve-fitting.
105 * Added option of plotting data points and curve when curve-fitting.
107 * Made unit conversions exact when possible.
109 * Lowered the precedence of negation.
111 Version 2.1:
113 * New matrix mode for square matrices.  Improved handling of
114   non-commutative products.
116 * New functions: powerexpand and ldiv.
118 * Added new functions: sec, csc, cot, sech, csch, coth.
120 * 0^0 now evaluates to 1.
122 * Added a new language mode for LaTeX.
124 * Calc now tries to use an appropriate language mode in embedded mode.
126 * Calc now restores original modes when leaving embedded mode.
128 * User settable variables which are not set with keystrokes are now
129   customizable.
131 * Made ~/.calc.el the default Calc settings file.
133 * Miscellaneous updates and bugfixes.
136 Version 2.02f:
138  * Fixed a bug which broke `I', `H', `K' prefix keys in recent Emacs.
140  * Fixed a bug in calc.texinfo which prevented "make tex2" from working.
142  * Updated `C-y' (calc-yank) to understand Emacs 19 generalized kill ring.
144  * Added a copy of "calccard.tex", the Calc quick reference card.
147 Version 2.02e:
149  * Fixed an installation bug caused by recent changes to `write-region'.
152 Version 2.02d:
154  * Fixed a minor installation problem with a Emacs 19.29 byte-compiler bug.
156  * Removed archaic "macedit" package (superseded by "edmacro").
159 Version 2.02c:
161  * Patch to port Calc to Lucid Emacs 19; still works with GNU 18 and GNU 19.
163  * Fixed a bug that broke `C-x C-c' after Calc graphics had been used.
166 Version 2.02b:
168  * Minor patch to port Calc to GNU Emacs 19.  Will be superseded by Calc 3.00.
171 Version 2.02:
173  * Revamped the manual a bit; rearranged some sections.
175  * Added marginal notes for Key/Function Index refs in printed manual.
177  * Changed `M-# r' to deal more gracefully with blank lines.
179  * Made reductions like `V R +' and `M-# :' considerably faster.
181  * Improved parsing and display of cases like "[a + b]".
183  * Added `t +' and `t -' for doing business date arithmetic.
185  * Added "syntax tables," the opposite of compositions.
187  * Added another Rewrites Tutorial exercise.
189  * Added the "vmatches" function.
191  * Added the `Modes' variable and `m g' command.
193  * Improved `u s' to cancel, e.g., "11 mph hr / yd" to get a number.
195  * Added "quick units" commands "u 0" through "u 9".
197  * Moved `M-%' to calc.el to avoid autoloading problems.
199  * Added `M-=' during algebraic entry, acts like `RET ='.
201  * Made `LFD' prevent evaluation when finishing a calc-edit command.
203  * Changed calc-store commands to use `t .' mode for trail display.
205  * Improved integrator to understand forms involving "erf".
207  * Fixed parser to make sense of "[1....1e2]" input.
209  * Fixed FORTRAN parser to treat a(i,j) as a_i_j if a is declared matrix.
211  * Got rid of some version number stamps to reduce size of patches.
213  * Fixed a bug in defmath treating "<=" and ">=" predicates.
215  * Fixed a bug in which Calc crashed multiplying two date forms.
217  * Fixed a bug in line breaker that crashed for large, nested formulas.
219  * Fixed a bug using ` to edit string("foo").
221  * Fixed a bug where `M-# y' in Big mode copied stack level number.
223  * Fixed a bug where `g O' used wrong default directory, no completion.
225  * Fixed a bug where "foo_bar(i)" parsed in C mode but showed as foo#bar.
227  * Fixed several bugs where large calculations got "computation too long."
230 Version 2.01:
232  * Added percentage commands `M-%', `b %', and `c %'.
234  * Changed Big mode to force radix-10 in superscripts.
236  * Improved display of fractions in various language modes.
238  * Changed `a n' to work properly with equations and inequalities.
240  * The problem with cross references to Index nodes in TeX has been fixed.
242  * Fixed a bug where recursive esc-maps make calc-ext/-aent unloadable.
244  * Fixed a bug in `M-# k', then `OFF' right away, with fresh Emacs.
246  * Fixed a bug in which "S_i_j" was formatted wrong after `j s'.
248  * Fixed a bug in which `h k u c' positioned cursor on wrong line.
250  * Fixed a bug where `z ?' crashed if `z %' was defined.
252  * Fixed a bug in `j O' (calc-select-once-maybe).
254  * Fixed "make private" not to ask "Delete excess versions" and crash.
257 Version 2.00:
259  * First complete posting of Calc since 1.01.
261  * Most parts of Calc have seen changes since version 1.07.  See
262    section "New for Calc 2.00" in the manual for a summary.  In
263    the FTP version of the Calc distribution, the file README.prev
264    contains a detailed change history from 1.00 up to 2.00.
267 This file is part of GNU Emacs.
269 GNU Emacs is free software: you can redistribute it and/or modify
270 it under the terms of the GNU General Public License as published by
271 the Free Software Foundation, either version 3 of the License, or
272 (at your option) any later version.
274 GNU Emacs is distributed in the hope that it will be useful,
275 but WITHOUT ANY WARRANTY; without even the implied warranty of
276 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
277 GNU General Public License for more details.
279 You should have received a copy of the GNU General Public License
280 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.