summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bnumexpr
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-10-13 21:38:18 +0000
committerKarl Berry <karl@freefriends.org>2015-10-13 21:38:18 +0000
commit64fca8fccca586cda37c00d1a32f960d48fc0a7d (patch)
tree7b257fb59d79af85caad727adb1638ef7260fc96 /Master/texmf-dist/doc/latex/bnumexpr
parent5fd0db70493841f71649a45806caf5d5d3c59e4e (diff)
bnumexpr (13oct15)
git-svn-id: svn://tug.org/texlive/trunk@38631 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bnumexpr')
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/README99
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdfbin92322 -> 76868 bytes
2 files changed, 41 insertions, 58 deletions
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README
index 1f29ae7836a..c5111876d63 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.1b, 2014/10/28 (doc: 2014/11/04)
+Version: v1.2, 2015/10/13 (doc: 2015/10/13)
Author: Jean-Francois Burnol
Info: Expressions with big integers
License: LPPL 1.3c or later
@@ -11,44 +11,44 @@ README: USAGE, INSTALLATION, LICENSE
Usage
- \usepackage{bnumexpr}
+The package bnumexpr allows _expandable_ computations with big integers,
+the four infix operators +, -, *, / (which does rounded division), the
+power operators ^ or **, the factorial !, the truncated division //, and
+its associated modulo /:.
-Then
+For example:
- \thebnumexpr <expression with +,-,*,/,(,)> \relax
+ \thebnumexpr (92874927979^5-3197927979^6)/30!\relax
-is like
+outputs -4006240736596543944035189.
- \the\numexpr <expression with +,-,*,/,(,)> \relax
+The \relax ending token is mandatory and will be removed as a result of
+the evaluation.
-with the difference of accepting or producing arbitrarily big integers.
-For example,
+The expression parser is scaled-down from \xinttheiiexpr...\relax from
+package xintexpr [1], it does not handle boolean operators, conditional
+branching, variables and recognizes no functions.
- \thebnumexpr 2*1234567890\relax
+By default the underlying arithmetic macros are the ones provided by
+package xintcore [2] (its release 1.2 is required).
-outputs 2469135780 which would have created an arithmetic overflow in
-\numexpr as it exceeds the maximal allowed TeX integer 2147483647.
-
-\bnumexpr...\relax is a scaled down version of \xintiiexpr...\relax from
-package xintexpr.[1]
-
-- by default, bnumexpr loads xintcore [2] for its arithmetic macros
- doing addition, subtraction, multiplication, division (and powers).
-
-- option _allowpower_ enables ^ as power operator, for example:
-
- \thebnumexpr 2^31\relax % smallest integer exceeding the TeX bound
+[1] http://www.ctan.org/pkg/xint
+[2] http://www.ctan.org/pkg/xint
-- option _bigintcalc_ loads package bigintcalc [3] and uses its
- arithmetic macros rather than those from xintcore.
+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.
-- option _l3bigint_ loads package l3bigint [4], from the experimental
- trunk of the on-going LaTeX3 project.
+This is a breaking release: some options and commands from v1.1 are not
+defined anymore (as \bnumexprsetup provides a new interface), and
+documents which used them will need updating.
-- with option _custom_, no extra package is loaded and it is up to the
- user to define suitably expandable macros \bnumexprAdd,
- \bnumexprSub, \bnumexprMul, and \bnumexprDiv doing the basic
- arithmetic operations.
+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
+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
@@ -64,25 +64,23 @@ the following files:
bnumexpr.sty
this is the style file.
-bnumexprReadme.md
+README.md
reconstitutes this README.
-bnumexpr.changes
+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.
+ 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 bnumexprReadme.md and bnumexpr.changes must be
+ In both cases files README.md and bnumexprchanges.tex must be
present in the same repertory.
without bnumexpr.tex:
@@ -99,44 +97,29 @@ Finishing the installation:
bnumexpr.pdf --> TDS:doc/latex/bnumexpr/
README --> TDS:doc/latex/bnumexpr/
-Files bnumexpr.tex, bnumexpr.changes, bnumexprReadme.md may be
-discarded.
+Files bnumexpr.tex, bnumexprchanges.tex, README.md may be discarded.
License
-Copyright (C) 2014 by Jean-Francois Burnol
+Copyright (C) 2014-2015 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
+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 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 Work has the LPPL maintenance status "author-maintained".
-The Current Maintainer of this Work is Jean-Francois Burnol.
+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,
- 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.
+ bnumexprchanges.tex, README.md
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
index dcdee91d82f..7a5f1dcc475 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
Binary files differ