summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bnumexpr/README
blob: 6579fbceaf615324c73dbbc4d11aa00bd9276a4d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
The bnumexpr package
Version:  2014/09/21, v1.1
Info: Expressions with big integers

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

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

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 maps them to the macros from package bigintcalc.

Option allowpower enables ^ as power operator.

Installation
============

obtain bnumexpr.dtx, bnumexpr.ins and the README from CTAN:
  http://www.ctan.org/pkg/bnumexpr

- "tex bnumexpr.ins" generates the style file
(pre-existing file in the same repertory will be overwritten).

- without bnumexpr.ins: "tex or latex or pdflatex or xelatex bnumexpr.dtx" 
will also generate the style files (and bnumexpr.ins).

bnumexpr.tex is also extracted, use it for 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 pdflatex or xelatex: run it directly thrice on bnumexpr.dtx, or run 
it on bnumexpr.tex after having edited the suitable toggle therein.

Finishing the installation: (on first installation the destination
repertories may need to be created)

           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/