summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bnumexpr
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-10-29 22:33:12 +0000
committerKarl Berry <karl@freefriends.org>2014-10-29 22:33:12 +0000
commit99d98e0491e7e6534c414cf552ecfafee17bd20f (patch)
treede6dfd32a50bb433bd88547e86d38820fd6c01b5 /Master/texmf-dist/doc/latex/bnumexpr
parent836bd572a38295459c8201f029bda32baf5a4b38 (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/bnumexpr')
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/README150
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.changes28
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdfbin93887 -> 90610 bytes
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.readme120
-rw-r--r--Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.tex28
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
index 2792d382b19..65240f9613d 100644
--- a/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
+++ b/Master/texmf-dist/doc/latex/bnumexpr/bnumexpr.pdf
Binary files differ
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'.