aboutsummaryrefslogtreecommitdiffstats
path: root/rq.1
diff options
context:
space:
mode:
Diffstat (limited to 'rq.1')
-rw-r--r--rq.192
1 files changed, 92 insertions, 0 deletions
diff --git a/rq.1 b/rq.1
new file mode 100644
index 0000000..86298dc
--- /dev/null
+++ b/rq.1
@@ -0,0 +1,92 @@
+.TH RQ 1 RQ
+.SH NAME
+rq \- read quickly
+.SH SYNOPSIS
+.B rq
+.RI [ file ]
+.SH DESCRIPTION
+Displays a plain-text file word-by-word in the middle
+of the terminal. Words are automatically paged in a
+specifiable rate, by default 2 words per second.
+This is a bit slow, you should turn it up when
+gradually until your performance has been optimised.
+Repeated words will be indicated by alternating reverse
+video highlighting.
+.PP
+Escape sequences are printed as-is.
+.PP
+If no file is specified, or if \- i specified,
+stdin will be paged.
+.PP
+.B rq
+uses a method called rapid serial visual presentation.
+.SH OPTIONS
+None.
+.SH ENVIRONMENT
+.TP
+.B RQ_RATE
+The rate at which the words will be printed.
+Defaults to 120 words per minute.
+.br
+.br
+This should a positive integer, optionally
+followed by a unit. If no unit is specified,
+words per minute will be used. Valid units
+are (case-insensitive):
+.RS 14
+.TP
+.B wpm
+.TQ
+.B w/m
+.TQ
+.B m
+.TQ
+.B wpmin
+.TQ
+.B w/min
+.TQ
+.B /min
+Words per minute.
+.PP
+.TP
+.B wpsec
+.TQ
+.B w/sec
+.TQ
+.B sec
+.TQ
+.B wps
+.TQ
+.B w/s
+.TQ
+.B /s
+.TQ
+.B Hz
+Words per second.
+.Re
+.fi
+.SH COMMANDS
+.TP
+.B \+
+Increase word rate.
+.TP
+.B \-
+Decrease word rate.
+.TP
+.B p
+Pause/resume.
+.TP
+.B q
+Exit.
+.TP
+.BR left ,\ up
+Go to the previous word.
+.TP
+.BR right ,\ down
+Go to next previous word.
+.SH RATIONALE
+This should be obvious.
+.SH SEE ALSO
+No similar or otherwise related work known.
+Please inform me if you know any. There probably
+is a bunch.