comparison man/calc.texi @ 90128:13796b0653c7

Revision: [e-mail]--gnu-2005/emacs--unicode--0--patch-29 Merge from emacs--cvs-trunk--0 Patches applied: * emacs--cvs-trunk--0 (patch 192-205) - Update from CVS - Use gdb-ui breakpoint faces on ttys too - Tweak gdb-ui breakpoint faces - Tweak info/.arch-inventory to identify info/.cvsignore as source - Clean up gdb-ui breakpoint faces

90127:30ad2795fdab

formula in any buffer and press @kbd{M-# e} (@code{calc-embedded}).
Note that @kbd{M-# e} is not to be used in the Calc stack buffer
like most Calc commands, but rather in regular editing buffers that
are visiting your own files.

Calc normally scans backward and forward in the buffer for the
nearest opening and closing @dfn{formula delimiters}.  The simplest
delimiters are blank lines.  Other delimiters that Embedded mode
understands are:

forward and backward to delimit the formula.  @kbd{M-# w}
(@code{calc-embedded-word}) is equivalent to @kbd{C-u M-# e}.

When you enable Embedded mode for a formula, Calc reads the text
between the delimiters and tries to interpret it as a Calc formula.
It's best if the current Calc language mode is correct for the
formula, but Calc can generally identify @TeX{} formulas and
Big-style formulas even if the language mode is wrong.  If Calc
can't make sense of the formula, it beeps and refuses to enter
Embedded mode.  But if the current language is wrong, Calc can
sometimes parse the formula successfully (but incorrectly);
for example, the C expression @samp{atan(a[1])} can be parsed

it is parsed (i.e., read) in La@TeX{} mode.  If the formula appears to
be written in multi-line Big mode, it is parsed in Big mode.  Otherwise,
it is parsed according to the current language mode.

Note that Calc does not change the current language mode according
to what it finds.  Even though it can read a La@TeX{} formula when
not in La@TeX{} mode, it will immediately rewrite this formula using
whatever language mode is in effect.  You must then type @kbd{d L}
to switch Calc permanently into La@TeX{} mode if that is what you
desire.

@tex
\bigskip
@end tex

@node Mode Settings in Embedded Mode, Customizing Embedded Mode, Assignments in Embedded Mode, Embedded Mode
@section Mode Settings in Embedded Mode

@noindent
Embedded mode has a rather complicated mechanism for handling mode
settings in Embedded formulas.  It is possible to put annotations
in the file that specify mode settings either global to the entire
file or local to a particular formula or formulas.  In the latter
case, different modes can be specified for use when a formula

90128:13796b0653c7

formula in any buffer and press @kbd{M-# e} (@code{calc-embedded}).
Note that @kbd{M-# e} is not to be used in the Calc stack buffer
like most Calc commands, but rather in regular editing buffers that
are visiting your own files.

Calc will try to guess an appropriate language based on the major mode
of the editing buffer. (@xref{Language Modes}.) If the current buffer is
in @code{latex-mode}, for example, Calc will set its language to La@TeX{}.
Similarly, Calc will use @TeX{} language for @code{tex-mode},
@code{plain-tex-mode} and @code{context-mode}, C language for
@code{c-mode} and @code{c++-mode}, FORTRAN language for
@code{fortran-mode} and @code{f90-mode}, Pascal for @code{pascal-mode},
and eqn for @code{nroff-mode}.  These can be overridden with Calc's mode
changing commands (@pxref{Mode Settings in Embedded Mode}).  If no
suitable language is available, Calc will continue with its current language.

Calc normally scans backward and forward in the buffer for the
nearest opening and closing @dfn{formula delimiters}.  The simplest
delimiters are blank lines.  Other delimiters that Embedded mode
understands are:

forward and backward to delimit the formula.  @kbd{M-# w}
(@code{calc-embedded-word}) is equivalent to @kbd{C-u M-# e}.

When you enable Embedded mode for a formula, Calc reads the text
between the delimiters and tries to interpret it as a Calc formula.
Calc can generally identify @TeX{} formulas and
Big-style formulas even if the language mode is wrong.  If Calc
can't make sense of the formula, it beeps and refuses to enter
Embedded mode.  But if the current language is wrong, Calc can
sometimes parse the formula successfully (but incorrectly);
for example, the C expression @samp{atan(a[1])} can be parsed

it is parsed (i.e., read) in La@TeX{} mode.  If the formula appears to
be written in multi-line Big mode, it is parsed in Big mode.  Otherwise,
it is parsed according to the current language mode.

Note that Calc does not change the current language mode according
the formula it reads in.  Even though it can read a La@TeX{} formula when
not in La@TeX{} mode, it will immediately rewrite this formula using
whatever language mode is in effect.

@tex
\bigskip
@end tex

@node Mode Settings in Embedded Mode, Customizing Embedded Mode, Assignments in Embedded Mode, Embedded Mode
@section Mode Settings in Embedded Mode

@noindent
The mode settings can be changed while Calc is in embedded mode, but
will revert to their original values when embedded mode is ended
(except for the modes changed while the mode-setting mode was
@code{Save}). 

Embedded mode has a rather complicated mechanism for handling mode
settings in Embedded formulas.  It is possible to put annotations
in the file that specify mode settings either global to the entire
file or local to a particular formula or formulas.  In the latter
case, different modes can be specified for use when a formula