diff options
author | Karl Berry <karl@freefriends.org> | 2014-10-29 22:33:12 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-10-29 22:33:12 +0000 |
commit | 99d98e0491e7e6534c414cf552ecfafee17bd20f (patch) | |
tree | de6dfd32a50bb433bd88547e86d38820fd6c01b5 /Master/texmf-dist/doc/latex | |
parent | 836bd572a38295459c8201f029bda32baf5a4b38 (diff) |
bnumexpr (29oct14)
git-svn-id: svn://tug.org/texlive/trunk@35466 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/README | 150 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes | 28 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf | bin | 93887 -> 90610 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme | 120 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex | 28 |
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 Binary files differindex 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'. |