(calcFunc-collect): Normalize the coefficients of the
[bpt/emacs.git] / lisp / calc / README
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
2 Free Software Foundation, Inc.
3 See the end of the file for license conditions.
4
5
6 This directory contains Calc, an advanced desk calculator for GNU
7 Emacs.
8
9 "Calc" Copyright (C) 1990, 1991, 1992, 1993, 2001, 2002, 2003, 2004,
10 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
11
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
18
19 Currently maintained by:
20 Jay Belanger <jay.p.belanger@gmail.com>
21
22 From the introduction to the manual:
23
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:
27
28 * Choice of algebraic or RPN (stack-based) entry of calculations.
29
30 * Arbitrary precision integers and floating-point numbers.
31
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.
36
37 * Mathematical operations such as logarithms and trigonometric functions.
38
39 * Programmer's features (bitwise operations, non-decimal numbers).
40
41 * Financial functions such as future value and internal rate of return.
42
43 * Number theoretical features such as prime factorization and
44 arithmetic modulo M for any M.
45
46 * Algebraic manipulation features, including symbolic calculus.
47
48 * Moving data to and from regular editing buffers.
49
50 * "Embedded mode" for manipulating Calc formulas and data directly
51 inside any editing buffer.
52
53 * Graphics using GNUPLOT, a versatile (and free) plotting program.
54
55 * Easy programming using keyboard macros, algebraic formulas,
56 algebraic rewrite rules, or extended Emacs Lisp.
57
58
59 Calc is written entirely in Emacs Lisp, for maximum portability.
60
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.
69
70
71
72 Summary of changes to "Calc"
73 ------- -- ------- -- ----
74
75 Emacs 23.1:
76
77 * Use `calc-embedded-word-regexp' for finding words in
78 `calc-embedded-word' in place of delimiters.
79
80 * Remove version numbering; use Emacs version for reference.
81
82 * Added support for using registers.
83
84 * Added support for Yacas, Maxima and Giac languages.
85
86 * Added a menu.
87
88 * Added logistic non-linear curves to curve-fitting.
89
90 * Added option of plotting data points and curve when curve-fitting.
91
92 * Made unit conversions exact when possible.
93
94 * Lowered the precedence of negation.
95
96 Version 2.1:
97
98 * New matrix mode for square matrices. Improved handling of
99 non-commutative products.
100
101 * New functions: powerexpand and ldiv.
102
103 * Added new functions: sec, csc, cot, sech, csch, coth.
104
105 * 0^0 now evaluates to 1.
106
107 * Added a new language mode for LaTeX.
108
109 * Calc now tries to use an appropriate language mode in embedded mode.
110
111 * Calc now restores original modes when leaving embedded mode.
112
113 * User settable variables which are not set with keystrokes are now
114 customizable.
115
116 * Made ~/.calc.el the default Calc settings file.
117
118 * Miscellaneous updates and bugfixes.
119
120 \f
121 Version 2.02f:
122
123 * Fixed a bug which broke `I', `H', `K' prefix keys in recent Emacs.
124
125 * Fixed a bug in calc.texinfo which prevented "make tex2" from working.
126
127 * Updated `C-y' (calc-yank) to understand Emacs 19 generalized kill ring.
128
129 * Added a copy of "calccard.tex", the Calc quick reference card.
130
131 \f
132 Version 2.02e:
133
134 * Fixed an installation bug caused by recent changes to `write-region'.
135
136 \f
137 Version 2.02d:
138
139 * Fixed a minor installation problem with a Emacs 19.29 byte-compiler bug.
140
141 * Removed archaic "macedit" package (superseded by "edmacro").
142
143 \f
144 Version 2.02c:
145
146 * Patch to port Calc to Lucid Emacs 19; still works with GNU 18 and GNU 19.
147
148 * Fixed a bug that broke `C-x C-c' after Calc graphics had been used.
149
150 \f
151 Version 2.02b:
152
153 * Minor patch to port Calc to GNU Emacs 19. Will be superseded by Calc 3.00.
154
155 \f
156 Version 2.02:
157
158 * Revamped the manual a bit; rearranged some sections.
159
160 * Added marginal notes for Key/Function Index refs in printed manual.
161
162 * Changed `M-# r' to deal more gracefully with blank lines.
163
164 * Made reductions like `V R +' and `M-# :' considerably faster.
165
166 * Improved parsing and display of cases like "[a + b]".
167
168 * Added `t +' and `t -' for doing business date arithmetic.
169
170 * Added "syntax tables," the opposite of compositions.
171
172 * Added another Rewrites Tutorial exercise.
173
174 * Added the "vmatches" function.
175
176 * Added the `Modes' variable and `m g' command.
177
178 * Improved `u s' to cancel, e.g., "11 mph hr / yd" to get a number.
179
180 * Added "quick units" commands "u 0" through "u 9".
181
182 * Moved `M-%' to calc.el to avoid autoloading problems.
183
184 * Added `M-=' during algebraic entry, acts like `RET ='.
185
186 * Made `LFD' prevent evaluation when finishing a calc-edit command.
187
188 * Changed calc-store commands to use `t .' mode for trail display.
189
190 * Improved integrator to understand forms involving "erf".
191
192 * Fixed parser to make sense of "[1....1e2]" input.
193
194 * Fixed FORTRAN parser to treat a(i,j) as a_i_j if a is declared matrix.
195
196 * Got rid of some version number stamps to reduce size of patches.
197
198 * Fixed a bug in defmath treating "<=" and ">=" predicates.
199
200 * Fixed a bug in which Calc crashed multiplying two date forms.
201
202 * Fixed a bug in line breaker that crashed for large, nested formulas.
203
204 * Fixed a bug using ` to edit string("foo").
205
206 * Fixed a bug where `M-# y' in Big mode copied stack level number.
207
208 * Fixed a bug where `g O' used wrong default directory, no completion.
209
210 * Fixed a bug where "foo_bar(i)" parsed in C mode but showed as foo#bar.
211
212 * Fixed several bugs where large calculations got "computation too long."
213
214 \f
215 Version 2.01:
216
217 * Added percentage commands `M-%', `b %', and `c %'.
218
219 * Changed Big mode to force radix-10 in superscripts.
220
221 * Improved display of fractions in various language modes.
222
223 * Changed `a n' to work properly with equations and inequalities.
224
225 * The problem with cross references to Index nodes in TeX has been fixed.
226
227 * Fixed a bug where recursive esc-maps make calc-ext/-aent unloadable.
228
229 * Fixed a bug in `M-# k', then `OFF' right away, with fresh Emacs.
230
231 * Fixed a bug in which "S_i_j" was formatted wrong after `j s'.
232
233 * Fixed a bug in which `h k u c' positioned cursor on wrong line.
234
235 * Fixed a bug where `z ?' crashed if `z %' was defined.
236
237 * Fixed a bug in `j O' (calc-select-once-maybe).
238
239 * Fixed "make private" not to ask "Delete excess versions" and crash.
240
241 \f
242 Version 2.00:
243
244 * First complete posting of Calc since 1.01.
245
246 * Most parts of Calc have seen changes since version 1.07. See
247 section "New for Calc 2.00" in the manual for a summary. In
248 the FTP version of the Calc distribution, the file README.prev
249 contains a detailed change history from 1.00 up to 2.00.
250
251 \f
252 This file is part of GNU Emacs.
253
254 GNU Emacs is free software: you can redistribute it and/or modify
255 it under the terms of the GNU General Public License as published by
256 the Free Software Foundation, either version 3 of the License, or
257 (at your option) any later version.
258
259 GNU Emacs is distributed in the hope that it will be useful,
260 but WITHOUT ANY WARRANTY; without even the implied warranty of
261 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
262 GNU General Public License for more details.
263
264 You should have received a copy of the GNU General Public License
265 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.