cosmopolitan/third_party/python/Modules/_decimal/libmpdec
Justine Tunney ae5d06dc53 Unbloat build config
- 10.5% reduction of o//depend dependency graph
- 8.8% reduction in latency of make command
- Fix issue with temporary file cleanup

There's a new -w option in compile.com that turns off the recent
Landlock output path workaround for "good commands" which do not
unlink() the output file like GNU tooling does.

Our new GNU Make unveil sandboxing appears to have zero overhead
in the grand scheme of things. Full builds are pretty fast since
the only thing that's actually slowed us down is probably libcxx

    make -j16 MODE=rel
    RL: took 85,732,063µs wall time
    RL: ballooned to 323,612kb in size
    RL: needed 828,560,521µs cpu (11% kernel)
    RL: caused 39,080,670 page faults (99% memcpy)
    RL: 350,073 context switches (72% consensual)
    RL: performed 0 reads and 11,494,960 write i/o operations

pledge() and unveil() no longer consider ENOSYS to be an error.
These functions have also been added to Python's cosmo module.

This change also removes some WIN32 APIs and System Five magnums
which we're not using and it's doubtful anyone else would be too
2022-08-10 04:43:09 -07:00
..
basearith.c Make numerous improvements 2021-09-28 01:52:34 -07:00
basearith.h Make numerous improvements 2021-09-28 01:52:34 -07:00
bits.h Make numerous improvements 2021-09-28 01:52:34 -07:00
constants.c Make numerous improvements 2021-09-28 01:52:34 -07:00
constants.h Make numerous improvements 2021-09-28 01:52:34 -07:00
context.c Make numerous improvements 2021-09-28 01:52:34 -07:00
convolute.c Make numerous improvements 2021-09-28 01:52:34 -07:00
convolute.h Make numerous improvements 2021-09-28 01:52:34 -07:00
crt.c Make numerous improvements 2021-09-28 01:52:34 -07:00
crt.h Make numerous improvements 2021-09-28 01:52:34 -07:00
difradix2.c Make numerous improvements 2021-09-28 01:52:34 -07:00
difradix2.h Make numerous improvements 2021-09-28 01:52:34 -07:00
fnt.c Make numerous improvements 2021-09-28 01:52:34 -07:00
fnt.h Make numerous improvements 2021-09-28 01:52:34 -07:00
fourstep.c Make numerous improvements 2021-09-28 01:52:34 -07:00
fourstep.h Make numerous improvements 2021-09-28 01:52:34 -07:00
io.c Unbloat build config 2022-08-10 04:43:09 -07:00
io.h Undiamond Python headers 2021-08-12 14:07:40 -07:00
memory.c Unbloat build config 2022-08-10 04:43:09 -07:00
mpalloc.h Make numerous improvements 2021-09-28 01:52:34 -07:00
mpdecimal.c Make numerous improvements 2021-09-28 01:52:34 -07:00
mpdecimal.h Unbloat build config 2022-08-10 04:43:09 -07:00
numbertheory.c Make numerous improvements 2021-09-28 01:52:34 -07:00
numbertheory.h Make numerous improvements 2021-09-28 01:52:34 -07:00
README.txt python-3.6.zip added from Github 2021-08-09 05:39:42 -07:00
sixstep.c Make numerous improvements 2021-09-28 01:52:34 -07:00
sixstep.h Make numerous improvements 2021-09-28 01:52:34 -07:00
transpose.c Productionize new APE loader and more 2021-10-02 08:27:03 -07:00
transpose.h Make numerous improvements 2021-09-28 01:52:34 -07:00
typearith.h Make numerous improvements 2021-09-28 01:52:34 -07:00
umodarith.h Make fixes, improvements, and chibicc python bindings 2021-10-08 08:41:57 -07:00


libmpdec
========

libmpdec is a fast C/C++ library for correctly-rounded arbitrary precision
decimal floating point arithmetic. It is a complete implementation of
Mike Cowlishaw/IBM's General Decimal Arithmetic Specification.


Files required for the Python _decimal module
=============================================

  Core files for small and medium precision arithmetic
  ----------------------------------------------------

    basearith.{c,h}  ->  Core arithmetic in base 10**9 or 10**19.
    bits.h           ->  Portable detection of least/most significant one-bit.
    constants.{c,h}  ->  Constants that are used in multiple files.
    context.c        ->  Context functions.
    io.{c,h}         ->  Conversions between mpd_t and ASCII strings,
                         mpd_t formatting (allows UTF-8 fill character).
    memory.{c,h}     ->  Allocation handlers with overflow detection
                         and functions for switching between static
                         and dynamic mpd_t.
    mpdecimal.{c,h}  ->  All (quiet) functions of the specification.
    typearith.h      ->  Fast primitives for double word multiplication,
                         division etc.

    Visual Studio only:
    ~~~~~~~~~~~~~~~~~~~
      vccompat.h    ->  snprintf <==> sprintf_s and similar things.
      vcstdint.h    ->  stdint.h (included in VS 2010 but not in VS 2008).
      vcdiv64.asm   ->  Double word division used in typearith.h. VS 2008 does
                        not allow inline asm for x64. Also, it does not provide
                        an intrinsic for double word division.

  Files for bignum arithmetic:
  ----------------------------

    The following files implement the Fast Number Theoretic Transform
    used for multiplying coefficients with more than 1024 words (see
    mpdecimal.c: _mpd_fntmul()).

      umodarith.h        ->  Fast low level routines for unsigned modular arithmetic.
      numbertheory.{c,h} ->  Routines for setting up the Number Theoretic Transform.
      difradix2.{c,h}    ->  Decimation in frequency transform, used as the
                             "base case" by the following three files:

        fnt.{c,h}        ->  Transform arrays up to 4096 words.
        sixstep.{c,h}    ->  Transform larger arrays of length 2**n.
        fourstep.{c,h}   ->  Transform larger arrays of length 3 * 2**n.

      convolute.{c,h}    ->  Fast convolution using one of the three transform
                             functions.
      transpose.{c,h}    ->  Transpositions needed for the sixstep algorithm.
      crt.{c,h}          ->  Chinese Remainder Theorem: use information from three
                             transforms modulo three different primes to get the
                             final result.


Pointers to literature, proofs and more
=======================================

  literature/
  -----------

    REFERENCES.txt  ->  List of relevant papers.
    bignum.txt      ->  Explanation of the Fast Number Theoretic Transform (FNT).
    fnt.py          ->  Verify constants used in the FNT; Python demo for the
                        O(N**2) discrete transform.

    matrix-transform.txt -> Proof for the Matrix Fourier Transform used in
                            fourstep.c.
    six-step.txt         -> Show that the algorithm used in sixstep.c is
                            a variant of the Matrix Fourier Transform.
    mulmod-64.txt        -> Proof for the mulmod64 algorithm from
                            umodarith.h.
    mulmod-ppro.txt      -> Proof for the x87 FPU modular multiplication
                            from umodarith.h.
    umodarith.lisp       -> ACL2 proofs for many functions from umodarith.h.


Library Author
==============

  Stefan Krah <skrah@bytereef.org>