countmail: remove outdated comments

[bsdgames-darwin.git] / factor / factor.6

diff --git a/factor/factor.6 b/factor/factor.6
index 32029ecaa406cf3c3a4069c67778f911db753ef5..a5ee2d6f4451211a3aa50812a5d4673f96cdc676 100644 (file)
--- a/factor/factor.6
+++ b/factor/factor.6
@@ -1,4 +1,4 @@
-.\"    $NetBSD: factor.6,v 1.12 2010/05/15 21:22:39 joerg Exp $
+.\"    $NetBSD: factor.6,v 1.18 2020/10/12 13:53:43 christos Exp $

 .\"
 .\" Copyright (c) 1989, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" Copyright (c) 1989, 1993
 .\"    The Regents of the University of California.  All rights reserved.


@@ -33,11 +33,9 @@
 .\"    @(#)factor.6    8.1 (Berkeley) 5/31/93
 .\"
 .\"
 .\"    @(#)factor.6    8.1 (Berkeley) 5/31/93
 .\"
 .\"

-.\" By: Landon Curt Noll   chongo@toad.com,   ...!{sun,tolsoft}!hoptoad!chongo
+.\" By Landon Curt Noll, http://www.isthe.com/chongo/index.html /\oo/\

 .\"
 .\"

-.\"   chongo <for a good prime call: 391581 * 2^216193 - 1> /\oo/\
-.\"
-.Dd May 15, 2010
+.Dd October 12, 2020

 .Dt FACTOR 6
 .Os
 .Sh NAME
 .Dt FACTOR 6
 .Os
 .Sh NAME


@@ -45,31 +43,44 @@
 .Nd factor a number
 .Sh SYNOPSIS
 .Nm
 .Nd factor a number
 .Sh SYNOPSIS
 .Nm

+.Op Fl hx

 .Op Ar number ...
 .Sh DESCRIPTION
 The
 .Nm
 .Op Ar number ...
 .Sh DESCRIPTION
 The
 .Nm

-utility factors integers larger than 1.
+utility factors integers larger than 
+.Dv 0 .

 When a number is factored, it is printed, followed by a
 .Dq \&: ,
 and the list of
 .Pq prime
 factors on a single line.
 Factors are listed in ascending order, and are preceded by a space.
 When a number is factored, it is printed, followed by a
 .Dq \&: ,
 and the list of
 .Pq prime
 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.
+By default, if a factor divides a value more than once, it will be
+printed more than once.

 .Pp
 When
 .Nm
 .Pp
 When
 .Nm

-is invoked with one or more arguments, each argument will be factored.
+is invoked with one or more
+.Ar number
+arguments, each argument will be factored.

 .Pp
 When
 .Nm
 .Pp
 When
 .Nm

-is invoked with no arguments,
+is invoked with no
+.Ar number
+arguments,

 .Nm
 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 +.
 .Nm
 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 +.

-Integer less than 2 are rejected.
+Numbers that start with
+.Dv 0x
+are interpreted as hexadecimal.
+A 
+.Dv 0
+input exits the program.
+Negative numbers are not allowed.

 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
 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


@@ -86,12 +97,22 @@ If
 .Nm
 is compiled without OpenSSL it is limited to the maximum value of
 .Vt unsigned long .
 .Nm
 is compiled without OpenSSL it is limited to the maximum value of
 .Vt unsigned long .

+.Pp
+The following option is available:
+.Bl -tag -width flag
+.It Fl h
+If the
+.Fl h
+flag is specified, factors will be printed in "human-readable" format.
+If a factor x divides a value n (>1) times, it will appear as x^n.
+.It Fl x
+If the
+.Fl x
+flag is specified, factors will be printed in hexadecimal format.
+.El

 .Sh DIAGNOSTICS
 Out of range or invalid input results in
 .Sh DIAGNOSTICS
 Out of range or invalid input results in

-an appropriate error message
-being written to standard error.
-.\".Sh BUGS
-.\".Nm
-.\"cannot handle the
-.\".Dq 10 most wanted
-.\"factor list.
+an appropriate error message to standard error.
+.Sh AUTHORS
+Originally by
+.An Landon Curt Noll .