bnumexpr (23sep14)

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

5 files changed, 233 insertions, 49 deletions

diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README
index 6579fbceaf6..f79a2c871cb 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/README
+++ b/Master/texmf-dist/doc/latex/bnumexpr/README
@@ -1,33 +1,21 @@
-The bnumexpr package
-Version:  2014/09/21, v1.1
-Info: Expressions with big integers
-
-Copyright (C) 2014 by Jean-Francois Burnol <jfbu at free dot fr>
-
-This work may be distributed and/or modified under the
-conditions of the LaTeX Project Public License, either
-version 1.3c of this license or (at your option) any later
-version. This version of this license is in
-   http://www.latex-project.org/lppl/lppl-1-3c.txt
-and the latest version of this license is in
-   http://www.latex-project.org/lppl.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 "maintained".
-
-This Current 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
+%%----------------------------------------------------------------
+%% The bnumexpr package: Expressions with big integers
+%% Copyright (C) 2014 by Jean-Francois Burnol
+%%----------------------------------------------------------------
+Source:  bnumexpr.dtx
+Version: v1.1a, 2014/09/22
+Author:  Jean-Francois Burnol
+Info:    Expressions with big integers
+License: LPPL 1.3c or later
+
+This README file: Usage, Installation, License
 
 Usage
 =====
 
 \usepackage{bnumexpr}
 
-Then \thebnumexpr <expression with +,-,*,/,(,)> \relax is like 
+Then \thebnumexpr <expression with +,-,*,/,(,)> \relax is like
      \the\numexpr <expression with +,-,*,/,(,)> \relax
 with the difference of accepting or producing arbitrarily big
 integers.
@@ -39,43 +27,63 @@ outputs:
 which would create an arithmetic overflow in \numexpr.
 
 \bnumexpr...\relax is a scaled down version of \xintiiexpr...\relax
-from package xintexpr. 
+from package xintexpr.
 
 By default, bnumexpr.sty loads xint.sty for its arithmetic macros
-doing addition, subtraction, multiplication, division. 
+doing addition, subtraction, multiplication, division.
+
+- with option custom, xint.sty is not loaded and it is up to the
+user to define \bnumexprAdd, \bnumexprSub, \bnumexprMul, \bnumexprDiv
 
-With option custom, xint.sty is not loaded and it is up to the user 
-to define \bnumexprAdd, \bnumexprSub, \bnumexprMul, \bnumexprDiv
+- option bigintcalc loads the package of the same name and uses
+its arithmetic macros,
 
-Option bigintcalc maps them to the macros from package bigintcalc.
+- option l3bigint similarly with package l3bigint, which is
+downloadable from the development repository of the on-going
+LaTeX3 project.
 
-Option allowpower enables ^ as power operator.
+Option allowpower enables ^ as power operator (only for xint and
+bigintcalc currently).
 
 Installation
 ============
 
-obtain bnumexpr.dtx, bnumexpr.ins and the README from CTAN:
-  http://www.ctan.org/pkg/bnumexpr
+Obtain bnumexpr.dtx (and possibly, bnumexpr.ins and the README)
+from CTAN:
+                 http://www.ctan.org/pkg/bnumexpr
+
+To generate files from the source bnumexpr.dtx:
+
+ - with bnumexpr.ins: "tex bnumexpr.ins" in the same repertory as
+   bnumexpr.dtx will create (or overwrite) the files in this repertory.
+
+ - without bnumexpr.ins: "tex bnumexpr.dtx" also extracts the files.
+
+ * bnumexpr.sty is the style file
 
-- "tex bnumexpr.ins" generates the style file
-(pre-existing file in the same repertory will be overwritten).
+ * bnumexpr.readme reconstitutes this README.
 
-- without bnumexpr.ins: "tex or latex or pdflatex or xelatex bnumexpr.dtx" 
-will also generate the style files (and bnumexpr.ins).
+ * bnumexpr.changes lists changes since last version.
 
