summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-06-01 21:15:32 +0000
committerKarl Berry <karl@freefriends.org>2021-06-01 21:15:32 +0000
commitabfe5d4b63f264455fe121c77deaf5db33165867 (patch)
treef588f593e835b62d0c8947025a58f497bd52038c /Master/texmf-dist/doc/plain
parent7f909f99438fa04b139f9e6ac791a4ccc704eefd (diff)
xintsession (1jun21)
git-svn-id: svn://tug.org/texlive/trunk@59426 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/plain')
-rw-r--r--Master/texmf-dist/doc/plain/xintsession/README.md62
1 files changed, 37 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/plain/xintsession/README.md b/Master/texmf-dist/doc/plain/xintsession/README.md
index a53772f9d8b..4b9e918a823 100644
--- a/Master/texmf-dist/doc/plain/xintsession/README.md
+++ b/Master/texmf-dist/doc/plain/xintsession/README.md
@@ -1,6 +1,6 @@
# xintsession README #
-Release: 0.2b (2021-05-23)
+Release: 0.3 (2021-05-31)
## Usage ##
@@ -11,7 +11,7 @@ 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).
-You need 2 steps to start a session:
+To start a session:
1. execute `etex xintsession`, or if available, `rlwrap etex xintsession`
to benefit from arrow keys navigation and other improvements such
@@ -19,7 +19,8 @@ You need 2 steps to start a session:
Alternatively, execute `rlwrap etex` and enter `xintsession` at the `**`
prompt.
One can also use the `-jobname` option of `etex` at this step.
-2. a welcome message is printed, hit the `RET` key at the `*` prompt.
+2. an `>>>` invite appears, start entering input, terminate it via `;`.
+ You can say `&help` for help.
The above explanations have been tested on a Unixen (Mac OS), and probably
`rlwrap` is not available on all platforms, but it is not a requirement.
@@ -30,40 +31,51 @@ so I only have to type `xs` at the command line.
You are now ready to make computations!
Here is a sample 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
+ >>> 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
+ >>> @_;
+ @_4 4.499205338329425
+ >>> add(1/i, i=1..1000);
+ @_5 7.485470860550346
+ >>> 1
+ ... +
+ ... \message{xintsession is great!}
+ (executing \message {xintsession is great!} in background)
+ xintsession is great!
+ ... 2
+ ... ;
+ @_6 3.0
+ >>> &bye
Did I say something wrong?
- Session transcript written on xintsession-210413_20h24.tex
+ Session transcript written on xintsession-210531_09h08.tex
+ )
No pages of output.
Transcript written on xintsession.log.
-As this example shows, the computational engine can work in various
-modes: exact, fp, int, and pol. Say `&fp=number` at the prompt
-to activate floating point mode with `number` as Digits (scientific
-functions implemented up to 62 digits at xint 1.4e).
+As this example illustrates, the computational engine can work in
+various modes: exact, fp, int, and pol. Say `&fp=number` at the
+`>>>` prompt
+to activate floating point mode with "Digits" set to `number`.
-If ill-formed input drops you into TeX error interaction mode, try
-hitting `S` it may work to bring you back to normal session.
+If ill-formed input drops you deep into TeX error interaction mode,
+try hitting `S` as it may work to bring you back to normal session.
-For important explanations, enter `&help` at the prompt.
+For additional explanations, enter `&help` at the `>>>` prompt.
## Change log ##
+- 0.3 (2021-05-31)
+ - implement `>>>` primary and `...` secondary invite prompts
+ - breaking: rename `\xintresume` into `\xintsession`
- 0.2b (2021-05-23)
- use `\errorcontextlines=0` regime (if not paused)
- - load `xintexpr` with `\newlinechar` set to `10` to track
+ - load `xintexpr` with `\newlinechar` set to `10` to activate
nicer error messages coming with `xintexpr 1.4g`
- add help panel navigation via `n`, `p`, `q` and `1`, ..., `5`
- fix catcode of @ was set to letter