bnumexpr (7jan19)

git-svn-id: svn://tug.org/texlive/trunk@49633 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 43 insertions, 41 deletions

diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README
index 857946c5a11..c7070cbcaf1 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/README
+++ b/Master/texmf-dist/doc/latex/bnumexpr/README
@@ -1,5 +1,5 @@
 Source: bnumexpr.dtx
-Version: v1.2c, 2017/12/05 (doc: 2017/12/05)
+Version: v1.2d, 2019/01/07 (doc: 2019/01/07)
 Author: Jean-Francois Burnol
 Info: Expressions with big integers
 License: LPPL 1.3c
@@ -12,8 +12,8 @@ README: USAGE, INSTALLATION, LICENSE
 Usage
 
 The package bnumexpr allows _expandable_ computations with big integers
-and the four infix operators +, -, *, / (which does rounded integer
-division) familiar from the \numexpr e-TeX parser.
+and the four infix operators +, -, *, / familiar from the \numexpr e-TeX
+parser.
 
 Besides extending the scope to arbitrarily big numbers (and having a
 more complete syntax, for example -(1) is legal input), it adds the (by
@@ -25,27 +25,25 @@ readability of the input.
 
 For example:
 
-    \thebnumexpr ( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!\relax
+    \bnumeval{( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!}
 
-expands (in two steps) to -4006240736596543944035189.
-
-The \relax ending token is mandatory and will be removed as a result of
-the evaluation.
+    The above expands (in two steps) to `-4006240736596543944035189`
+    (the `/` does rounded division to match the `\numexpr` behaviour).
 
 The expression parser is scaled-down from the \xinttheiiexpr...\relax
-parser as provided by package xintexpr[1]: it does not handle boolean
-operators, dummy or user defined variables, functions, etc...
-
-By default the underlying arithmetic macros are the ones provided by
-package xintcore[2] (its release 1.2 is required).
+parser as provided by package xintexpr[1]: it does not handle
+hexadecimal input, boolean operators, dummy or user defined variables,
+functions, etc...
 
-bnumexpr has only one option _custom_ which says to not load xintcore,
-and a command \bnumexprsetup to inform the package which macros to use
-if not those from xintcore.
+By default, the package loads xintcore[2] (release 1.3d is then
+required) but it is possible via option _custom_ and macro
+\bnumexprsetup to map the operators to macros of one's own choice. It is
+the responsability of the user to load the packages providing these
+custom macros.
 
 Notice that the possibility not to use the xintcore macros might be
 removed in the future: perhaps a future release will maintain during
-computations a private internal representation (especially taylored
+computations a private internal representation (especially tailored
 either for the xintcore macros or new ones which would be included
 within bnumexpr.sty itself) and the constraints this implies may render
 optional use of other macros impossible.
@@ -102,7 +100,7 @@ Files bnumexpr.tex, bnumexprchanges.tex, README.md may be discarded.
 
 License
 
-Copyright (C) 2014-2017 by Jean-Francois Burnol
+Copyright (C) 2014-2019 by Jean-Francois Burnol
 
 This Work may be distributed and/or modified under the
 conditions of the LaTeX Project Public License 1.3c.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README.md b/Master/texmf-dist/doc/latex/bnumexpr/README.md
index 71c875c24ff..47341d1377e 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/README.md
+++ b/Master/texmf-dist/doc/latex/bnumexpr/README.md
@@ -1,6 +1,6 @@
 
 | Source:  bnumexpr.dtx
-| Version: v1.2c, 2017/12/05 (doc: 2017/12/05)
+| Version: v1.2d, 2019/01/07 (doc: 2019/01/07)
 | Author:  Jean-Francois Burnol
 | Info:    Expressions with big integers
 | License: LPPL 1.3c
@@ -12,8 +12,8 @@ Usage
 -----
 
 The package `bnumexpr` allows _expandable_ computations with big
-integers and the four infix operators `+`, `-`, `*`, `/` (which does
-rounded integer division) familiar from the `\numexpr` e-TeX parser.
+integers and the four infix operators `+`, `-`, `*`, `/` familiar from
+the `\numexpr` e-TeX parser.
 
 Besides extending the scope to arbitrarily big numbers (and having a
 more complete syntax, for example `-(1)` is legal input), it adds the
@@ -25,27 +25,25 @@ numbers, for better readability of the input.
 
 For example:
 
-    \thebnumexpr ( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!\relax
+    \bnumeval{( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!}
 
-expands (in two steps) to `-4006240736596543944035189`.
-
-The `\relax` ending token is mandatory and will be removed as a
-result of the evaluation.
+    The above expands (in two steps) to `-4006240736596543944035189`
+    (the `/` does rounded division to match the `\numexpr` behaviour).
 
 The expression parser is scaled-down from the `\xinttheiiexpr...\relax`
-parser as provided by package xintexpr[^1]: it does not handle boolean
-operators, dummy or user defined variables, functions, etc...
-
-By default the underlying arithmetic macros are the ones provided
-by package xintcore[^1] (its release 1.2 is required).
+parser as provided by package xintexpr[^1]: it does not handle
+hexadecimal input, boolean operators, dummy or user defined variables,
+functions, etc...
 
-bnumexpr has only one option _custom_ which says to not load
-xintcore, and a command `\bnumexprsetup` to inform the package
-which macros to use if not those from xintcore.
+By default, the package loads xintcore[^1] (release 1.3d is then
+required) but it is possible via option _custom_ and macro
+`\bnumexprsetup` to map the operators to macros of one's own choice. It
+is the responsability of the user to load the packages providing these
+custom macros.
 
 Notice that the possibility not to use the xintcore macros might be
 removed in the future: perhaps a future release will maintain during
-computations a private internal representation (especially taylored
+computations a private internal representation (especially tailored
 either for the xintcore macros or new ones which would be included
 within `bnumexpr.sty` itself) and the constraints this implies may
 render optional use of other macros impossible.
@@ -106,7 +104,7 @@ discarded.
 License
 -------
 
-Copyright (C) 2014-2017 by Jean-Francois Burnol
+Copyright (C) 2014-2019 by Jean-Francois Burnol
 
 | This Work may be distributed and/or modified under the
 | conditions of the LaTeX Project Public License 1.3c.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
index 4eea75fa5e6..9453768a846 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
index 823cc7d513c..b4a29f08fd3 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
@@ -21,12 +21,12 @@
 %% same distribution. (The sources need not necessarily be
 %% in the same archive or directory.)
 %% ---------------------------------------------------------------
-\def\bnedocdate {2017/12/05}% package bnumexpr documentation date
-\def\bnepackdate{2017/12/05}% package bnumexpr date
-\def\bneversion {1.2c}      % package bnumexpr version
+\def\bnedocdate {2019/01/07}% package bnumexpr documentation date
+\def\bnepackdate{2019/01/07}% package bnumexpr date
+\def\bneversion {1.2d}      % package bnumexpr version
 %% ---------------------------------------------------------------
 %% The bnumexpr package: Expressions with big integers
-%% Copyright (C) 2014-2017 by Jean-Francois Burnol
+%% Copyright (C) 2014-2019 by Jean-Francois Burnol
 %%
 %% latex bnumexpr.tex (thrice) && dvipdfmx bnumexpr.dvi
 %% to produce bnumexpr.pdf
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex
index 10747118f9d..c8a09e25eed 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex
@@ -22,8 +22,14 @@
 %% in the same archive or directory.)
 %% ---------------------------------------------------------------
 %% The bnumexpr package: Expressions with big integers
-%% Copyright (C) 2014-2017 by Jean-Francois Burnol
+%% Copyright (C) 2014-2019 by Jean-Francois Burnol
 %%
+\item[1.2d (2019/01/07)]
+  \begin{itemize}
+  \item requires \xintcorename |1.3d| or later (if not using option |custom|).
+  \item adds |\bnumeval|\marg{expression} user interface.
+  \end{itemize}
+
 \item[1.2c (2017/12/05)] \textbf{Breaking changes:}
   \begin{itemize}
   \item requires \xintcorename |1.2p| or later (if not using option |custom|).