-bnumexpr.tex is also extracted, use it for the documentation:
+ * bnumexpr.tex is used for generating 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 or xelatex.
+ - 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 or xelatex: run it directly thrice on bnumexpr.dtx, or run 
-it on bnumexpr.tex after having edited the suitable toggle therein.
+ - with pdflatex:
+   set the suitable toggle in bnumexpr.tex to disable dvipdfmx
+   settings and compile it with pdflatex (thrice).
 
-Finishing the installation: (on first installation the destination
-repertories may need to be created)
+ * without bnumexpr.tex:
 
-           bnumexpr.sty   --> TDS:tex/latex/bnumexpr/ 
+ pdflatex bnumexpr.dtx (thrice) generates simultaneously the style
+ file and the pdf documentation.
+
+Finishing the installation:
+
+           bnumexpr.sty   --> TDS:tex/latex/bnumexpr/
 
            bnumexpr.dtx   --> TDS:source/latex/bnumexpr/
            bnumexpr.ins   --> TDS:source/latex/bnumexpr/
@@ -83,3 +91,30 @@ repertories may need to be created)
            bnumexpr.pdf   --> TDS:doc/latex/bnumexpr/
                  README   --> TDS:doc/latex/bnumexpr/
 
+Files bnumexpr.tex, bnumexpr.changes, bnumexpr.readme may be discarded.
+
+License
+=======
+
+Copyright (C) 2014 by Jean-Francois Burnol (jfbu at free dot fr)
+
+This Work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3c of this license or (at your option) any later
+version. This version of this license is in
+   http://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+   http://www.latex-project.org/lppl.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 "maintained".
+
+The Current 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,
+   bnumexpr.changes, bnumexpr.readme
+
+End of README file.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes
new file mode 100644
index 00000000000..024f53f7954
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes
@@ -0,0 +1,28 @@
+%%----------------------------------------------------------------
+%% The bnumexpr package: Expressions with big integers
+%% Copyright (C) 2014 by Jean-Francois Burnol
+%%----------------------------------------------------------------
+%% This is a generated file.
+%%
+%% For distribution see the terms in the source file bnumexpr.dtx.
+%%
+\item[1.1a (2014/09/22)] \begin{itemize}
+  \item added |l3bigint| option to use experimental \LaTeX3
+    package of the same name.
+
+  \item added Changes and Readme sections to the documentation.
+
+  \item better |\BNE_protect| mechanism for use of
+  |\bnumexpr...\relax| inside an |\edef| (without |\bnethe|). Previous one,
+  inherited from |xintexpr.sty 1.09n|, assumed that the |\.=<digits>| dummy
+  control sequence encapsulating the computation result had |\relax|
+  meaning. But removing this assumption was only a matter of letting
+  |\BNE_protect| protect two, not one, tokens. This will be backported to
+  next version of |xintexpr.sty|, naturally.
+  \end{itemize}
+\item[1.1 (2014/09/21)] First release. This is down-scaled from the
+  (development version of) |xintexpr.sty|. Motivation came the previous day
+  from a chat with \textsc{Joseph Wright} over big int status in \LaTeX3.
+  The |\bnumexpr...\relax| parser can be used on top of big int macros of
+  one's choice. Functionalities limited to the basic operations. I leave
+  the power operator |^| as an option.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
index 22235b4a02f..2792d382b19 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.readme b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme
new file mode 100644
index 00000000000..f79a2c871cb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme
@@ -0,0 +1,120 @@
+%%----------------------------------------------------------------
+%% The bnumexpr package: Expressions with big integers
+%% Copyright (C) 2014 by Jean-Francois Burnol
+%%----------------------------------------------------------------
+Source:  bnumexpr.dtx
+Version: v1.1a, 2014/09/22
+Author:  Jean-Francois Burnol
+Info:    Expressions with big integers
+License: LPPL 1.3c or later
+
+This README file: Usage, Installation, License
+
+Usage
+=====
+
+\usepackage{bnumexpr}
+
+Then \thebnumexpr <expression with +,-,*,/,(,)> \relax is like
+     \the\numexpr <expression with +,-,*,/,(,)> \relax
+with the difference of accepting or producing arbitrarily big
+integers.
+
+Example:
+     \thebnumexpr 30*(21-43*(512-67*(6133-812*2897)))\relax
+outputs:
+     -202785405180
+which would create an arithmetic overflow in \numexpr.
+
+\bnumexpr...\relax is a scaled down version of \xintiiexpr...\relax
+from package xintexpr.
+
+By default, bnumexpr.sty loads xint.sty for its arithmetic macros
+doing addition, subtraction, multiplication, division.
+
+- with option custom, xint.sty is not loaded and it is up to the
+user to define \bnumexprAdd, \bnumexprSub, \bnumexprMul, \bnumexprDiv
+
+- option bigintcalc loads the package of the same name and uses
+its arithmetic macros,
+
+- option l3bigint similarly with package l3bigint, which is
+downloadable from the development repository of the on-going
+LaTeX3 project.
+
+Option allowpower enables ^ as power operator (only for xint and
+bigintcalc currently).
+
+Installation
+============
+
+Obtain bnumexpr.dtx (and possibly, bnumexpr.ins and the README)
+from CTAN:
+                 http://www.ctan.org/pkg/bnumexpr
+
+To generate files from the source bnumexpr.dtx:
+
+ - with bnumexpr.ins: "tex bnumexpr.ins" in the same repertory as
+   bnumexpr.dtx will create (or overwrite) the files in this repertory.
+
+ - without bnumexpr.ins: "tex bnumexpr.dtx" also extracts the files.
+
+ * bnumexpr.sty is the style file
+
+ * bnumexpr.readme reconstitutes this README.
+
+ * bnumexpr.changes lists changes since last version.
+
+ * bnumexpr.tex is used for generating 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:
+   set the suitable toggle in bnumexpr.tex to disable dvipdfmx
+   settings and compile it with pdflatex (thrice).
+
+ * without bnumexpr.tex:
+
+ pdflatex bnumexpr.dtx (thrice) generates simultaneously the style
+ file and 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, bnumexpr.changes, bnumexpr.readme may be discarded.
+
+License
+=======
+
+Copyright (C) 2014 by Jean-Francois Burnol (jfbu at free dot fr)
+
+This Work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3c of this license or (at your option) any later
+version. This version of this license is in
+   http://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+   http://www.latex-project.org/lppl.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 "maintained".
+
+The Current 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,
+   bnumexpr.changes, bnumexpr.readme
+
+End of README file.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
index de20c8461aa..cd1ef3205b6 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
@@ -1,6 +1,6 @@
-\def\bnedocdate {2014/09/21} % package bnumexpr documentation date
-\def\bnepackdate{2014/09/21} % package bnumexpr date
-\def\bneversion {1.1}        % package bnumexpr version
+\def\bnedocdate {2014/09/22} % package bnumexpr documentation date
+\def\bnepackdate{2014/09/22} % package bnumexpr date
+\def\bneversion {1.1a}       % package bnumexpr version
 %%----------------------------------------------------------------
 %% The bnumexpr package: Expressions with big integers
 %% Copyright (C) 2014 by Jean-Francois Burnol
@@ -8,8 +8,9 @@
 %% This is a generated file.
 %%
 %% latex bnumexpr.tex (thrice) && dvipdfmx bnumexpr.dvi --> bnumexpr.dtx
+%% for pdflatex, set the \Withdvipdfmx toggle below to 0
 %%
-%% See bnumexpr.dtx for the copyright and license statements.
+%% For distribution see the terms in the source file bnumexpr.dtx.
 %%
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesFile{bnumexpr.tex}%