comparison doc/misc/calc.texi @ 107712:6a80fb868018

Change name of default value of calc-settings-file to ~/.emacs.d/calc.el throughout.

107710:db1a1651507b

for @kbd{m m}, @kbd{Z P}, and similar commands to save permanent information.
You are prompted for a file name.  All Calc modes are then reset to
their default values, then settings from the file you named are loaded
if this file exists, and this file becomes the one that Calc will
use in the future for commands like @kbd{m m}.  The default settings
file name is @file{~/.calc.el}.  You can see the current file name by
giving a blank response to the @kbd{m F} prompt.  See also the
discussion of the @code{calc-settings-file} variable; @pxref{Customizing Calc}.

If the file name you give is your user init file (typically
@file{~/.emacs}), @kbd{m F} will not automatically load the new file.  This

@item Break
Selections show deep structure (@kbd{j b}; @pxref{Making Selections}).

@item Save
Record modes in @file{~/.calc.el} (@kbd{m R}; @pxref{General Mode Commands}).

@item Local
Record modes in Embedded buffer (@kbd{m R}).

@item LocEdit

@kindex u p
@pindex calc-permanent-units
@cindex Calc init file, user-defined units
The @kbd{u p} (@code{calc-permanent-units}) command stores the user-defined
units in your Calc init file (the file given by the variable
@code{calc-settings-file}, typically @file{~/.calc.el}), so that the
units will still be available in subsequent Emacs sessions.  If there
was already a set of user-defined units in your Calc init file, it
is replaced by the new set.  (@xref{General Mode Commands}, for a way to
tell Calc to use a different file for the Calc init file.)

@cindex Storing variables
@cindex Permanent variables
@cindex Calc init file, variables
The @kbd{s p} (@code{calc-permanent-variable}) command saves a
variable's value permanently in your Calc init file (the file given by
the variable @code{calc-settings-file}, typically @file{~/.calc.el}), so
that its value will still be available in future Emacs sessions.  You
can re-execute @w{@kbd{s p}} later on to update the saved value, but the
only way to remove a saved variable is to edit your calc init file
by hand.  (@xref{General Mode Commands}, for a way to tell Calc to
use a different file for the Calc init file.)

Two more mode-recording modes selectable by @kbd{m R} are available
which are also available outside of Embedded mode.  
(@pxref{General Mode Commands}.) They are @code{Save},  in which mode
settings are recorded permanently in your Calc init file (the file given
by the variable @code{calc-settings-file}, typically @file{~/.calc.el})
rather than by annotating the current document, and no-recording
mode (where there is no symbol like @code{Save} or @code{Local} in
the mode line), in which mode-changing commands do not leave any
annotations at all.

@cindex Calc init file, user-defined commands
The @kbd{Z P} (@code{calc-user-define-permanent}) command makes a key
binding permanent so that it will remain in effect even in future Emacs
sessions.  (It does this by adding a suitable bit of Lisp code into
your Calc init file; that is, the file given by the variable
@code{calc-settings-file}, typically @file{~/.calc.el}.)  For example,
@kbd{Z P s} would register our @code{sincos} command permanently.  If
you later wish to unregister this command you must edit your Calc init
file by hand.  (@xref{General Mode Commands}, for a way to tell Calc to
use a different file for the Calc init file.)

:"n * myfact(n-1)"
@end example

A good place to put your @code{defmath} commands is your Calc init file
(the file given by @code{calc-settings-file}, typically
@file{~/.calc.el}), which will not be loaded until Calc starts.
If a file named @file{.emacs} exists in your home directory, Emacs reads
and executes the Lisp forms in this file as it starts up.  While it may
seem reasonable to put your favorite @code{defmath} commands there,
this has the unfortunate side-effect that parts of the Calculator must be
loaded in to process the @code{defmath} commands whether or not you will

If @code{calc-settings-file} is not your user init file (typically
@file{~/.emacs}) and if the variable @code{calc-loaded-settings-file} is
@code{nil}, then Calc will automatically load your settings file (if it
exists) the first time Calc is invoked.

The default value for this variable is @code{"~/.calc.el"}.
@end defvar

@defvar calc-gnuplot-name
See @ref{Graphics}.@*
The variable @code{calc-gnuplot-name} should be the name of the

107712:6a80fb868018

