summaryrefslogtreecommitdiff
path: root/macros/plain/contrib/xintsession/README.md
blob: 9821fcd2e7ba0cb4eb474e749bbf26415bb8c481 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# xintsession README #

## Usage ##

xintsession.tex is to be used with etex (or pdftex or the other engines
with Plain as preloaded format) *interactively on the command line*.

It will load [xintexpr](http://www.ctan.org/pkg/xint) and
[polexpr](http://www.ctan.org/pkg/polexpr)
(its version `0.8` or later is needed).

The following explanations have been tested on a Unixen (Mac OS),
please adapt to your shell environment.

You need 3 small steps to start a session:

1. execute `etex`, or better, `rlwrap etex` to benefit from arrow keys
   navigation and other improvements such as parentheses highlighting in
   the input (and optionally, use the `-jobname` option here)
2. at the `**` prompt, enter `xintsession` and hit `RET`,
3. a welcome message is printed, hit the `RET` key at the `*` prompt.

You are now ready to make computations!
Here is an example session (spaces do not matter):

    (Please type a command or say `\end')
    *  1+1/2+1/3+1/4+1/5;
    (@_1)    137/60
    *  @_^3 ;
    (@_2)    2571353/216000
    *  add(1/i, i=1..50);
    (@_3)    13943237577224054960759/3099044504245996706400
    *&fp
    fp mode (16 digits)
    *  @_;
    (@_4)    4.499205338329425
    *  add(1/i, i=1..1000);
    (@_5)    7.485470860550346
    *&bye
    Did I say something wrong?
    Session transcript written on xintsession-210413_20h24.tex
    No pages of output.
    Transcript written on xintsession.log.

As this example shows, the computational engine can work in various
modes: exact, fp, fp16, fp24, fp32, int, and pol.  One can define
variables and functions using `:=` syntax.

If ill-formed input drops you into TeX error interaction mode, try
hitting `S` it may work to bring you back to normal session.

For important explanations, enter `&help` at the prompt.

## License ##

Copyright (c) 2021 Jean-François Burnol

See documentation of package [xintexpr](http://www.ctan.org/pkg/xint) for
contact information.

This Work may be distributed and/or modified under the conditions of the
LaTeX Project Public License version 1.3c. This version of this license
is in

> <http://www.latex-project.org/lppl/lppl-1-3c.txt>

and version 1.3 or later is part of all distributions of LaTeX version
2005/12/01 or later.

This Work has the LPPL maintenance status author-maintained.

The Author of this Work is Jean-François Burnol.

This Work consists of the package files xintsession.tex and README.md