summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-06-08 20:36:48 +0000
committerKarl Berry <karl@freefriends.org>2021-06-08 20:36:48 +0000
commitd555686463897ab048255c1cd733b133cf76d0b6 (patch)
tree002e564edf7c569a5837cf4579931a1d24f51913 /Master
parent1a6a16552bad89843c42ccbab0783c6780a0f204 (diff)
xintsession (8jun21)
git-svn-id: svn://tug.org/texlive/trunk@59524 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/plain/xintsession/README.md37
-rw-r--r--Master/texmf-dist/tex/plain/xintsession/xintsession.tex20
2 files changed, 34 insertions, 23 deletions
diff --git a/Master/texmf-dist/doc/plain/xintsession/README.md b/Master/texmf-dist/doc/plain/xintsession/README.md
index 4b9e918a823..a062562b671 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.3 (2021-05-31)
+Release: 0.3a (2021-06-08)
## Usage ##
@@ -8,27 +8,29 @@ 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).
+[polexpr](http://www.ctan.org/pkg/polexpr).
To start a session:
-1. execute `etex xintsession`, or if available, `rlwrap etex xintsession`
+1. Execute `etex xintsession`, or if available, `rlwrap etex xintsession`
to benefit from arrow keys navigation and other improvements such
- as parentheses highlighting.
+ as parentheses highlighting.\
+ \
Alternatively, execute `rlwrap etex` and enter `xintsession` at the `**`
- prompt.
- One can also use the `-jobname` option of `etex` at this step.
-2. an `>>>` invite appears, start entering input, terminate it via `;`.
- You can say `&help` for help.
+ prompt.\
+ \
+ One can also use the `-jobname` option of `etex` at this step.\
+ \
+ At my locale I added `alias xs="rlwrap etex xintsession"` to my `.bashrc`
+ so I only have to type `xs` at the command line.
+2. An `>>>` invite appears, and computations can begin!\
+ \
+ Start entering input, terminate it via a semi-colon `;`.
+ Say `&help` for help and `&bye` to quit.
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.
-At my locale I added `alias xs="rlwrap etex xintsession"` to my `.bashrc`
-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):
>>> 1+1/2+1/3+1/4+1/5;
@@ -60,8 +62,8 @@ Here is a sample session (spaces do not matter):
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`.
+`>>>` prompt to activate floating point mode with `number` digits
+of precision.
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.
@@ -70,6 +72,11 @@ For additional explanations, enter `&help` at the `>>>` prompt.
## Change log ##
+- 0.3a (2021-06-08)
+ - fix extremely weird `0.3` breakage of user function definition
+ interface, caused by last line being `\endinput\xintsession`,
+ and the latter using `\scantokens` in certain circumstances
+ - fix extra `(` in a help panel
- 0.3 (2021-05-31)
- implement `>>>` primary and `...` secondary invite prompts
- breaking: rename `\xintresume` into `\xintsession`
diff --git a/Master/texmf-dist/tex/plain/xintsession/xintsession.tex b/Master/texmf-dist/tex/plain/xintsession/xintsession.tex
index d7f6cffb069..1cf708bab56 100644
--- a/Master/texmf-dist/tex/plain/xintsession/xintsession.tex
+++ b/Master/texmf-dist/tex/plain/xintsession/xintsession.tex
@@ -1,4 +1,4 @@
-% Release 0.3 (2021-05-31) of xintsession.tex
+% Release 0.3a (2021-06-08) of xintsession.tex
% author: Jean-Francois Burnol
% License: LPPL 1.3c (author-maintained)
% Usage: execute "etex (or pdftex) xintsession"
@@ -55,7 +55,7 @@ _ / _ / / / /_ / __/ / / /_/ // /__ / /_ _ / __ |/ // __/__
/_/ /_/ /_/\__/ \___//_/ \__,_/ \___/ \__/ /_/ _____/ \___//_/%
}%
?xdef?xs_copyright{%
- xintsession 0.3 (2021-05-31)
+ xintsession 0.3a (2021-06-08)
Copyright (c) Jean-Francois Burnol, 2021.%
}}%
\def\xs_no{0}%
@@ -151,8 +151,8 @@ _ / _ / / / /_ / __/ / / /_/ // /__ / /_ _ / __ |/ // __/__
\immediate\write\xs_out
{\expandafter\string\xs_xintdefvar\space @_\xs_no:=%
\detokenize\expandafter{\xs_in};}%
- \XINT_expr_defvar_one{@___}{\csname XINT_expr_varvalue_@__\endcsname}%
- \XINT_expr_defvar_one{@__}{\csname XINT_expr_varvalue_@_\endcsname}%
+ \XINT_expr_defvar_one{@___}{\XINT_expr_varvalue_@__}%
+ \XINT_expr_defvar_one{@__}{\XINT_expr_varvalue_@_}%
\XINT_expr_defvar_one{@_}{\csname XINT_expr_varvalue_@_\xs_no\endcsname}%
\xs_message{%
@_\expandafter\xs_keepsix\xs_no\space\space\space\space\space\relax
@@ -191,8 +191,8 @@ _ / _ / / / /_ / __/ / / /_/ // /__ / /_ _ / __ |/ // __/__
\immediate\write\xs_out
{\expandafter\string\xs_xintdefvar\space\detokenize\expandafter{\xs_left}:=%
\detokenize\expandafter{\xs_right};}%
- \XINT_expr_defvar_one{@___}{\csname XINT_expr_varvalue_@__\endcsname}%
- \XINT_expr_defvar_one{@__}{\csname XINT_expr_varvalue_@_\endcsname}%
+ \XINT_expr_defvar_one{@___}{\XINT_expr_varvalue_@__}%
+ \XINT_expr_defvar_one{@__}{\XINT_expr_varvalue_@_}%
\XINT_expr_defvar_one{@_}{\csname XINT_expr_varvalue_@_\xs_no\endcsname}%
% this is to allow multiple assignments
\expandafter\xs_xintdefvar\xs_left=@_\xs_no;%
@@ -308,7 +308,7 @@ _ / _ / / / /_ / __/ / / /_/ // /__ / /_ _ / __ |/ // __/__
- The computing kernel can work in various modes:
exact (uses \xintexpr), fp (uses \xintfloatexpr), int (uses
- (\xintiiexpr), and pol (makes definitions using \poldef).
+ \xintiiexpr), and pol (makes definitions using \poldef).
To activate a mode enter `&<mode name>' at the prompt
- Issue `&mode' if you forgot in what mode you are currently in.
@@ -484,4 +484,8 @@ _ / _ / / / /_ / __/ / / /_/ // /__ / /_ _ / __ |/ // __/__
%
\xsrestorecatcodes%
\csname xs\string _storeenv\endcsname\endlinechar13\relax%
-\endinput\xintsession%
+% extremely eTeX-weird bug of 0.3 which had here \endinput\xintsession,
+% causing breakage if the latter attempts a \scantokens in an \edef
+% (which is what happens for function definitions).
+% bugfix 0.3a by simply moving \xintsession to before the \endinput
+\xintsession\endinput%