From 809ee2bda7e5afc20f6e22fe1d7a322af86b225e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 23 Sep 2014 21:34:07 +0000 Subject: bnumexpr (23sep14) git-svn-id: svn://tug.org/texlive/trunk@35239 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bnumexpr/README | 125 +++++++++++++-------- .../texmf-dist/doc/latex/bnumexpr/bnumexpr.changes | 28 +++++ Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf | Bin 82370 -> 93887 bytes .../texmf-dist/doc/latex/bnumexpr/bnumexpr.readme | 120 ++++++++++++++++++++ Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex | 9 +- 5 files changed, 233 insertions(+), 49 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes create mode 100644 Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme (limited to 'Master/texmf-dist/doc/latex/bnumexpr') 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 - -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 \relax is like +Then \thebnumexpr \relax is like \the\numexpr \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 |\.=| 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 Binary files a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf and b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf 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 \relax is like + \the\numexpr \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}% -- cgit v1.2.3