From abfe5d4b63f264455fe121c77deaf5db33165867 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 1 Jun 2021 21:15:32 +0000 Subject: xintsession (1jun21) git-svn-id: svn://tug.org/texlive/trunk@59426 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/plain/xintsession/README.md | 62 ++++++++++++++--------- 1 file changed, 37 insertions(+), 25 deletions(-) (limited to 'Master/texmf-dist/doc/plain') 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 -- cgit v1.2.3