aboutsummaryrefslogtreecommitdiff
path: root/typ.1
diff options
context:
space:
mode:
Diffstat (limited to 'typ.1')
-rw-r--r--typ.167
1 files changed, 67 insertions, 0 deletions
diff --git a/typ.1 b/typ.1
new file mode 100644
index 0000000..830b287
--- /dev/null
+++ b/typ.1
@@ -0,0 +1,67 @@
+.Dd $Mdocdate$
+.Dt TYP section
+.Os
+.Sh NAME
+.Nm typ
+.Nd measure typing speed
+.\" .Sh LIBRARY
+.\" For sections 2, 3, and 9 only.
+.\" Not used in OpenBSD.
+.Sh SYNOPSIS
+.Nm typ
+.Sh DESCRIPTION
+.Pp
+.Nm
+is a simple utility for measuring and analyzing typing speed.
+It reads user input on the tty until a newline is encountered.
+Then, it prints some useful statistics.
+.Pp
+.Nm
+measures (among other things)
+.Em seconds per word
+rather than words per minute.
+Unlike other timing utilities, time spent between words is not counted.
+As a result,
+.Nm
+much more accurately measures the typist's raw typing rate, regardless of his
+.Dq doubting
+rate.
+.Pp
+.Nm
+works when used in a pipe, as long as there is a tty available.
+.
+.Sh OUTPUT FORMAT
+.Pp
+.Nm
+prints eight lines to standard output.
+Each line consists of a number, a tab character and a short explanation.
+.Bl -enum -offset indent
+.It
+total words typed
+.It
+total characters typed
+.It
+total characters typed inside words
+.It
+total seconds spent
+.It
+total seconds spent inside words
+.It
+average seconds spent per character
+.It
+average seconds spent per character inside word
+.It
+average seconds spent per word
+.El
+.Pp
+To retrieve a specific number, you might use
+.Xr sed 1 :
+.Bd -literal -offset indent
+typ | sed -n '7s/\\t.*//p'
+.Ed
+.
+.Sh AUTHORS
+.Pp
+.Nm
+is written by John Ankarström
+.Aq Mt john (a) ankarstrom.se .