for @kbd{m m}, @kbd{Z P}, and similar commands to save permanent information.
You are prompted for a file name.  All Calc modes are then reset to
their default values, then settings from the file you named are loaded
if this file exists, and this file becomes the one that Calc will
use in the future for commands like @kbd{m m}.  The default settings
file name is @file{~/.emacs.d/calc.el}.  You can see the current file name by
giving a blank response to the @kbd{m F} prompt.  See also the
discussion of the @code{calc-settings-file} variable; @pxref{Customizing Calc}.

If the file name you give is your user init file (typically
@file{~/.emacs}), @kbd{m F} will not automatically load the new file.  This

@item Break
Selections show deep structure (@kbd{j b}; @pxref{Making Selections}).

@item Save
Record modes in @file{~/.emacs.d/calc.el} (@kbd{m R}; @pxref{General Mode Commands}).

@item Local
Record modes in Embedded buffer (@kbd{m R}).

@item LocEdit

@kindex u p
@pindex calc-permanent-units
@cindex Calc init file, user-defined units
The @kbd{u p} (@code{calc-permanent-units}) command stores the user-defined
units in your Calc init file (the file given by the variable
@code{calc-settings-file}, typically @file{~/.emacs.d/calc.el}), so that the
units will still be available in subsequent Emacs sessions.  If there
was already a set of user-defined units in your Calc init file, it
is replaced by the new set.  (@xref{General Mode Commands}, for a way to
tell Calc to use a different file for the Calc init file.)

@cindex Storing variables
@cindex Permanent variables
@cindex Calc init file, variables
The @kbd{s p} (@code{calc-permanent-variable}) command saves a
variable's value permanently in your Calc init file (the file given by
the variable @code{calc-settings-file}, typically @file{~/.emacs.d/calc.el}), so
that its value will still be available in future Emacs sessions.  You
can re-execute @w{@kbd{s p}} later on to update the saved value, but the
only way to remove a saved variable is to edit your calc init file
by hand.  (@xref{General Mode Commands}, for a way to tell Calc to
use a different file for the Calc init file.)

Two more mode-recording modes selectable by @kbd{m R} are available
which are also available outside of Embedded mode.  
(@pxref{General Mode Commands}.) They are @code{Save},  in which mode
settings are recorded permanently in your Calc init file (the file given
by the variable @code{calc-settings-file}, typically @file{~/.emacs.d/calc.el})
rather than by annotating the current document, and no-recording
mode (where there is no symbol like @code{Save} or @code{Local} in
the mode line), in which mode-changing commands do not leave any
annotations at all.

@cindex Calc init file, user-defined commands
The @kbd{Z P} (@code{calc-user-define-permanent}) command makes a key
binding permanent so that it will remain in effect even in future Emacs
sessions.  (It does this by adding a suitable bit of Lisp code into
your Calc init file; that is, the file given by the variable
@code{calc-settings-file}, typically @file{~/.emacs.d/calc.el}.)  For example,
@kbd{Z P s} would register our @code{sincos} command permanently.  If
you later wish to unregister this command you must edit your Calc init
file by hand.  (@xref{General Mode Commands}, for a way to tell Calc to
use a different file for the Calc init file.)

:"n * myfact(n-1)"
@end example

A good place to put your @code{defmath} commands is your Calc init file
(the file given by @code{calc-settings-file}, typically
@file{~/.emacs.d/calc.el}), which will not be loaded until Calc starts.
If a file named @file{.emacs} exists in your home directory, Emacs reads
and executes the Lisp forms in this file as it starts up.  While it may
seem reasonable to put your favorite @code{defmath} commands there,
this has the unfortunate side-effect that parts of the Calculator must be
loaded in to process the @code{defmath} commands whether or not you will

If @code{calc-settings-file} is not your user init file (typically
@file{~/.emacs}) and if the variable @code{calc-loaded-settings-file} is
@code{nil}, then Calc will automatically load your settings file (if it
exists) the first time Calc is invoked.

The default value for this variable is @code{"~/.emacs.d/calc.el"}
unless the file @file{~/.calc.el} exists, in which case the default
value will be @code{"~/.calc.el"}.
@end defvar

@defvar calc-gnuplot-name
See @ref{Graphics}.@*
The variable @code{calc-gnuplot-name} should be the name of the