mlucas/.debian/README.Debian

mlucas for Debian
-----------------

[FIXME: This README is potentially outdated]

The subsection Great Internet Mersenne Prime Search in section NOTES
in the man page needs to be completed.

The man page for 'primenet' needs to be written.

The argument parser is buggy. The relative position of arguments is relevant to
mlucas, the order of arguments in SYNOPSIS in mlucas(1) should be followed to
avoid confusing the parser. Only 100, 1000 and 10000 are supported for -iters
flag. However, the parser will not reject unsupported arguments. Using
unsupported arguments for -iters flag may trigger strange behaviour.

On system with limited resources, the self-test for medium exponents
'mlucas -s m' may fail with 'pthread_create:: Cannot allocate memory'. See
<https://bugs.debian.org/860662> for details. The current fix is to run
self-test on each exponent one by one instead. However, this is unsatisfactory
since it does not prevent the user from running the self-test for medium
exponents and getting an error.

See BUGS section in mlucas(1) for details.

 -- Alex Vong <alexvong1995-AT-protonmail-DOT-com@NOSPAM.invalid>  Mon, 20 Dec 2021 23:07:38 +0000
 -- Alex Vong <alexvong1995@gmail.com>  Sat, 26 Jan 2019 17:13:06 +0800
 -- Alex Vong <alexvong1995@gmail.com>  Mon, 24 Apr 2017 16:16:28 +0800
 -- Alex Vong <alexvong1995@gmail.com>  Thu, 27 Aug 2015 22:04:58 +0800