From 407ed21945b2cc91dd05200d11612691b0f52569 Mon Sep 17 00:00:00 2001 From: jtc Date: Thu, 5 Aug 1993 01:46:15 +0000 Subject: Update to use new -mandoc macros. --- factor/factor.6 | 88 +++++++++++++++++++++++++++++++-------------------------- 1 file changed, 48 insertions(+), 40 deletions(-) (limited to 'factor') diff --git a/factor/factor.6 b/factor/factor.6 index 5c068b9f..4bf869d6 100644 --- a/factor/factor.6 +++ b/factor/factor.6 @@ -33,85 +33,93 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)factor.6 5.3 (Berkeley) 6/23/90 -.\" $Id: factor.6,v 1.2 1993/08/01 07:47:05 mycroft Exp $ +.\" $Id: factor.6,v 1.3 1993/08/05 01:46:37 jtc Exp $ .\" .\" .\" By: Landon Curt Noll chongo@toad.com, ...!{sun,tolsoft}!hoptoad!chongo .\" .\" chongo /\oo/\ .\" -.TH FACTOR 6 "June 23, 1990" -.UC 7 -.SH NAME -factor, primes \- factor a number, generate primes -.SH SYNOPSIS -.B factor -[ number ] ... -.PP -.B primes -[ start [ stop ]] -.SH DESCRIPTION +.Dd June 23, 1990 +.Dt FACTOR 6 +.Os +.Sh NAME +.Nm factor , +.Nm primes +.Nd +factor a number, generate primes +.Sh SYNOPSIS +.Nm factor +.Op Ar number ... +.br +.Nm primes +.Op Ar start Op Ar stop +.Sh DESCRIPTION The -.I factor +.Nm factor utility will factor integers between -2147483648 and 2147483647 inclusive. -When a number is factored, it is printed, followed by a ``:'', +When a number is factored, it is printed, followed by a +.Dq \: , and the list of factors on a single line. Factors are listed in ascending order, and are preceded by a space. If a factor divides a value more than once, it will be printed more than once. -.PP +.Pp When -.I factor +.Nm factor is invoked with one or more arguments, each argument will be factored. -.PP +.Pp When -.I factor +.Nm factor is invoked with no arguments, -.I factor +.Nm factor reads numbers, one per line, from standard input, until end of file or error. Leading white-space and empty lines are ignored. Numbers may be preceded by a single - or +. Numbers are terminated by a non-digit character (such as a newline). After a number is read, it is factored. Input lines must not be longer than 255 characters. -.PP +.Pp The -.I primes +.Nm primes utility prints primes in ascending order, one per line, starting at or above -.B start +.Ar start and continuing until, but not including -.B stop. +.Ar stop . The -.B start +.Ar start value must be at least 0 and not greater than -.B stop.\& +.Ar stop . The -.B stop +.Ar stop value must not be greater than 4294967295. The default value of -.B stop +.Ar stop is 4294967295. -.PP +.Pp When the -.I primes +.Nm primes utility is invoked with no arguments, -.B start +.Ar start is read from standard input. -.B Stop +.Ar stop is taken to be 4294967295. The -.B start +.Ar start value may be preceded by a single +. The -.B start +.Ar start value is terminated by a non-digit character (such as a newline). The input line must not be longer than 255 characters. -.SH DIAGNOSTICS -Out of range or invalid input results in `ouch' being -written to standard error. -.SH BUGS -.I Factor -cannot handle the ``10 most wanted'' factor list, -.I primes +.Sh DIAGNOSTICS +Out of range or invalid input results in +.Sq ouch +being written to standard error. +.Sh BUGS +.Nm Factor +cannot handle the +.Dq 10 most wanted +factor list, +.Nm primes won't get you a world record. -- cgit v1.2.3-56-ge451