| blob | 911583bd5d023caa80788ba4238bb23dea44765e |
1 .\"
2 .\" Copyright (C) 1999-2007 Landon Curt Noll
3 .\"
4 .\" Calc is open software; you can redistribute it and/or modify it under
5 .\" the terms of the version 2.1 of the GNU Lesser General Public License
6 .\" as published by the Free Software Foundation.
7 .\"
8 .\" Calc is distributed in the hope that it will be useful, but WITHOUT
9 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
10 .\" or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
11 .\" Public License for more details.
12 .\"
13 .\" A copy of version 2.1 of the GNU Lesser General Public License is
14 .\" distributed with calc under the filename COPYING-LGPL. You should have
15 .\" received a copy with calc; if not, write to Free Software Foundation, Inc.
16 .\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17 .\"
18 .\" @(#) $Revision: 30.5 $
19 .\" @(#) $Id: calc.man,v 30.5 2013/08/11 08:41:38 chongo Exp $
20 .\" @(#) $Source: /usr/local/src/bin/calc/RCS/calc.man,v $
21 .\"
22 .\" Under source code control: 1991/07/23 05:48:26
23 .\" File existed as early as: 1991
24 .\"
25 .\" chongo <was here> /\oo/\ http://www.isthe.com/chongo/
26 .\" Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/
27 .\"
28 .\" calculator by David I. Bell
29 .\" man page by Landon Noll
30 .\"
31 .TH calc 1 "^..^" "2007-02-06"
32 .SH NAME
33 calc \- arbitrary precision calculator
34 .SH SYNOPSIS
35 \fIcalc\fP
36 .RB [ \-c ]
37 .RB [ \-C ]
38 .RB [ \-d ]
39 .br
40 .in +5n
41 .RB [ -D\ \&calc_debug[:resource_debug[:user_debug]] ]
42 .br
43 .RB [ \-e ]
44 .RB [ \-h ]
45 .RB [ \-i ]
46 .RB [ \-m\ \&mode ]
47 .RB [ \-O ]
48 .br
49 .RB [ \-p ]
50 .RB [ \-q ]
51 .RB [ \-s ]
52 .RB [ \-u ]
53 .RB [ \-v ]
54 .RB [ [\-\-]\ calc_cmd\ \&.\|.\|. ]
55 .in -5n
56 .sp
57 \fI#!${BINDIR}/calc\fP\ [other_flags\ \&...] \fB\-f\fP
58 .SH DESCRIPTION
59 \&
60 .br
61 CALC OPTIONS
62 .PP
64 .TP
65 .B \-c
66 Continue reading command lines even after a scan/parse
67 error has caused the abandonment of a line.
68 Note that this option only deals with scanning and
69 parsing of the calc language.
70 It does not deal with execution or run-time errors.
71 .sp 1
72 For example:
73 .sp 1
74 .in +5n
75 .nf
76 calc read many_errors.cal
77 .fi
78 .in -5n
79 .sp 1
80 will cause
81 .B calc
82 to abort on the first syntax error, whereas:
83 .sp 1
84 .in +5n
85 .nf
86 calc -c read many_errors.cal
87 .fi
88 .in -5n
89 .sp 1
90 will
91 cause
92 .B calc
93 to try to process each line being read
94 despite the scan/parse errors that it encounters.
95 .sp 1
96 By default, calc startup resource files are silently
97 ignored if not found.
98 This flag will report missing
99 startup resource files unless
100 .B \-d
101 is also given.
103 .TP
104 .B \-C
105 Permit the execution of custom builtin functions.
106 Without
107 this flag, calling the custom() builtin function will
108 simply generate an error.
109 .sp 1
110 Use of this flag may cause
111 .B calc
112 to execute functions
113 that are non-standard and that are not portable. Custom builtin
114 functions are disabled by default for this reason.
116 .TP
117 .B \-d
118 Disable the printing of the opening title. The printing
119 of resource file debug and informational messages is also disabled
120 as if \fBconfig("resource_debug", 0)\fP had been executed.
121 .sp 1
122 For example:
123 .sp 1
124 .in +5n
125 calc "read qtime; qtime(2)"
126 .in -5n
127 .sp 1
128 will output something like:
129 .sp 1
130 .in +5n
131 .nf
132 qtime(utc_hr_offset) defined
133 It's nearly ten past six.
134 .fi
135 .in -5n
136 .sp 1
137 whereas:
138 .sp 1
139 .in +5n
140 .nf
141 calc -d "read qtime; qtime(2)"
142 .fi
143 .in -5n
144 .sp 1
145 will just say:
146 .sp 1
147 .in +5n
148 .nf
149 It's nearly ten past six.
150 .fi
151 .in -5n
152 .sp 1
153 This flag disables the reporting of missing calc
154 startup resource files.
156 .TP
157 .BR -D " calc_debug[:resource_debug[:user_debug]]"
158 Force the initial value of config("calc_debug"),
159 config("resource_debug") and config("user_debug").
160 .sp 1
161 The : separated strings are interpreted as signed 32 bit integers.
162 After an optional leading sign a leading zero indicates octal
163 conversion, and a leading ``0x'' or ``0X'' hexadecimal
164 conversion. Otherwise, decimal conversion is assumed.
165 .sp 1
166 By default,
167 .I calc_debug
168 is 0,
169 .I resource_debug
170 is 3 and
171 .I user_debug
172 is 0.
173 .sp 1
174 For more information use the following
175 .B calc
176 command:
177 .sp 1
178 .in +5n
179 .nf
180 help config
181 .fi
182 .in -5n
184 .TP
185 .B \-e
186 Ignore any environment variables on startup.
187 The getenv() builtin will still return values, however.
189 .TP
190 .B \-f
191 This flag is required when using calc in
192 .BR "shell script mode" .
193 It must be at the end of the initial
194 .B #!
195 line of the script.
196 .sp 1
197 This flag is normally only at the end of a calc shell script.
198 If the first line of an executable file begins
199 .B #!
200 followed by the absolute pathname of the
201 .B calc
202 program and the flag
203 .B \-f
204 as in:
205 .sp 1
206 .in +5n
207 .nf
208 \fI#!${BINDIR}/calc\fP\ [other_flags\ \&...] \fB\-f\fP
209 .fi
210 .in -5n
211 .sp 1
212 the rest of the file will be processed in
213 .BR "shell script mode" .
214 See
215 .B "SHELL SCRIPT MODE"
216 section of this man page
217 below for details.
218 .sp 1
219 The actual form of this flag is:
220 .sp 1
221 .in +5n
222 .B \-f
223 filename
224 .in -5n
225 .sp 1
226 On systems that treat an executable that begins with
227 .B #!
228 as a script, the path of the executable is appended by the kernel
229 as the final argument to the exec() system call.
230 This is why the
231 .B \-f
232 flag at the very end of the
233 .B #!
234 line.
235 .sp 1
236 It is possible use
237 .B \-f\ filename
238 on the command line:
239 .sp 1
240 .in +5n
241 .nf
242 \fIcalc\fP\ [other_flags\ \&...] \fB\-f\fP filename
243 .fi
244 .in -5n
245 .sp 1
246 This will cause calc to process lines in
247 .B filename
248 in
249 .BR "shell script mode" .
250 .sp 1
251 Use of
252 .B \-f
253 implies
254 .BR \-s .
255 In addition,
256 .B \-d
257 and
258 .B \-p
259 are implied if
260 .B \-i
261 is not given.
263 .TP
264 .B \-h
265 Print a help message. This option implies
266 .BR \-q .
267 This
268 is equivalent to the
269 .B calc
270 command help help.
271 The help facility is disabled unless the mode is 5 or 7.
272 See
273 .BR \-m .
275 .TP
276 .B \-i
277 Become interactive if possible.
278 This flag will cause
279 .B calc
280 to drop into interactive mode after the
281 .I calc_cmd
282 arguments on the command line are evaluated.
283 Without this flag,
284 .B calc
285 will exit after they are evaluated.
286 .sp 1
287 For example:
288 .sp 1
289 .in +5n
290 .nf
291 calc 2+5
292 .fi
293 .in -5n
294 .sp 1
295 will print the value 7 and exit whereas:
296 .sp 1
297 .in +5n
298 .nf
299 calc -i 2+5
300 .fi
301 .in -5n
302 .sp 1
303 will print the value 7 and prompt the user for more
304 .B calc
305 commands.
307 .TP
308 .BR \-m " mode"
309 This flag sets the permission mode of
310 .BR calc .
311 It controls the ability for
312 .B calc
313 to open files and execute programs.
314 .I Mode
315 may be a number from 0 to 7.
316 .sp 1
317 The mode value is interpreted in a way similar to that
318 of the
319 .BR chmod (1)
320 octal mode:
321 .sp 1
322 .in +5n
323 .nf
324 0 do not open any file, do not execute progs
325 1 do not open any file
326 2 do not open files for reading, do not execute progs
327 3 do not open files for reading
328 4 do not open files for writing, do not execute progs
329 5 do not open files for writing
330 6 do not execute any program
331 7 allow everything (default mode)
332 .fi
333 .in -5n
334 .sp 1
335 If one wished to run
336 .B calc
337 from a privileged user, one might want to use
338 .BR \-m " 0"
339 in an effort to make
340 .B calc
341 somewhat more secure.
342 .sp 1
343 Mode bits for reading and writing apply only on an
344 open.
345 Files already open are not effected.
346 Thus if one wanted to use the
347 .BR \-m " 0"
348 in an effort to make
349 .B calc
350 somewhat more secure, but still wanted to read and write a specific
351 file, one might want to do in
352 .BR sh (1),
353 .BR ksh (1),
354 .BR bash (1)-like
355 shells:
356 .sp 1
357 .in +5n
358 .nf
359 calc -m 0 3<a.file
360 .fi
361 .in -5n
362 .sp 1
363 Files presented to
364 .B calc
365 in this way are opened in an
366 unknown mode.
367 .B Calc
368 will attempt to read or write them if directed.
369 .sp 1
370 If the mode disables opening of files for reading, then
371 the startup resource files are disabled as if
372 .B \-q
373 was given.
374 The reading of key bindings is also disabled
375 when the mode disables opening of files for reading.
377 .TP
378 .B \-O
379 Use the old classic defaults instead of the
380 default configuration.
381 This flag as the same effect
382 as executing \fBconfig("all", "oldcfg")\fP at startup time.
383 .sp 1
384 NOTE: Older versions of calc used
385 .B \-n
386 to setup a modified form of the default calc configuration.
387 The
388 .B \-n
389 flag currently does nothing.
390 Use of the
391 .B \-n
392 flag is now deprecated and may be used for
393 something else in the future.
395 .TP
396 .B \-p
397 Pipe processing is enabled by use of
398 .BR \-p .
399 For example:
400 .sp 1
401 .in +5n
402 .nf
403 calc -p "2^21701-1" | fizzbin
404 .fi
405 .in -5n
406 .sp 1
407 In pipe mode,
408 .B calc
409 does not prompt, does not print leading
410 tabs and does not print the initial header.
411 The
412 .B \-p
413 flag overrides
414 .BR \-i .
416 .TP
417 .B \-q
418 Disable the reading of the startup scripts.
420 .TP
421 .B \-s
422 By default, all
423 .I calc_cmd
424 args are evaluated and executed.
425 This flag will disable their evaluation and instead make
426 them available as strings for the argv() builtin function.
428 .TP
429 .B \-u
430 Disable buffering of stdin and stdout.
432 .TP
433 .B \-v
434 Print the
435 .B calc
436 version number and exit.
438 .TP
439 .B \-\-
440 The double dash indicates to calc that no more option follow.
441 Thus calc will ignore a later argument on the command line
442 even if it starts with a dash.
443 This is useful when entering negative values on the command line as in:
444 .sp 1
445 .in +5n
446 .nf
447 calc \-p \-\- \-1 - -7
448 .sp 1
449 .fi
450 .in -5n
452 .PP
454 \&
455 .br
456 CALC COMMAND LINE
457 .PP
458 With no
459 .I calc_cmd
460 arguments,
461 .B calc
462 operates interactively.
463 If one or more
464 arguments are given on the command line and
465 .B \-s
466 is NOT given, then
467 .B calc
468 will read and execute them and either attempt
469 to go interactive according as the
470 .B \-i
471 flag was present or absent.
472 .sp
473 If
474 .B \-s
475 is given,
476 .B calc
477 will not evaluate any
478 .I calc_cmd
479 arguments but instead make them available
480 as strings to the argv() builtin function.
482 Sufficiently simple commands with no no characters like
483 parentheses, brackets, semicolons, '*', which have special
484 interpretations in UNIX shells may be entered, possibly with
485 spaces, until the terminating newline.
486 For example:
487 .sp 1
488 .in +5n
489 .nf
490 calc 23 + 47
491 .fi
492 .in -5n
493 .sp 1
494 will print 70.
495 However, command lines will have problems:
496 .sp 1
497 .in +5n
498 .nf
499 calc 23 * 47
500 .sp 1
501 calc -23 + 47
502 .fi
503 .in -5n
504 .sp 1
505 The first example above fails because the shell interprets the '*'
506 as a file glob.
507 The second example fails because '\-23' is viewed as a calc option
508 (which it is not) and do calc objects to that it thinks of as an unknown option.
509 These cases can usually be made to work as expected by
510 enclosing the command between quotes:
511 .sp 1
512 .in +5n
513 .nf
514 calc '23 * 47'
515 .sp 1
516 calc "print sqrt(2), exp(1)"
517 .fi
518 .in -5n
519 .sp 1
520 or in parentheses and quotes to avoid leading \-'s as in:
521 .sp 1
522 .in +5n
523 .nf
524 calc '(-23 + 47)'
525 .fi
526 .in -5n
527 .sp 1
528 One may also use a double dash to denote that calc options have ended as in:
529 .sp 1
530 .in +5n
531 .nf
532 calc -- -23 + 47
533 .sp 1
534 calc -q -- -23 + 47
535 .fi
536 .in -5n
537 .sp 1
538 If '!' is to be used to indicate the factorial function, for
539 shells like
540 .BI csh (1)
541 for which '!' followed by a non-space character
542 is used for history substitution, it may be necessary to
543 include a space or use a backslash to escape the special
544 meaning of '!'.
545 For example, the command:
546 .sp 1
547 .in +5n
548 .nf
549 print 27!^2
550 .fi
551 .in -5n
552 .sp 1
553 may have to be replaced by:
554 .sp 1
555 .in +5n
556 .nf
557 print 27! ^2 or print 27\!^2
558 .fi
559 .in -5n
561 \&
562 .br
563 CALC STARTUP FILES
564 .PP
565 Normally on startup,
566 if the environment variable
567 .B $CALCRC
568 is undefined and
569 .B calc
570 is invoked without the
571 .B \-q
572 flag, or if
573 .B $CALCRC
574 is defined and calc is invoked with
575 .BR \-e ,
576 .B calc
577 looks for a file "startup" in the calc resource directory
578 .B .calcrc
579 in the user's home directory, and
580 .B .calcinit in the current directory.
581 If one or more of these are found, they are read in succession as
582 .B calc
583 scripts and their commands executed.
584 When defined,
585 .B $CALCRC
586 is to contain a ':' separated list of names of files,
587 and if calc is then invoked without either the
588 .B \-q
589 or
590 .B \-e
591 flags, these files are read in succession and their commands executed.
592 No error condition is produced if a listed file is not found.
593 .sp
594 If the mode specified by
595 .B \-m
596 disables opening of files for reading, then the reading of startup
597 files is also disabled as if
598 .B \-q
599 was given.
601 \&
602 .br
603 CALC FILE SEARCH PATH
604 .PP
605 If the environment variable
606 .B $CALCPATH
607 is undefined, or if it
608 is defined and
609 .B calc
610 is invoked with the
611 .B \-e
612 flag, when a file name not beginning with
613 .BR / ,
614 .B ~
615 or
616 .BR ./ ,
617 is specified as in:
618 .sp 1
619 .in +5n
620 .nf
621 calc read myfile
622 .fi
623 .in -5n
624 .sp 1
625 .B calc
626 searches in succession:
627 .sp 1
628 .in +5n
629 .nf
630 ./myfile
631 ./myfile.cal
632 ${LIBDIR}/myfile
633 ${LIBDIR}/myfile.cal
634 ${CUSTOMCALDIR}/myfile
635 ${CUSTOMCALDIR}/myfile.cal
636 .fi
637 .in -5n
638 .sp 1
639 If the file is found, the
640 search stops and the commands in the file are executed.
641 It is an error if no readable file with the specified name is found.
642 An alternative search path can be specified by defining
643 .B $CALCPATH
644 in the same way as PATH is defined, as a ':' separated
645 list of directories, and then invoking
646 .B calc
647 without the
648 .B \-e
649 flag.
650 .PP
651 .B Calc
652 treats all open files, other than stdin, stdout and
653 stderr as files available for reading and writing.
654 One may
655 present
656 .B calc
657 with an already open file using
658 .BR sh (1),
659 .BR ksh (1),
660 .BR bash (1)-like
661 shells is to:
662 .sp 1
663 .in +5n
664 calc 3<open_file 4<open_file2
665 .in -5n
666 .sp 1
667 For more information use the following
668 .B calc
669 commands:
670 .sp 1
671 .in +5n
672 .nf
673 help help
674 help overview
675 help usage
676 help environment
677 help config
678 .fi
679 .in -5n
680 .sp 1
681 .PP
683 \&
684 .br
685 SHELL SCRIPT MODE
686 .PP
687 If the first line of an executable file begins
688 .B #!
689 followed by the absolute pathname of the
690 .B calc
691 program and the flag
692 .B \-f
693 as in:
694 .sp 1
695 .in +5n
696 .nf
697 \fI#!${BINDIR}/calc\fP\ [other_flags\ \&...] \fB\-f\fP
698 .fi
699 .in -5n
700 .sp 1
701 the rest of the file will be processed in
702 .BR "shell script mode" .
703 Note that
704 .B \-f
705 must at the end of the initial ``#!'' line.
706 Any other optional
707 .B "other_flags"
708 must come before
709 the
710 .BR \-f .
711 .sp 1
712 In
713 .B "shell script mode"
714 the contents of the file are read and
715 executed as if they were in a file being processed by a read
716 command, except that a "command" beginning with '#' followed by
717 whitespace and ending at the next newline is treated as a comment.
718 Any optional
719 .B "other_flags"
720 will be parsed first followed by
721 the later lines within the script itself.
722 .sp 1
723 In
724 .BR "shell script mode" ,
725 .B \-s
726 is always assumed.
727 In addition,
728 .B \-d
729 and
730 .B \-p
731 are automatically set if
732 .B \-i
733 is not given.
734 .sp 1
735 For example, if
736 the file
737 .BR /tmp/mersenne :
738 .sp 1
739 .in +5n
740 .nf
741 \fI#!${BINDIR}/calc\fP\ \&\fB\-q\fP \fB\-f\fP
742 #
743 # mersenne - an example of a calc \fBshell script file\fP
745 /* parse args */
746 if (argv() != 1) {
747 fprintf(files(2), "usage: %s exp\\n", config("program"));
748 abort "must give one exponent arg";
749 }
751 /* print the mersenne number */
752 print "2^": argv(0) : "-1 =", 2^eval(argv(0))-1;
753 .fi
754 .in -5n
755 .sp 1
756 is made an executable file by:
757 .sp 1
758 .in +5n
759 .nf
760 chmod +x /tmp/mersenne
761 .fi
762 .in -5n
763 .sp 1
764 then the command line:
765 .sp 1
766 .in +5n
767 .nf
768 /tmp/mersenne 127
769 .fi
770 .in -5n
771 .sp 1
772 will print:
773 .sp 1
774 .in +5n
775 .nf
776 2^127-1 = 170141183460469231731687303715884105727
777 .fi
778 .in -5n
779 .sp 1
780 Note that because
781 .B \-s
782 is assumed in
783 .B "shell script mode"
784 and non-dashed args are made available as
785 strings via the
786 .BR argv ()
787 builtin function.
788 Therefore:
789 .sp 1
790 .in +5n
791 .nf
792 2^eval(argv(0))-1
793 .fi
794 .in -5n
795 .sp 1
796 will print the decimal value of 2^n-1
797 but
798 .sp 1
799 .in +5n
800 .nf
801 2^argv(0)-1
802 .fi
803 .in -5n
804 .sp 1
805 will not.
806 .PP
808 \&
809 .br
810 DATA TYPES
811 .PP
812 Fundamental builtin data types include integers, real numbers,
813 rational numbers, complex numbers and strings.
814 .PP
815 By use of an object, one may define an arbitrarily complex
816 data types.
817 One may define how such objects behave a wide range of
818 operations such as addition, subtraction,
819 multiplication, division, negation, squaring, modulus,
820 rounding, exponentiation, equality, comparison, printing
821 and so on.
822 .PP
823 For more information use the following
824 .B calc
825 commands:
826 .PP
827 .in 1.0i
828 help types
829 .br
830 help obj
831 .br
832 show objfuncs
833 .in -1.0i
834 .PP
836 \&
837 .br
838 VARIABLES
839 .PP
840 Variables in \fIcalc\fP are typeless.
841 In other words, the fundamental type of a variable is determined by its content.
842 Before a variable is assigned a value it has the value of zero.
843 .PP
844 The scope of a variable may be global, local to a file, or local to a
845 procedure.
846 Values may be grouped together in a matrix, or into a
847 a list that permits stack and queue style operations.
848 .PP
849 For more information use the following
850 .B calc
851 commands:
852 .PP
853 .in 1.0i
854 help variable
855 .br
856 help mat
857 .br
858 help list
859 .br
860 show globals
861 .in -1.0i
862 .PP
864 \&
865 .br
866 INPUT/OUTPUT
867 .PP
868 A leading ``0x'' implies a hexadecimal value,
869 a leading ``0b'' implies a binary value,
870 and a ``0'' followed by a digit implies an octal value.
871 Complex numbers are indicated by a trailing ``i'' such as in ``3+4i''.
872 Strings may be delimited by either a pair of single or double quotes.
873 By default, \fIcalc\fP prints values as if they were floating point numbers.
874 One may change the default to print values in a number of modes
875 including fractions, integers and exponentials.
876 .PP
877 A number of stdio-like file I/O operations are provided.
878 One may open, read, write, seek and close files.
879 Filenames are subject to ``\~'' expansion to home directories
880 in a way similar to that of the Korn or C-Shell.
881 .PP
882 For example:
883 .PP
884 .in 1.0i
885 ~/.calcrc
886 .br
887 ~chongo/lib/fft_multiply.cal
888 .in -1.0i
889 .PP
890 For more information use the following
891 .B calc
892 command:
893 .PP
894 .in 1.0i
895 help file
896 .in -1.0i
897 .PP
899 \&
900 .br
901 CALC LANGUAGE
902 .PP
903 The \fIcalc\fP language is a C-like language.
904 The language includes commands such as variable declarations,
905 expressions, tests, labels, loops, file operations, function calls.
906 These commands are very similar to their counterparts in C.
907 .PP
908 The language also include a number of commands particular
909 to \fIcalc\fP itself.
910 These include commands such as function definition, help,
911 reading in resource files, dump files to a file, error notification,
912 configuration control and status.
913 .PP
914 For more information use the following
915 .B calc
916 command:
917 .PP
918 .in 1.0i
919 help command
920 .br
921 help statement
922 .br
923 help expression
924 .br
925 help operator
926 .br
927 help config
928 .in -1.0i
929 .PP
930 .SH FILES
931 \&
932 .br
933 .PD 0
934 .TP 5
935 ${BINDIR}/calc
936 calc binary
937 .sp 1
938 .TP 5
939 ${SCRIPTDIR}/*
940 calc shell scripts
941 .sp 1
942 .TP 5
943 ${LIBDIR}/*.cal
944 calc standard resource files
945 .sp 1
946 .TP 5
947 ${LIBDIR}/help/*
948 help files
949 .sp 1
950 .TP 5
951 ${LIBDIR}/bindings
952 non-GNU-readline command line editor bindings
953 .sp 1
954 .TP 5
955 ${CALC_INCDIR}/*.h
956 include files for C interface use
957 .sp 1
958 .TP 5
959 ${LIBDIR}/libcalc.a
960 calc binary link library
961 .sp 1
962 .TP 5
963 ${LIBDIR}/libcustcalc.a
964 custom binary link library
965 .sp 1
966 .TP 5
967 ${CUSTOMCALDIR}/*.cal
968 custom resource files
969 .sp 1
970 .TP 5
971 ${CUSTOMHELPDIR}/*
972 custom help files
973 .sp 1
974 .SH ENVIRONMENT
975 \&
976 .br
977 .PD 0
978 .TP 5
979 CALCPATH
980 A :-separated list of directories used to search for calc
981 resource filenames that do not begin with /, ./ or ~.
982 .br
983 .sp
984 Default value: ${CALCPATH}
985 .br
986 .sp
987 .TP 5
988 CALCRC
989 On startup (unless \-h or \-q was given on the command
990 line),
991 .B calc
992 searches for files along this :-separated
993 environment variable.
994 .br
995 .sp
996 Default value: ${CALCRC}
997 .br
998 .sp
999 .TP 5
1000 CALCBINDINGS
1001 On startup (unless \fI\-h\fP or \fI\-q\fP was given on the command
1002 line, or \fI\-m\fP disallows opening files for reading),
1003 .B calc
1004 reads
1005 key bindings from the filename specified
1006 by this environment variable.
1007 The key binding file is searched for along the $CALCPATH list
1008 of directories.
1009 .sp
1010 Default value: binding
1011 .sp
1012 This variable is not used if calc was compiled with GNU-readline support.
1013 In that case, the standard readline mechanisms (see readline(3)) are used.
1014 .sp
1015 .SH CREDIT
1016 \&
1017 .br
1018 The main chunk of
1019 .B calc
1020 was written by David I. Bell.
1021 .sp
1022 The
1023 .B calc
1024 primary mirror, calc mailing list and calc bug report
1025 processing is performed by Landon Curt Noll.
1026 .sp
1027 Landon Curt Noll maintains the master reference source, performs
1028 release control functions as well as other calc maintenance functions.
1029 .sp
1030 Thanks for suggestions and encouragement from Peter Miller,
1031 Neil Justusson, and Landon Noll.
1032 .sp
1033 Thanks to Stephen Rothwell for writing the original version of
1034 hist.c which is used to do the command line editing.
1035 .sp
1036 Thanks to Ernest W. Bowen for supplying many improvements in
1037 accuracy and generality for some numeric functions. Much of
1038 this was in terms of actual code which I gratefully accepted.
1039 Ernest also supplied the original text for many of the help files.
1040 .sp
1041 Portions of this program are derived from an earlier set of
1042 public domain arbitrarily precision routines which was posted
1043 to the net around 1984.
1044 By now, there is almost no recognizable
1045 code left from that original source.
1046 .sp
1047 .SH "COPYING / CALC GNU LESSER GENERAL PUBLIC LICENSE"
1048 \&
1049 .sp
1050 Calc is open software, and is
1051 covered under version 2.1 of the GNU Lesser General Public License.
1052 You are
1053 welcome to change it and/or distribute copies of it under certain
1054 conditions.
1055 The calc commands:
1056 .sp
1057 .in +0.5i
1058 .nf
1059 help copyright
1060 help copying
1061 help copying-lgpl
1062 .fi
1063 .in -0.5i
1064 .sp
1065 should display the contents of the COPYING and COPYING-LGPL files.
1066 Those files contain information about the calc's GNU Lesser General
1067 Public License, and in particular the conditions under which you
1068 are allowed to change it and/or distribute copies of it.
1069 .sp
1070 You should have received a copy of the version 2.1 of the GNU Lesser General
1071 Public License.
1072 If you do not have these files, write to:
1073 .sp
1074 .in +0.5i
1075 .nf
1076 Free Software Foundation, Inc.
1077 51 Franklin Street
1078 Fifth Floor
1079 Boston, MA 02110-1301
1080 USA
1081 .fi
1082 .in -0.5i
1083 .sp
1084 Calc is copyrighted in several different ways.
1085 These ways include:
1086 .sp
1087 .in +0.5i
1088 .nf
1089 Copyright (C) year David I. Bell
1090 Copyright (C) year David I. Bell and Landon Curt Noll
1091 Copyright (C) year David I. Bell and Ernest Bowen
1092 Copyright (C) year David I. Bell, Landon Curt Noll and Ernest Bowen
1093 Copyright (C) year Landon Curt Noll
1094 Copyright (C) year Ernest Bowen and Landon Curt Noll
1095 Copyright (C) year Ernest Bowen
1096 .fi
1097 .in -0.5i
1098 .sp
1099 This man page is:
1100 .sp
1101 .in +0.5i
1102 .nf
1103 Copyright (C) 1999 Landon Curt Noll
1104 .fi
1105 .in -0.5i
1106 .sp
1107 and is covered under version 2.1 GNU Lesser General
1108 Public License.
1109 .sp
1110 .SH "CALC MAILING LIST / CALC UPDATES / ENHANCEMENTS"
1111 \&
1112 .br
1113 .sp
1114 To contribute comments, suggestions, enhancements
1115 and interesting
1116 .B calc
1117 resource files, and
1118 shell scripts please join the low volume calc mailing list.
1119 .sp
1120 To join the low volume calc mailing list, send EMail to:
1121 .sp
1122 .in +0.5i
1123 .nf
1124 calc-tester-request at asthe dot com
1125 .fi
1126 .in -0.5i
1127 .sp
1128 Your subject must contain the words:
1129 .sp
1130 .in +0.5i
1131 .nf
1132 calc mailing list subscription
1133 .fi
1134 .in -0.5i
1135 .sp
1136 You may have additional words in your subject line.
1137 .sp
1138 Your message body must contain:
1139 .sp
1140 .in +0.5i
1141 .nf
1142 subscribe calc-tester address
1143 end
1144 name your_full_name
1145 .fi
1146 .in -0.5i
1147 .sp
1148 where
1149 .B address
1150 s your EMail address and
1151 .B your_full_name
1152 is your full name.
1153 Feel free to follow the
1154 .B name
1155 line with additional EMail text as desired.
1156 .sp
1157 .SH "BUG REPORTS / BUG FIXES"
1158 \&
1159 .br
1160 .sp
1161 Send bug reports and bug fixes to:
1162 .sp
1163 .in +0.5i
1164 .nf
1165 calc-bugs at asthe dot com
1167 [[ NOTE: Replace 'at' with @, 'dot' is with . ]]
1168 [[ and remove the spaces ]]
1169 [[ NOTE: The EMail address uses 'asthe' and
1170 [[ the web site URL uses 'isthe' ]]
1171 .fi
1172 .in -0.5i
1173 .sp
1174 Your subject must contain the words:
1175 .sp
1176 .in +0.5i
1177 .nf
1178 calc bug report
1179 .fi
1180 .in -0.5i
1181 .sp
1182 You may have additional words in your subject line.
1183 .sp
1184 See the
1185 .I BUGS
1186 source file or use the
1187 .I calc
1188 command:
1189 .sp
1190 .in +0.5i
1191 .nf
1192 help bugs
1193 .fi
1194 .in -0.5i
1195 .sp
1196 for more information about bug reporting.
1197 .sp
1198 .SH "CALC WEB SITE"
1199 \&
1200 .br
1201 Landon Noll maintains the
1202 .B calc
1203 web site is located at:
1204 .sp
1205 .in +0.5i
1206 www.isthe.com/chongo/tech/comp/calc/
1207 .in -0.5i
1208 .sp
1209 Share and Enjoy! :\-)