comparison man/calc.texi @ 40811:c9f5f8f1bce6

Fix to pacify makeinfo.

40810:6f2aa2c28da5

@tex
% Some special kludges to make TeX formatting prettier.
% Because makeinfo.c exists, we can't just define new commands.
% So instead, we take over little-used existing commands.
%
% Redefine @cite{text} to act like $text$ in regular TeX.
% Info will typeset this same as @samp{text}.
\gdef\goodtex{\tex \let\rm\goodrm \let\t\ttfont \turnoffactive}
\gdef\goodrm{\fam0\tenrm}
\gdef\cite{\goodtex$\citexxx}

original English.
@end titlepage

@c [begin]
@ifinfo
@node Top, Getting Started,, (dir)
@ichapter The GNU Emacs Calculator

@noindent
@dfn{Calc 2.02} is an advanced desk calculator and mathematical tool
that runs as part of the GNU Emacs environment.

@end ifinfo
@menu
* Copying::               How you can copy and share Calc.

* Getting Started::       General description and overview.
* Tutorial::              A step-by-step introduction for beginners.

* Introduction::          Introduction to the Calc reference manual.
* Data Types::            Types of objects manipulated by Calc.
* Stack and Trail::       Manipulating the stack and trail buffers.

SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
@end enumerate

@node Getting Started, Tutorial, Top, Top
@chapter Getting Started

@noindent
This chapter provides a general overview of Calc, the GNU Emacs
Calculator:  What it is, how to start it and how to exit from it,
and what are the various ways that it can be used.

but reformats only the top two stack entries in the new mode.

The @kbd{I} prefix has another effect on the display modes.  The mode
is set only temporarily; the top stack entry is reformatted according
to that mode, then the original mode setting is restored.  In other
words, @kbd{I d s} is equivalent to @kbd{H d s d RET H d @var{(old mode)}}.

@menu
* Radix Modes::
* Grouping Digits::
* Float Formats::

@samp{sqrt @{1+x@}}; this is only an approximation to the true meaning
of quotes in @dfn{eqn}, but it is good enough for most uses.

