NAME

       matho-primes - generate consecutive prime numbers

SYNOPSIS

       matho-primes [start [stop] or "all"] ["twin"] ["pal" [base]]
       matho-primes [-htuv] [-c count] [-m number] [-p base] [start [stop]]

DESCRIPTION

       This  command-line  utility  is  optionally  part  of the mathomatic(1) package.  It quickly computes any
       number of consecutive prime numbers using a windowing, memory efficient sieve of Eratosthenes  algorithm,
       dumping  them  to  standard output.  They are displayed one prime per line in ascending order, unless the
       "twin" option is specified, which displays only twin primes, two primes per line.

       Generates up to 18 decimal digit primes, or whatever is the number of digits of precision for a  floating
       point  long  double  in  the  C  compiler  used to compile this utility.  Note that this utility might be
       compiled to use only double precision floating point, if long double precision is not fully supported  by
       the C compiler or hardware, allowing at most 15 decimal digit primes in that case.

       Ways  to  verify  that  this utility is working are to pipe the output into the Unix "factor" utility, or
       compare  the  output  with  the  BSD  Games  "primes"  utility,  using   the   supplied   shell   script:
       examples/testprimes.

       All  numbers displayed by this utility are decimal (base 10) prime numbers.  A prime number is an integer
       that cannot be factored.

       A range may be specified on the command line, otherwise the starting number and the number of  primes  to
       output  is prompted for.  The range is start to stop inclusive, and stop must be greater than or equal to
       start.

       If the -c option is specified, the number of lines of primes displayed is limited to  the  decimal  count
       that follows this option.

       If  the  -t  or "twin" option is specified on the command line, only twin primes will be displayed.  Twin
       primes are two primes that differ in value by 2.  Each twin pair is displayed together on the  same  line
       separated by a space character.

       If  the  -p  or  "pal"  option  is  specified on the command line, only palindromic primes are displayed.
       Palindromes are symmetrical, they read exactly the same forward and  backward.   The  palindromic  number
       base  may  be specified, the default is base 10.  The base can be any integer greater than 1.  Primes are
       always displayed in decimal (base 10).

       The version number and short help on the  allowed  command-line  parameters  and  usage  information  are
       displayed when given the -h option.

       With  the  -u  option,  all  output  (standard output and standard error output) is set to be unbuffered,
       making all output happen immediately, instead of when the output buffer  is  full  or  when  the  program
       terminates or waits for input.

       The  -m  option  changes  the memory size of the prime number sieve window.  It is followed by a decimal,
       floating point number which is a multiplier of the default window size (2  megabytes).   It  is  possible
       that  changing the memory size may speed up the total run time a bit; otherwise there is no reason to use
       this option, and its use is not recommended.

       The -v option simply displays the program name and version number, and then exits successfully.

AUTHOR

       George Gesslein II (gesslein@mathomatic.org) at "http://www.mathomatic.org".

REPORTING BUGS

       If you find a bug, please report it to the author or at "https://launchpad.net/mathomatic".

SEE ALSO

       rmath(1), mathomatic(1), primorial(1), matho-mult(1), matho-sum(1), matho-pascal(1), matho-sumsq(1)