summaryrefslogtreecommitdiffstats
path: root/factor/factor.6
diff options
context:
space:
mode:
Diffstat (limited to 'factor/factor.6')
-rw-r--r--factor/factor.625
1 files changed, 20 insertions, 5 deletions
diff --git a/factor/factor.6 b/factor/factor.6
index c36fcb1f..d8c6df26 100644
--- a/factor/factor.6
+++ b/factor/factor.6
@@ -1,4 +1,4 @@
-.\" $NetBSD: factor.6,v 1.13 2014/10/02 21:36:37 ast Exp $
+.\" $NetBSD: factor.6,v 1.14 2017/11/11 23:48:44 rin Exp $
.\"
.\" Copyright (c) 1989, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -35,7 +35,7 @@
.\"
.\" By Landon Curt Noll, http://www.isthe.com/chongo/index.html /\oo/\
.\"
-.Dd May 15, 2010
+.Dd Nov 12, 2017
.Dt FACTOR 6
.Os
.Sh NAME
@@ -43,6 +43,7 @@
.Nd factor a number
.Sh SYNOPSIS
.Nm
+.Op Fl h
.Op Ar number ...
.Sh DESCRIPTION
The
@@ -54,15 +55,20 @@ 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
-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
-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.
@@ -84,6 +90,15 @@ If
.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.
+.El
.Sh DIAGNOSTICS
Out of range or invalid input results in
an appropriate error message to standard error.