Accent codes (@samp{@var{x} dot}) are handled by treating them as
function calls (@samp{dot(@var{x})}) internally.  @xref{TeX Language
Mode} for a table of these accent functions.  The @code{prime} accent
is treated specially if it occurs on a variable or function name:
@samp{f prime prime @w{( x prime )}} is stored internally as
@samp{f'@w{'}(x')}.  For example, taking the derivative of @samp{f(2 x)}
with @kbd{a d x} will produce @samp{2 f'(2 x)}, which @dfn{eqn} mode
will display as @samp{2 f prime ( 2 x )}.

The @kbd{a F} command puts two entries in the trail.  One is, as
always, a copy of the result that went to the stack; the other is
a vector of the actual parameter values, written as equations:
@cite{[a = 3, b = 2]}, in case you'd rather read them in a list
than pick them out of the formula.  (You can type @kbd{t y}
to move this vector to the stack; @pxref{Trail Commands}.)

Specifying a different independent variable name will affect the
resulting formula: @kbd{a F 1 k RET} produces @kbd{3 + 2 k}.
Changing the parameter names (say, @kbd{a F 1 k;b,m RET}) will affect
the equations that go into the trail.

@iftex
{@advance@tableindent-20pt
@end iftex
@table @cite
@item -1
@var{(2)}  Rectangular complex number.
@item -2
@var{(2)}  Polar complex number.
@item -3
@var{(3)}  HMS form.
@item -4
@var{(2)}  Error form.
@item -5
@var{(2)}  Modulo form.
@item -6
@var{(2)}  Closed interval.
@item -7
@var{(2)}  Closed .. open interval.
@item -8
@var{(2)}  Open .. closed interval.
@item -9
@var{(2)}  Open interval.
@item -10
@var{(2)}  Fraction.
@item -11
@var{(2)}  Float with integer mantissa.
@item -12
@var{(2)}  Float with mantissa in @cite{[1 .. 10)}.
@item -13
@var{(1)}  Date form (using date numbers).
@item -14
@var{(3)}  Date form (using year, month, day).
@item -15
@var{(6)}  Date form (using year, month, day, hour, minute, second).
@end table
@iftex
}
@end iftex

40811:c9f5f8f1bce6

@tex
% Some special kludges to make TeX formatting prettier.
% Because makeinfo.c exists, we can't just define new commands.
% So instead, we take over little-used existing commands.
%
% Suggested by Karl Berry <karl@@freefriends.org>
\gdef\!{\mskip-\thinmuskip}
% Redefine @cite{text} to act like $text$ in regular TeX.
% Info will typeset this same as @samp{text}.
\gdef\goodtex{\tex \let\rm\goodrm \let\t\ttfont \turnoffactive}
\gdef\goodrm{\fam0\tenrm}
\gdef\cite{\goodtex$\citexxx}

original English.
@end titlepage

@c [begin]
@ifinfo
@node Top, , (dir), (dir)
@chapter The GNU Emacs Calculator

@noindent
@dfn{Calc 2.02} is an advanced desk calculator and mathematical tool
that runs as part of the GNU Emacs environment.

@end ifinfo
@menu
* Copying::               How you can copy and share Calc.

* Getting Started::       General description and overview.
* Interactive Tutorial::
* Tutorial::              A step-by-step introduction for beginners.

* Introduction::          Introduction to the Calc reference manual.
* Data Types::            Types of objects manipulated by Calc.
* Stack and Trail::       Manipulating the stack and trail buffers.

SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
@end enumerate

@node Getting Started, Tutorial, Copying, Top
@chapter Getting Started
@noindent
This chapter provides a general overview of Calc, the GNU Emacs
Calculator:  What it is, how to start it and how to exit from it,
and what are the various ways that it can be used.

but reformats only the top two stack entries in the new mode.

The @kbd{I} prefix has another effect on the display modes.  The mode
is set only temporarily; the top stack entry is reformatted according
to that mode, then the original mode setting is restored.  In other
words, @kbd{I d s} is equivalent to @kbd{H d s d RET H d (@var{old mode})}.

@menu
* Radix Modes::
* Grouping Digits::
* Float Formats::

@samp{sqrt @{1+x@}}; this is only an approximation to the true meaning
of quotes in @dfn{eqn}, but it is good enough for most uses.

Accent codes (@samp{@var{x} dot}) are handled by treating them as
function calls (@samp{dot(@var{x})}) internally.  @xref{TeX Language
Mode}, for a table of these accent functions.  The @code{prime} accent
is treated specially if it occurs on a variable or function name:
@samp{f prime prime @w{( x prime )}} is stored internally as
@samp{f'@w{'}(x')}.  For example, taking the derivative of @samp{f(2 x)}
with @kbd{a d x} will produce @samp{2 f'(2 x)}, which @dfn{eqn} mode
will display as @samp{2 f prime ( 2 x )}.

The @kbd{a F} command puts two entries in the trail.  One is, as
always, a copy of the result that went to the stack; the other is
a vector of the actual parameter values, written as equations:
@cite{[a = 3, b = 2]}, in case you'd rather read them in a list
than pick them out of the formula.  (You can type @kbd{t y}
to move this vector to the stack; see @ref{Trail Commands}.

Specifying a different independent variable name will affect the
resulting formula: @kbd{a F 1 k RET} produces @kbd{3 + 2 k}.
Changing the parameter names (say, @kbd{a F 1 k;b,m RET}) will affect
the equations that go into the trail.

@iftex
{@advance@tableindent-20pt
@end iftex
@table @cite
@item -1
(@var{2})  Rectangular complex number.
@item -2
(@var{2})  Polar complex number.
@item -3
(@var{3})  HMS form.
@item -4
(@var{2})  Error form.
@item -5
(@var{2})  Modulo form.
@item -6
(@var{2})  Closed interval.
@item -7
(@var{2})  Closed .. open interval.
@item -8
(@var{2})  Open .. closed interval.
@item -9
(@var{2})  Open interval.
@item -10
(@var{2})  Fraction.
@item -11
(@var{2})  Float with integer mantissa.
@item -12
(@var{2})  Float with mantissa in @cite{[1 .. 10)}.
@item -13
(@var{1})  Date form (using date numbers).
@item -14
(@var{3})  Date form (using year, month, day).
@item -15
(@var{6})  Date form (using year, month, day, hour, minute, second).
@end table
@iftex
}
@end iftex