diff options
author | Karl Berry <karl@freefriends.org> | 2017-07-27 21:26:37 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-07-27 21:26:37 +0000 |
commit | 489bf93080c55ee77ca42507502afcbfdec203aa (patch) | |
tree | c4fe2f155d614279d3d821534d46f270786d7769 /Master/texmf-dist/doc/latex | |
parent | fe6cc7d43e9608cb5bb2533480000837d7cf4827 (diff) |
bnumexpr (27jul17)
git-svn-id: svn://tug.org/texlive/trunk@44901 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/README | 43 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/README.md | 129 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf | bin | 76851 -> 78656 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex | 50 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex | 76 |
5 files changed, 278 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README b/Master/texmf-dist/doc/latex/bnumexpr/README index 74d6c9fbf4e..2d0ac851765 100644 --- a/Master/texmf-dist/doc/latex/bnumexpr/README +++ b/Master/texmf-dist/doc/latex/bnumexpr/README @@ -1,8 +1,8 @@ Source: bnumexpr.dtx -Version: v1.2a, 2015/10/14 (doc: 2015/10/14) +Version: v1.2b, 2017/07/09 (doc: 2017/07/09) Author: Jean-Francois Burnol Info: Expressions with big integers -License: LPPL 1.3c or later +License: LPPL 1.3c @@ -11,38 +11,38 @@ README: USAGE, INSTALLATION, LICENSE Usage -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 /:. +The package bnumexpr allows _expandable_ computations with big integers +and the four infix operators +, -, *, / (which does rounded integer +division) familiar from the \numexpr e-TeX parser. + +Besides extending the scope to arbitrarily big numbers (and having a +more complete syntax, for example -(1) is legal input), it adds the +truncated division operator //, and its associated modulo /:, the power +operator ^ (or equivalently **), and the factorial post-fix operator !. +The space character as well as the underscore character _ both may serve +to optionally separate digits in long numbers, for better readability of +the input. For example: - \thebnumexpr (92874927979^5-3197927979^6)/30!\relax + \thebnumexpr ( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!\relax -outputs -4006240736596543944035189. +expands (in two steps) to -4006240736596543944035189. The \relax ending token is mandatory and will be removed as a result of the evaluation. -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. +The expression parser is scaled-down from the \xinttheiiexpr...\relax +parser as provided by package xintexpr[1]: it does not handle boolean +operators, dummy or user defined variables, functions, etc... By default the underlying arithmetic macros are the ones provided by -package xintcore [2] (its release 1.2 is required). - -[1] http://www.ctan.org/pkg/xint -[2] http://www.ctan.org/pkg/xint +package xintcore[2] (its release 1.2 is required). 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. -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. - 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 @@ -102,7 +102,7 @@ Files bnumexpr.tex, bnumexprchanges.tex, README.md may be discarded. License -Copyright (C) 2014-2015 by Jean-Francois Burnol +Copyright (C) 2014-2017 by Jean-Francois Burnol This Work may be distributed and/or modified under the conditions of the LaTeX Project Public License 1.3c. @@ -123,3 +123,6 @@ files bnumexpr.sty, bnumexpr.pdf, bnumexpr.ins, bnumexpr.tex, bnumexprchanges.tex, README.md +[1] http://www.ctan.org/pkg/xint + +[2] http://www.ctan.org/pkg/xint diff --git a/Master/texmf-dist/doc/latex/bnumexpr/README.md b/Master/texmf-dist/doc/latex/bnumexpr/README.md new file mode 100644 index 00000000000..9499d9ff475 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bnumexpr/README.md @@ -0,0 +1,129 @@ + +| Source: bnumexpr.dtx +| Version: v1.2b, 2017/07/09 (doc: 2017/07/09) +| Author: Jean-Francois Burnol +| Info: Expressions with big integers +| License: LPPL 1.3c + +README: [Usage], [Installation], [License] +========================================== + +Usage +----- + +The package `bnumexpr` allows _expandable_ computations with big +integers and the four infix operators `+`, `-`, `*`, `/` (which does +rounded integer division) familiar from the `\numexpr` e-TeX parser. + +Besides extending the scope to arbitrarily big numbers (and having a +more complete syntax, for example `-(1)` is legal input), it adds the +truncated division operator `//`, and its associated modulo `/:`, the +power operator `^` (or equivalently `**`), and the factorial post-fix +operator `!`. The space character as well as the underscore character +`_` both may serve to optionally separate digits in long numbers, for +better readability of the input. + +For example: + + \thebnumexpr ( 92_874_927_979^5 - 31_9792_7979^6 ) / 30!\relax + +expands (in two steps) to `-4006240736596543944035189`. + +The `\relax` ending token is mandatory and will be removed as a +result of the evaluation. + +The expression parser is scaled-down from the `\xinttheiiexpr...\relax` +parser as provided by package xintexpr[^1]: it does not handle boolean +operators, dummy or user defined variables, functions, etc... + +By default the underlying arithmetic macros are the ones provided +by package xintcore[^1] (its release 1.2 is required). + +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. + +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. + +[^1]: <http://www.ctan.org/pkg/xint> + +Installation +------------ + +Obtain `bnumexpr.dtx` (and possibly, `bnumexpr.ins` and the `README`) +from CTAN: + +> <http://www.ctan.org/pkg/bnumexpr> + +Both `"tex bnumexpr.ins"` and `"tex bnumexpr.dtx"` extract from +`bnumexpr.dtx` the following files: + +`bnumexpr.sty` + : this is the style file. + +`README.md` + : reconstitutes this README. + +`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. + + : - with pdflatex: `"pdflatex bnumexpr.tex"` (thrice). + + : In both cases files `README.md` and `bnumexprchanges.tex` must + be present in the same repertory. + +without `bnumexpr.tex`: + : `"pdflatex bnumexpr.dtx"` (thrice) extracts all files and + simultaneously generates 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`, `bnumexprchanges.tex`, `README.md` may be +discarded. + +License +------- + +Copyright (C) 2014-2017 by Jean-Francois Burnol + +| This Work may be distributed and/or modified under the +| 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 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 "author-maintained". + +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, + bnumexprchanges.tex, README.md + diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf Binary files differindex 578db750660..45a69953cf0 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.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex new file mode 100644 index 00000000000..909752ddce0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex @@ -0,0 +1,50 @@ +%% +%% This is file `bnumexpr.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% bnumexpr.dtx (with options: `drv') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from bnumexpr.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file bnumexpr.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% --------------------------------------------------------------- +\def\bnedocdate {2017/07/09}% package bnumexpr documentation date +\def\bnepackdate{2017/07/09}% package bnumexpr date +\def\bneversion {1.2b} % package bnumexpr version +%% --------------------------------------------------------------- +%% The bnumexpr package: Expressions with big integers +%% Copyright (C) 2014-2017 by Jean-Francois Burnol +%% +%% latex bnumexpr.tex (thrice) && dvipdfmx bnumexpr.dvi +%% to produce bnumexpr.pdf +%% +%% or pdflatex bnumexpr.tex (no need to change \Withdvipdfmx toggle, +%% pdf engine will be detected automatically) +%% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{bnumexpr.tex}% +[\bnepackdate\space v\bneversion\space driver file for % + bnumexpr documentation (JFB)]% +\PassOptionsToClass{a4paper,fontsize=11pt}{scrdoc} +\chardef\Withdvipdfmx 1 % +\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'. diff --git a/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex b/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex new file mode 100644 index 00000000000..a28c1ee08a7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexprchanges.tex @@ -0,0 +1,76 @@ +%% +%% This is file `bnumexprchanges.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% bnumexpr.dtx (with options: `changes') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from bnumexprchanges.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file bnumexpr.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% --------------------------------------------------------------- +%% The bnumexpr package: Expressions with big integers +%% Copyright (C) 2014-2017 by Jean-Francois Burnol +%% +\item[1.2b (2017/07/09)] + \begin{itemize} + \item the |_| may be used to separate visually blocks of digits in long + numbers. + \end{itemize} + +\item[1.2a (2015/10/14)] + \begin{itemize} + \item requires \xintcorename |1.2| or later (if not using option |custom|). + \item additions to the syntax: factorial |!|, truncated division + |//|, its associated modulo |/:| and |**| as alternative to |^|. + \item all options removed except |custom|. + \item new command |\bnumexprsetup| which replaces the commands such as + |\bnumexprusesbigintcalc|. + \item the parser is no more limited to numbers with at most 5000 digits. + \end{itemize} + +\item[1.1b (2014/10/28)] + \begin{itemize} + \item README converted to |markdown/pandoc| syntax, + \item the package now loads only |xintcore|, which belongs to |xint| bundle + version |1.1| and extracts from the earlier |xint| package the core arithmetic + operations as used by |bnumexpr|. + \end{itemize} + +\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 \xintexprname, naturally (done with |xintexpr.sty 1.1|). + \end{itemize} + +\item[1.1 (2014/09/21)] First release. This is down-scaled from the + (development version of) \xintexprname. 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. +\endinput +%% +%% End of file `bnumexprchanges.tex'. |