summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bnumexpr
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/bnumexpr')
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/README126
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/README.md106
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdfbin88010 -> 88616 bytes
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex8
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex13
5 files changed, 61 insertions, 192 deletions
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README
deleted file mode 100644
index a8f5c0341f3..00000000000
--- a/Master/texmf-dist/doc/latex/bnumexpr/README
+++ /dev/null
@@ -1,126 +0,0 @@
-Source: bnumexpr.dtx
-Version: v1.2e, 2019/01/08 (doc: 2019/01/08)
-Author: Jean-Francois Burnol
-Info: Expressions with big integers
-License: LPPL 1.3c
-
-
-
-README: USAGE, INSTALLATION, LICENSE
-
-
-Usage
-
-The package bnumexpr allows _expandable_ computations with big 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 (by
-default) floored division operator //, and its associated modulo /:, the
-power operator ^ (or equivalently **), and the factorial post-fix
-operator !. The space character as well as the underscore character _
-both may serve to optionally separate digits in long numbers, for better
-readability of the input.
-
-For example:
-
- \bnumeval{( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!}
-
- 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
-hexadecimal input, boolean operators, dummy or user defined variables,
-functions, etc...
-
-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 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.
-
-
-Installation
-
-Obtain bnumexpr.dtx (and possibly, bnumexpr.ins and the README) from
-CTAN:
-
- http://www.ctan.org/pkg/bnumexpr
-
-Both "tex bnumexpr.ins" and "tex bnumexpr.dtx" extract from bnumexpr.dtx
-the following files:
-
-bnumexpr.sty
- this is the style file.
-
-README.md
- reconstitutes this README.
-
-bnumexprchanges.tex
- lists changes from the initial version.
-
-bnumexpr.tex
- can be used to generate the documentation:
- - with latex+dvipdfmx: "latex bnumexpr.tex" (thrice) then
- "dvipdfmx bnumexpr.dvi".
-
- Ignore dvipdfmx warnings, but if the pdf file has problems with
- fonts (possibly from an old dvipdfmx), use then rather pdflatex.
-
- - with pdflatex: "pdflatex bnumexpr.tex" (thrice).
-
- In both cases files README.md and bnumexprchanges.tex must be
- present in the same repertory.
-
-without bnumexpr.tex:
- "pdflatex bnumexpr.dtx" (thrice) extracts all files and
- simultaneously generates the pdf documentation.
-
-Finishing the installation:
-
- bnumexpr.sty --> TDS:tex/latex/bnumexpr/
-
- bnumexpr.dtx --> TDS:source/latex/bnumexpr/
- bnumexpr.ins --> TDS:source/latex/bnumexpr/
-
- bnumexpr.pdf --> TDS:doc/latex/bnumexpr/
- README --> TDS:doc/latex/bnumexpr/
-
-Files bnumexpr.tex, bnumexprchanges.tex, README.md may be discarded.
-
-
-License
-
-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.
-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 and Maintainer of this Work is Jean-Francois Burnol.
-
-This Work consists of the main source file bnumexpr.dtx and the derived
-files
-
- bnumexpr.sty, bnumexpr.pdf, bnumexpr.ins, bnumexpr.tex,
- bnumexprchanges.tex, README.md
-
-[1] http://www.ctan.org/pkg/xint
-
-[2] http://www.ctan.org/pkg/xint
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README.md b/Master/texmf-dist/doc/latex/bnumexpr/README.md
index c632a66cf39..bda6edef58a 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/README.md
+++ b/Master/texmf-dist/doc/latex/bnumexpr/README.md
@@ -1,74 +1,65 @@
-
| Source: bnumexpr.dtx
-| Version: v1.2e, 2019/01/08 (doc: 2019/01/08)
+| Version: v1.4, 2021/05/12 (doc: 2021/05/12)
| Author: Jean-Francois Burnol
| Info: Expressions with big integers
| License: LPPL 1.3c
-README: [Usage], [Installation], [License]
-==========================================
-
-Usage
------
-
-The package `bnumexpr` allows _expandable_ computations with big
-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
-(by default) floored division operator `//`, and its associated modulo
-`/:`, the power operator `^` (or equivalently `**`), and the factorial
-post-fix operator `!`. The space character as well as the underscore
-character `_` both may serve to optionally separate digits in long
-numbers, for better readability of the input.
-
-For example:
-
- \bnumeval{( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!}
-
- 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
-hexadecimal input, boolean operators, dummy or user defined variables,
-functions, etc...
-
-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
+bnumexpr usage
+==============
+
+The LaTeX package `bnumexpr` allows expandable computations with
+integers and the four infix operators `+`, `-`, `*`, `/` using the
+expression syntax familiar from the `\numexpr` e-TeX parser, with
+these extensions:
+
+- arbitrarily big integers,
+- floored division `//`,
+- associated modulo `/:`,
+- power operators `^` and `**`,
+- factorial post-fix operator `!`,
+- comma separated expressions,
+- the space character as well as the underscore may serve
+ to separate groups of digits,
+- optional conversion of output to hexadecimal.
+
+The expression parser is a scaled-down variant from the
+`\xintiiexpr...\relax`
+parser from package [xintexpr](http://ctan.org/pkg/xintexpr).
+
+To support hexadecimal input and output, the package
+[xintbinhex](http://ctan.org/pkg/xint) is loaded automatically.
+
+The package loads by default [xintcore](http://ctan.org/pkg/xint)
+but the option _custom_ together with macro `\bnumexprsetup` allow to map
+the syntax elements to macros from an alternative big integer
+expandable engine of the user own choosing,
+and then [xintcore](http://ctan.org/pkg/xint) is not loaded.
+
+Note; 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 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.
-[^1]: <http://www.ctan.org/pkg/xint>
-
Installation
-------------
+============
-Obtain `bnumexpr.dtx` (and possibly, `bnumexpr.ins` and the `README`)
-from CTAN:
+Use your installation manager to install or update `bnumexpr`.
+
+Else, obtain `bnumexpr.dtx`, from CTAN:
> <http://www.ctan.org/pkg/bnumexpr>
-Both `"tex bnumexpr.ins"` and `"tex bnumexpr.dtx"` extract from
-`bnumexpr.dtx` the following files:
+Run `"etex bnumexpr.dtx"` to extract these files:
`bnumexpr.sty`
: this is the style file.
`README.md`
- : reconstitutes this README.
`bnumexprchanges.tex`
- : lists changes from the initial version.
+ : change history.
`bnumexpr.tex`
: can be used to generate the documentation:
@@ -76,13 +67,10 @@ Both `"tex bnumexpr.ins"` and `"tex bnumexpr.dtx"` extract from
: - with latex+dvipdfmx: `"latex bnumexpr.tex"` (thrice) then
`"dvipdfmx bnumexpr.dvi"`.
- : Ignore dvipdfmx warnings, but if the pdf file has problems with
- fonts (possibly from an old dvipdfmx), use then rather pdflatex.
-
: - with pdflatex: `"pdflatex bnumexpr.tex"` (thrice).
: In both cases files `README.md` and `bnumexprchanges.tex` must
- be present in the same repertory.
+ be located in the same repertory as `bnumexpr.tex` and `bnumexpr.dtx`.
without `bnumexpr.tex`:
: `"pdflatex bnumexpr.dtx"` (thrice) extracts all files and
@@ -93,18 +81,14 @@ Finishing the installation:
bnumexpr.sty --> TDS:tex/latex/bnumexpr/
bnumexpr.dtx --> TDS:source/latex/bnumexpr/
- bnumexpr.ins --> TDS:source/latex/bnumexpr/
bnumexpr.pdf --> TDS:doc/latex/bnumexpr/
- README --> TDS:doc/latex/bnumexpr/
-
-Files `bnumexpr.tex`, `bnumexprchanges.tex`, `README.md` may be
-discarded.
+ README.me --> TDS:doc/latex/bnumexpr/
License
--------
+=======
-Copyright (C) 2014-2019 by Jean-Francois Burnol
+Copyright (C) 2014-2021 by Jean-Francois Burnol
| This Work may be distributed and/or modified under the
| conditions of the LaTeX Project Public License 1.3c.
@@ -122,6 +106,6 @@ The Author and Maintainer of this Work is Jean-Francois Burnol.
This Work consists of the main source file `bnumexpr.dtx`
and the derived files
- bnumexpr.sty, bnumexpr.pdf, bnumexpr.ins, bnumexpr.tex,
- bnumexprchanges.tex, README.md
+ bnumexpr.sty, bnumexpr.pdf, bnumexpr.tex, bnumexprchanges.tex,
+ and README.md
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
index 5d8bf66573f..d6fce09181b 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
index ebcf3b00438..d31477086c5 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 {2019/01/08}% package bnumexpr documentation date
-\def\bnepackdate{2019/01/08}% package bnumexpr date
-\def\bneversion {1.2e} % package bnumexpr version
+\def\bnedocdate {2021/05/12}% package bnumexpr documentation date
+\def\bnepackdate{2021/05/12}% package bnumexpr date
+\def\bneversion {1.4} % package bnumexpr version
%% ---------------------------------------------------------------
%% The bnumexpr package: Expressions with big integers
-%% Copyright (C) 2014-2019 by Jean-Francois Burnol
+%% Copyright (C) 2014-2021 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 b09e504cd4b..e39bd39df1e 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex
@@ -22,8 +22,19 @@
%% in the same archive or directory.)
%% ---------------------------------------------------------------
%% The bnumexpr package: Expressions with big integers
-%% Copyright (C) 2014-2019 by Jean-Francois Burnol
+%% Copyright (C) 2014-2021 by Jean-Francois Burnol
%%
+\item[1.4 (2021/05/12)]
+ \begin{itemize}
+ \item technology transfer from \xintexprname |1.4| of
+ |2020/01/31|. The |\expanded| primitive is now required (TeXLive
+ 2019).
+ \item addition to the syntax of the |"| prefix for hexadecimal
+ input.
+ \item addition of |\evaltohex| which is like |\bnumeval| with an extra
+ conversion step to hexadecimal notation.
+ \end{itemize}
+
\item[1.2e (2019/01/08)]
Fixes a documentation glitch (extra braces when mentioning |\the\numexpr| or
|\thebnumexpr|).