;;; calc-misc.el --- miscellaneous functions for Calc
;; Copyright (C) 1990, 1991, 1992, 1993, 2001, 2002, 2003, 2004
-;; 2005 Free Software Foundation, Inc.
+;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
;; Author: David Gillespie <daveg@synaptics.com>
-;; Maintainer: Jay Belanger <belanger@truman.edu>
+;; Maintainer: Jay Belanger <jay.p.belanger@gmail.com>
;; This file is part of GNU Emacs.
+;; GNU Emacs is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
;; GNU Emacs is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY. No author or distributor
-;; accepts responsibility to anyone for the consequences of using it
-;; or for whether it serves any particular purpose or works at all,
-;; unless he says so in writing. Refer to the GNU Emacs General Public
-;; License for full details.
-
-;; Everyone is granted permission to copy, modify and redistribute
-;; GNU Emacs, but only under the conditions described in the
-;; GNU Emacs General Public License. A copy of this license is
-;; supposed to have been given to you along with GNU Emacs so you
-;; can know your rights and responsibilities. It should be in a
-;; file named COPYING. Among other things, the copyright notice
-;; and this notice must be preserved on all copies.
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
(require 'calc)
(require 'calc-macs)
+;; Declare functions which are defined elsewhere.
+(declare-function calc-do-keypad "calc-keypd" (&optional full-display interactive))
+(declare-function calc-inv-hyp-prefix-help "calc-help" ())
+(declare-function calc-inverse-prefix-help "calc-help" ())
+(declare-function calc-hyperbolic-prefix-help "calc-help" ())
+(declare-function calc-explain-why "calc-stuff" (why &optional more))
+(declare-function calc-clear-command-flag "calc-ext" (f))
+(declare-function calc-roll-down-with-selections "calc-sel" (n m))
+(declare-function calc-roll-up-with-selections "calc-sel" (n m))
+(declare-function calc-last-args "calc-undo" (n))
+(declare-function calc-is-inverse "calc-ext" ())
+(declare-function calc-do-prefix-help "calc-ext" (msgs group key))
+(declare-function math-objvecp "calc-ext" (a))
+(declare-function math-known-scalarp "calc-arith" (a &optional assume-scalar))
+(declare-function math-vectorp "calc-ext" (a))
+(declare-function math-matrixp "calc-ext" (a))
+(declare-function math-trunc-special "calc-arith" (a prec))
+(declare-function math-trunc-fancy "calc-arith" (a))
+(declare-function math-floor-special "calc-arith" (a prec))
+(declare-function math-floor-fancy "calc-arith" (a))
+(declare-function math-square-matrixp "calc-ext" (a))
+(declare-function math-matrix-inv-raw "calc-mtx" (m))
+(declare-function math-known-matrixp "calc-arith" (a))
+(declare-function math-mod-fancy "calc-arith" (a b))
+(declare-function math-pow-of-zero "calc-arith" (a b))
+(declare-function math-pow-zero "calc-arith" (a b))
+(declare-function math-pow-fancy "calc-arith" (a b))
+
+
+;;;###autoload
(defun calc-dispatch-help (arg)
"C-x* is a prefix key sequence; follow it with one of these letters:
(calc-do-dispatch arg))))
+;;;###autoload
(defun calc-big-or-small (arg)
"Toggle Calc between full-screen and regular mode."
(interactive "P")
"Now using full screen for Calc"
"Now using partial screen for Calc"))))
+;;;###autoload
(defun calc-other-window (&optional interactive)
"Invoke the Calculator in another window."
(interactive "p")
(let ((win (selected-window)))
(calc nil win interactive)))))
+;;;###autoload
(defun another-calc ()
"Create another, independent Calculator buffer."
(interactive)
(if (eq major-mode 'calc-mode)
- (mapcar (function
- (lambda (v)
- (set-default v (symbol-value v)))) calc-local-var-list))
+ (mapc (function
+ (lambda (v)
+ (set-default v (symbol-value v)))) calc-local-var-list))
(set-buffer (generate-new-buffer "*Calculator*"))
(pop-to-buffer (current-buffer))
(calc-mode))
+;;;###autoload
(defun calc-info ()
"Run the Emacs Info system on the Calculator documentation."
(interactive)
(select-window (get-largest-window))
(info "Calc"))
+;;;###autoload
(defun calc-info-goto-node (node)
"Go to a node in the Calculator info documentation."
(interactive)
(select-window (get-largest-window))
(info (concat "(Calc)" node)))
+;;;###autoload
(defun calc-tutorial ()
"Run the Emacs Info system on the Calculator Tutorial."
(interactive)
(calc-other-window)
(message "Welcome to the Calc Tutorial!"))
+;;;###autoload
(defun calc-info-summary ()
"Run the Emacs Info system on the Calculator Summary."
(interactive)
(calc-info-goto-node "Summary"))
+;;;###autoload
(defun calc-help ()
(interactive)
(let ((msgs (append
;; and used in calc-why (in calc-stuff.el).
(defvar calc-last-why-command)
+;;;###autoload
(defun calc-do-handle-whys ()
(setq calc-why (sort calc-next-why
(function
(setq calc-last-why-command this-command)
(calc-clear-command-flag 'clear-message))))
+;;;###autoload
(defun calc-record-why (&rest stuff)
(if (eq (car stuff) 'quiet)
(setq stuff (cdr stuff))
(setq calc-next-why (cons stuff calc-next-why))
nil)
-;;; True if A is a constant or vector of constants. [P x] [Public]
+;; True if A is a constant or vector of constants. [P x] [Public]
+;;;###autoload
(defun math-constp (a)
(or (Math-scalarp a)
(and (memq (car a) '(sdev intv mod vec))
(null a)))))
+;;;###autoload
(defun calc-roll-down-stack (n &optional m)
(if (< n 0)
(calc-roll-up-stack (- n) m)
(append (calc-top-list m 1)
(calc-top-list (- n m) (1+ m))))))))
+;;;###autoload
(defun calc-roll-up-stack (n &optional m)
(if (< n 0)
(calc-roll-down-stack (- n) m)
(calc-top-list m (- n m -1))))))))
+;;;###autoload
(defun calc-do-refresh ()
(if calc-hyperbolic-flag
(progn
t))
+;;;###autoload
(defun calc-record-list (vals &optional prefix)
(while vals
(or (eq (car vals) 'top-of-stack)
(setq vals (cdr vals))))
+;;;###autoload
(defun calc-last-args-stub (arg)
(interactive "p")
(require 'calc-ext)
(calc-last-args arg))
+;;;###autoload
(defun calc-power (arg)
(interactive "P")
(calc-slow-wrapper
(calc-binary-op "root" 'calcFunc-nroot arg nil nil)
(calc-binary-op "^" 'calcFunc-pow arg nil nil '^))))
+;;;###autoload
(defun calc-mod (arg)
(interactive "P")
(calc-slow-wrapper
(calc-binary-op "%" 'calcFunc-mod arg nil nil '%)))
+;;;###autoload
(defun calc-inv (arg)
(interactive "P")
(calc-slow-wrapper
(calc-unary-op "inv" 'calcFunc-inv arg)))
+;;;###autoload
(defun calc-percent ()
(interactive)
(calc-slow-wrapper
1 "%" (list (list 'calcFunc-percent (calc-top-n 1))))))
+;;;###autoload
(defun calc-over (n)
(interactive "P")
(if n
(calc-enter -2)))
+;;;###autoload
(defun calc-pop-above (n)
(interactive "P")
(if n
(calc-pop (- (prefix-numeric-value n)))
(calc-pop -2)))
+;;;###autoload
(defun calc-roll-down (n)
(interactive "P")
(calc-wrapper
(t
(calc-roll-down-stack (calc-stack-size) (- nn)))))))
+;;;###autoload
(defun calc-roll-up (n)
(interactive "P")
(calc-wrapper
;;; Other commands.
+;;;###autoload
(defun calc-num-prefix-name (n)
(cond ((eq n '-) "- ")
((equal n '(4)) "C-u ")
((integerp n) (format "%d " n))
(t "")))
+;;;###autoload
(defun calc-missing-key (n)
"This is a placeholder for a command which needs to be loaded from calc-ext.
When this key is used, calc-ext (the Calculator extensions module) will be
(calc-unread-command)
(setq prefix-arg n))
+;;;###autoload
(defun calc-shift-Y-prefix-help ()
(interactive)
(require 'calc-ext)
+;;;###autoload
(defun calcDigit-letter ()
(interactive)
(if (calc-minibuffer-contains "[-+]?\\(1[1-9]\\|[2-9][0-9]\\)#.*")
;; A Lisp version of temp_minibuffer_message from minibuf.c.
+;;;###autoload
(defun calc-temp-minibuffer-message (m)
(let ((savemax (point-max)))
(save-excursion
(put 'math-with-extra-prec 'lisp-indent-hook 1)
-;;; Concatenate two vectors, or a vector and an object. [V O O] [Public]
+;; Concatenate two vectors, or a vector and an object. [V O O] [Public]
+;;;###autoload
(defun math-concat (v1 v2)
(if (stringp v1)
(concat v1 v2)
(list '| v1 v2))))
-;;; True if A is zero. Works for un-normalized values. [P n] [Public]
+;; True if A is zero. Works for un-normalized values. [P n] [Public]
+;;;###autoload
(defun math-zerop (a)
(if (consp a)
(cond ((memq (car a) '(bigpos bigneg))
(eq a 0)))
-;;; True if A is real and negative. [P n] [Public]
+;; True if A is real and negative. [P n] [Public]
+;;;###autoload
(defun math-negp (a)
(if (consp a)
(cond ((eq (car a) 'bigpos) nil)
((equal a '(neg (var inf var-inf))) t))
(< a 0)))
-;;; True if A is a negative number or an expression the starts with '-'.
+;; True if A is a negative number or an expression the starts with '-'.
+;;;###autoload
(defun math-looks-negp (a) ; [P x] [Public]
(or (Math-negp a)
(eq (car-safe a) 'neg)
(math-looks-negp (nth 1 a)))))
-;;; True if A is real and positive. [P n] [Public]
+;; True if A is real and positive. [P n] [Public]
+;;;###autoload
(defun math-posp (a)
(if (consp a)
(cond ((eq (car a) 'bigpos) (cdr a))
((equal a '(var inf var-inf)) t))
(> a 0)))
+;;;###autoload
(defalias 'math-fixnump 'integerp)
+;;;###autoload
(defalias 'math-fixnatnump 'natnump)
-;;; True if A is an even integer. [P R R] [Public]
+;; True if A is an even integer. [P R R] [Public]
+;;;###autoload
(defun math-evenp (a)
(if (consp a)
(and (memq (car a) '(bigpos bigneg))
(= (% (nth 1 a) 2) 0))
(= (% a 2) 0)))
-;;; Compute A / 2, for small or big integer A. [I i]
-;;; If A is negative, type of truncation is undefined.
+;; Compute A / 2, for small or big integer A. [I i]
+;; If A is negative, type of truncation is undefined.
+;;;###autoload
(defun math-div2 (a)
(if (consp a)
(if (cdr a)
0)
(/ a 2)))
+;;;###autoload
(defun math-div2-bignum (a) ; [l l]
(if (cdr a)
- (cons (+ (/ (car a) 2) (* (% (nth 1 a) 2) 500))
+ (cons (+ (/ (car a) 2) (* (% (nth 1 a) 2) (/ math-bignum-digit-size 2)))
(math-div2-bignum (cdr a)))
(list (/ (car a) 2))))
-;;; Reject an argument to a calculator function. [Public]
+;; Reject an argument to a calculator function. [Public]
+;;;###autoload
(defun math-reject-arg (&optional a p option)
(if option
(calc-record-why option p a)
(signal 'wrong-type-argument (and a (if p (list p a) (list a)))))
-;;; Coerce A to be an integer (by truncation toward zero). [I N] [Public]
+;; Coerce A to be an integer (by truncation toward zero). [I N] [Public]
;; The variable math-trunc-prec is local to math-trunc, but used by
;; math-trunc-fancy in calc-arith.el, which is called by math-trunc.
+;;;###autoload
(defun math-trunc (a &optional math-trunc-prec)
(cond (math-trunc-prec
(require 'calc-ext)
(math-scale-int (nth 1 a) (nth 2 a)))
(t (require 'calc-ext)
(math-trunc-fancy a))))
+;;;###autoload
(defalias 'calcFunc-trunc 'math-trunc)
-;;; Coerce A to be an integer (by truncation toward minus infinity). [I N]
+;; Coerce A to be an integer (by truncation toward minus infinity). [I N]
;; The variable math-floor-prec is local to math-floor, but used by
;; math-floor-fancy in calc-arith.el, which is called by math-floor.
+;;;###autoload
(defun math-floor (a &optional math-floor-prec) ; [Public]
(cond (math-floor-prec
(require 'calc-ext)
(math-trunc a)))
(t (require 'calc-ext)
(math-floor-fancy a))))
+;;;###autoload
(defalias 'calcFunc-floor 'math-floor)
+;;;###autoload
(defun math-imod (a b) ; [I I I] [Public]
(if (and (not (consp a)) (not (consp b)))
(if (= b 0)
(cdr (math-idivmod a b))))
+;;;###autoload
(defun calcFunc-inv (m)
(if (Math-vectorp m)
(progn
(math-pow m -1)
(math-div 1 m))))
+;;;###autoload
(defun math-do-working (msg arg)
(or executing-kbd-macro
(progn
(math-showing-full-precision (math-format-number arg))))))
-;;; Compute A modulo B, defined in terms of truncation toward minus infinity.
+;; Compute A modulo B, defined in terms of truncation toward minus infinity.
+;;;###autoload
(defun math-mod (a b) ; [R R R] [Public]
(cond ((and (Math-zerop a) (not (eq (car-safe a) 'mod))) a)
((Math-zerop b)
;;; General exponentiation.
+;;;###autoload
(defun math-pow (a b) ; [O O N] [Public]
(cond ((equal b '(var nan var-nan))
b)
(require 'calc-ext)
(math-pow-fancy a b))))
+;;;###autoload
(defun math-ipow (a n) ; [O O I] [Public]
(cond ((Math-integer-negp n)
(math-ipow (math-div 1 a) (Math-integer-neg n)))
val))
+;;;###autoload
(defun math-read-radix-digit (dig) ; [D S; Z S]
(if (> dig ?9)
(if (< dig ?A)
;;; Bug reporting
+;;;###autoload
(defun report-calc-bug ()
"Report a bug in Calc, the GNU Emacs calculator.
Prompts for bug subject. Leaves you in a mail buffer."
precise symptoms of the bug. If possible, include a backtrace by
doing 'M-x toggle-debug-on-error', then reproducing the bug.
" )))
+;;;###autoload
(defalias 'calc-report-bug 'report-calc-bug)
(provide 'calc-misc)
-;;; arch-tag: 7984d9d0-62e5-41dc-afb8-e904b975f250
+;; Local variables:
+;; generated-autoload-file: "calc-loaddefs.el"
+;; End:
+
+;; arch-tag: 7984d9d0-62e5-41dc-afb8-e904b975f250
;;; calc-misc.el ends here