summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/xint/README
blob: 22cd79a8f0f97665ef6ff95925468bb8f4ccc2ff (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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
The xint bundle
Release 1.09g (2013/11/22).
author: Jean-Francois Burnol

License: LPPL 1.3c or later. 
This README: *Abstract*, *Installation*, *License*.

Style files which will self-extract from xint.dtx:
       xinttools.sty  Expandable and non-expandable utilities
       xint.sty       Expandable operations on long numbers
       xintfrac.sty   Expandable operations on fractions
       xintexpr.sty   Expandable expression parser
       xintbinhex.sty Expandable binary and hexadecimal conversions
       xintgcd.sty    Euclidean algorithm with xint package
       xintseries.sty Expandable partial sums with xint package
       xintcfrac.sty  Expandable continued fractions with xint package

All these files should go into TDS:tex/generic/xint/
(see detailed installation instructions below)

May be used with Plain TeX (\input) or as LaTeX packages (\usepackage)

Abstract
========

xinttools is loaded by xint (hence by all other packages of the
bundle, too): it provides utilities of independent interest such as
expandable and non-expandable loops.

xint implements with expandable TEX macros additions, subtractions,
multiplications, divisions and powers with arbitrarily long numbers.

xintfrac extends the scope of xint to decimal numbers, to numbers in
scientific notation and also to fractions with arbitrarily long such
numerators and denominators separated by a forward slash.

xintexpr extends xintfrac with an expandable parser 
         \xintexpr . . . \relax
of expressions involving arithmetic operations in infix notation on
decimal numbers, fractions, numbers in scientific notation, with
parentheses, factorial symbol, function names, comparison operators,
logic operators, twofold and threefold way conditionals,
sub-expressions, macros expanding to the previous items.

Further modules:

xintbinhex is for conversions to and from binary and hexadecimal
bases.

xintseries provides some basic functionality for computing in an
expandable manner partial sums of series and power series with
fractional coefficients.

xintgcd implements the Euclidean algorithm and its typesetting.

xintcfrac deals with the computation of continued fractions.

Most macros, and all of those doing computations, work purely by
expansion without assignments, and may thus be used almost everywhere
in TEX. The packages may be used with any flavor of TEX supporting the
ε-TEX extensions. LATEX users will use \usepackage and others \input
to load the package components.


Installation and Usage:
=======================

If xint.ins is available "tex xint.ins".

Else "tex xint.dtx" or "latex xint.dtx". This will generate the style
files and the xint.ins file.

The tex (not latex) run will stop with the complaint that it does not
understand \NeedsTeXFormat, but the style files will already have been
extracted by that time.

Files with the same names and in the same repertory will be
overwritten.

To get xint.pdf run pdflatex thrice on xint.dtx

           xint.sty |
       xintfrac.sty |
       xintexpr.sty |
     xintbinhex.sty | --> TDS:tex/generic/xint/
        xintgcd.sty |
     xintseries.sty |
      xintcfrac.sty |
           xint.dtx   --> TDS:source/generic/xint/
           xint.pdf   --> TDS:doc/generic/xint/

It may be necessary to then refresh the TeX installation filename
database.

Usage with LaTeX: \usepackage{xint}
                  \usepackage{xintfrac}   (loads xint)
                  \usepackage{xintexpr}   (loads xintfrac)

                  \usepackage{xintbinhex} (loads xint)
                  \usepackage{xintgcd}    (loads xint)
                  \usepackage{xintseries} (loads xintfrac)
                  \usepackage{xintcfrac}  (loads xintfrac)

Usage with TeX:   \input xint.sty\relax   
                  \input xintfrac.sty\relax   (loads xint)
                  \input xintexpr.sty\relax   (loads xintfrac)

                  \input xintbinhex.sty\relax (loads xint)
                  \input xintgcd.sty\relax    (loads xint)
                  \input xintseries.sty\relax (loads xintfrac)
                  \input xintcfrac.sty\relax  (loads xintfrac)


License
=======

This work consists of the source file xint.dtx and of its derived files:
xint.sty, xintfrac.sty, xintexpr.sty, xintbinhex.sty, xintgcd.sty, 
xintseries.sty, xintcfrac.sty,  as well as xint.ins and the documentation 
xint.pdf (or xint.dvi).

   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. 

The author of this work is Jean-Francois Burnol <jfbu at free dot fr>. 
This work has the LPPL maintenance status `author-maintained'.