aboutsummaryrefslogblamecommitdiffstats
path: root/doc/man/rq.1
blob: 9c7d08727f486fdc555f55db6afe209c2fdb389b (plain) (tree)
1
2
3
4
5
6
7
8
9








                                                     
                                                

                                                    






                                                       


                                                      








                                            
                                          
                                            
                                          








































                                                    

                                                







                                                                     
.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):
.nf
.PP
.B \ \ \ \ \ \ \ wpm
.B \ \ \ \ \ \ \ w/m
.B \ \ \ \ \ \ \ m
.B \ \ \ \ \ \ \ wpmin
.B \ \ \ \ \ \ \ w/min
.BR \ \ \ \ \ \ \ /min\ \ \ \  Words\ per\ minute.
.PP
.B \ \ \ \ \ \ \ wpsec
.B \ \ \ \ \ \ \ w/sec
.B \ \ \ \ \ \ \ /sec
.B \ \ \ \ \ \ \ wps
.B \ \ \ \ \ \ \ w/s
.B \ \ \ \ \ \ \ /s
.BR \ \ \ \ \ \ \ Hz\ \ \ \ \ \  Words\ per\ second.
.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.
.SH AUTHORS
Principal author, Mattias Andrée.  See the LICENSE file for the full
list of authors.
.SH LICENSE
MIT/X Consortium License.
.SH BUGS
Please report bugs to https://github.com/maandree/rq/issues or to
maandree@member.fsf.org