diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/bnumexpr/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/README | 99 |
1 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 |