%%----------------------------------------------------------------
%% 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.