Annotation of 43BSDReno/games/factor/factor.6, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1989 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Landon Curt Noll.
                      6: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)factor.6    5.3 (Berkeley) 6/23/90
                     22: .\"
                     23: .\"
                     24: .\" By: Landon Curt Noll   [email protected],   ...!{sun,tolsoft}!hoptoad!chongo
                     25: .\"
                     26: .\"   chongo <for a good prime call: 391581 * 2^216193 - 1> /\oo/\
                     27: .\"
                     28: .TH FACTOR 6 "June 23, 1990"
                     29: .UC 7
                     30: .SH NAME
                     31: factor, primes \- factor a number, generate primes
                     32: .SH SYNOPSIS
                     33: .B factor
                     34: [ number ] ...
                     35: .PP
                     36: .B primes
                     37: [ start [ stop ]]
                     38: .SH DESCRIPTION
                     39: The
                     40: .I factor
                     41: utility will factor integers between -2147483648 and 2147483647 inclusive.
                     42: When a number is factored, it is printed, followed by a ``:'',
                     43: and the list of factors on a single line.
                     44: Factors are listed in ascending order, and are preceded by a space.
                     45: If a factor divides a value more than once, it will be printed
                     46: more than once.
                     47: .PP
                     48: When
                     49: .I factor
                     50: is invoked with one or more arguments,
                     51: each argument will be factored.
                     52: .PP
                     53: When
                     54: .I factor
                     55: is invoked with no arguments,
                     56: .I factor
                     57: reads numbers, one per line, from standard input, until end of file or error.
                     58: Leading white-space and empty lines are ignored.
                     59: Numbers may be preceded by a single - or +.
                     60: Numbers are terminated by a non-digit character (such as a newline).
                     61: After a number is read, it is factored.
                     62: Input lines must not be longer than 255 characters.
                     63: .PP
                     64: The
                     65: .I primes
                     66: utility prints primes in ascending order, one per line, starting at or above
                     67: .B start
                     68: and continuing until, but not including
                     69: .B stop.
                     70: The
                     71: .B start 
                     72: value must be at least 0 and not greater than
                     73: .B stop.\&
                     74: The
                     75: .B stop
                     76: value must not be greater than 4294967295.
                     77: The default value of
                     78: .B stop
                     79: is 4294967295.
                     80: .PP
                     81: When the
                     82: .I primes
                     83: utility is invoked with no arguments,
                     84: .B start
                     85: is read from standard input.
                     86: .B Stop
                     87: is taken to be 4294967295.
                     88: The
                     89: .B start
                     90: value may be preceded by a single +.
                     91: The
                     92: .B start
                     93: value is terminated by a non-digit character (such as a newline).
                     94: The input line must not be longer than 255 characters.
                     95: .SH DIAGNOSTICS
                     96: Out of range or invalid input results in `ouch' being 
                     97: written to standard error.
                     98: .SH BUGS
                     99: .I Factor
                    100: cannot handle the ``10 most wanted'' factor list,
                    101: .I primes
                    102: won't get you a world record.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.