bnumexpr (29oct14)

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

5 files changed, 85 insertions, 241 deletions

diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README
index f79a2c871cb..113af60fe75 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/README
+++ b/Master/texmf-dist/doc/latex/bnumexpr/README
@@ -1,85 +1,91 @@
-%%----------------------------------------------------------------
-%% 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
+Source: bnumexpr.dtx
+Version: v1.1b, 2014/10/28
+Author: Jean-Francois Burnol
+Info: Expressions with big integers
 License: LPPL 1.3c or later
 
-This README file: Usage, Installation, License
+
+
+README: USAGE, INSTALLATION, LICENSE
+
 
 Usage
-=====
 
-\usepackage{bnumexpr}
+    \usepackage{bnumexpr}
+
+Then
+
+    \thebnumexpr <expression with +,-,*,/,(,)> \relax
 
-Then \thebnumexpr <expression with +,-,*,/,(,)> \relax is like
-     \the\numexpr <expression with +,-,*,/,(,)> \relax
-with the difference of accepting or producing arbitrarily big
-integers.
+is like
 
-Example:
-     \thebnumexpr 30*(21-43*(512-67*(6133-812*2897)))\relax
-outputs:
-     -202785405180
-which would create an arithmetic overflow in \numexpr.
+    \the\numexpr <expression with +,-,*,/,(,)> \relax
 
-\bnumexpr...\relax is a scaled down version of \xintiiexpr...\relax
-from package xintexpr.
+with the difference of accepting or producing arbitrarily big integers.
+For example,
 
-By default, bnumexpr.sty loads xint.sty for its arithmetic macros
-doing addition, subtraction, multiplication, division.
+    \thebnumexpr 30*(21-43*(512-67*(6133-812*2897)))\relax
 
-- with option custom, xint.sty is not loaded and it is up to the
-user to define \bnumexprAdd, \bnumexprSub, \bnumexprMul, \bnumexprDiv
+outputs -202785405180 and this computation would have created an
+arithmetic overflow in \numexpr.
 
-- option bigintcalc loads the package of the same name and uses
-its arithmetic macros,
+\bnumexpr...\relax is a scaled down version of \xintiiexpr...\relax from
+package xintexpr.[1]
 
-- option l3bigint similarly with package l3bigint, which is
-downloadable from the development repository of the on-going
-LaTeX3 project.
+By default, bnumexpr loads xintcore [2] for its arithmetic macros doing
+addition, subtraction, multiplication, division.
+
+-   With option _custom_, xintcore is not loaded and it is up to the
+    user to define suitably the expandable macros\bnumexprAdd,
+    \bnumexprSub, \bnumexprMul, and \bnumexprDiv.
+
+-   Option _bigintcalc_ loads package bigintcalc [3] and uses its
+    arithmetic macros rather than those from xintcore.
+
+-   Option _l3bigint_ loads rather package l3bigint [4], which is in the
+    experimental trunk 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 (and possibly, 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:
+Both "tex bnumexpr.ins" and "tex bnumexpr.dtx" extract from bnumexpr.dtx
+the following files:
 
- - with bnumexpr.ins: "tex bnumexpr.ins" in the same repertory as
-   bnumexpr.dtx will create (or overwrite) the files in this repertory.
+bnumexpr.sty
+    this is the style file.
 
- - without bnumexpr.ins: "tex bnumexpr.dtx" also extracts the files.
+bnumexprReadme.md
+    reconstitutes this README.
 
- * bnumexpr.sty is the style file
+bnumexpr.changes
+    lists changes from the initial version.
 
- * bnumexpr.readme reconstitutes this README.
+bnumexpr.tex
 
- * bnumexpr.changes lists changes since last version.
+    can be used to generate the documentation:
 
- * bnumexpr.tex is used for generating the documentation:
+    -   with latex+dvipdfmx: "latex bnumexpr.tex" (thrice) then
+        "dvipdfmx bnumexpr.dvi".
 
- - 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.
+        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).
+    -   with pdflatex: set the suitable toggle in bnumexpr.tex to
+        disable dvipdfmx settings then "pdflatex bnumexpr.tex" (thrice).
 
- * without bnumexpr.tex:
+    In both cases files bnumexprReadme.md and bnumexpr.changes must be
+    present in the same repertory.
 
- pdflatex bnumexpr.dtx (thrice) generates simultaneously the style
- file and the pdf documentation.
+Without bnumexpr.tex:
+    "pdflatex bnumexpr.dtx" (thrice) extracts all files and
+    simultaneously generates the pdf documentation.
 
 Finishing the installation:
 
@@ -91,20 +97,25 @@ Finishing the installation:
            bnumexpr.pdf   --> TDS:doc/latex/bnumexpr/
                  README   --> TDS:doc/latex/bnumexpr/
 
-Files bnumexpr.tex, bnumexpr.changes, bnumexpr.readme may be discarded.
+Files bnumexpr.tex, bnumexpr.changes, bnumexprReadme.md may be
+discarded.
+
 
 License
-=======
 
-Copyright (C) 2014 by Jean-Francois Burnol (jfbu at free dot fr)
+Copyright (C) 2014 by Jean-Francois Burnol
 
 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
+
+  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
+
+  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.
 
@@ -112,9 +123,18 @@ 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
+This Work consists of the main source file bnumexpr.dtx and the derived
+files
+
+    bnumexpr.sty, bnumexpr.pdf, bnumexpr.ins, bnumexpr.tex,
+    bnumexpr.changes, bnumexprReadme.md
+
+[1] http://www.ctan.org/pkg/xint
+
+[2] http://www.ctan.org/pkg/xint
+
+[3] http://www.ctan.org/pkg/bigintcalc
+
+[4] http://latex-project.org/svnroot/experimental/trunk/l3trial/l3bigint,
+or from https://github.com/latex3/svn-mirror.
 
-End of README file.
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes
deleted file mode 100644
index 024f53f7954..00000000000
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes
+++ /dev/null
@@ -1,28 +0,0 @@
-%%----------------------------------------------------------------
-%% 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 2792d382b19..65240f9613d 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
deleted file mode 100644
index f79a2c871cb..00000000000
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme
+++ /dev/null
@@ -1,120 +0,0 @@
-%%----------------------------------------------------------------
-%% 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
deleted file mode 100644
index cd1ef3205b6..00000000000
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex
+++ /dev/null
@@ -1,28 +0,0 @@
-\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
-%%----------------------------------------------------------------
-%% This is a generated file.
-%%
-%% latex bnumexpr.tex (thrice) && dvipdfmx bnumexpr.dvi --> bnumexpr.dtx
-%% for pdflatex, set the \Withdvipdfmx toggle below to 0
-%%
-%% For distribution see the terms in the source file bnumexpr.dtx.
-%%
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesFile{bnumexpr.tex}%
-[\bnepackdate\space v\bneversion\space driver file for %
-  bnumexpr documentation (jfB)]%
-\PassOptionsToClass{a4paper,fontsize=11pt}{scrdoc}
-\chardef\Withdvipdfmx 1 % replace 1 by 0 for using pdflatex
-\chardef\NoSourceCode 0 % replace 0 by 1 for not including source code
-\input bnumexpr.dtx
-%%% Local Variables:
-%%% mode: latex
-%%% End:
-\endinput
-%%
-%% End of file `bnumexpr.tex'.