summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bnumexpr
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-09-23 21:34:07 +0000
committerKarl Berry <karl@freefriends.org>2014-09-23 21:34:07 +0000
commit809ee2bda7e5afc20f6e22fe1d7a322af86b225e (patch)
tree453a7395692f6769ed653fea3aca2f0a9bbca089 /Master/texmf-dist/doc/latex/bnumexpr
parent0e0fc7e759639635f5874e0c328b0b3a959a93d9 (diff)
bnumexpr (23sep14)
git-svn-id: svn://tug.org/texlive/trunk@35239 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bnumexpr')
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/README125
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes28
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdfbin82370 -> 93887 bytes
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme120
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex9
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
Binary files differ
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}%