From 5d7e1f6249a7b4710b5d7950a532602628282d27 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 2 Dec 2015 14:45:55 +0100 Subject: m readme + add man page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 5 +++- doc/man/rq.1 | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 83 insertions(+), 1 deletion(-) create mode 100644 doc/man/rq.1 diff --git a/README b/README index 7f6c65f..663df64 100644 --- a/README +++ b/README @@ -27,7 +27,7 @@ ENVIRONMENT This should a positive integer optionally followed by a unit. If no unit is specified, words per minute will be used. Value units - are (case, insensitive): + are (case-insensitive): wpm w/m @@ -54,6 +54,9 @@ COMMANDS right Go to next previous word. down Go to next previous word. +RATIONALE + This should be obvious. + SEE ALSO No similar or otherwise related work known. Please inform me if you know any. diff --git a/doc/man/rq.1 b/doc/man/rq.1 new file mode 100644 index 0000000..1482ab5 --- /dev/null +++ b/doc/man/rq.1 @@ -0,0 +1,79 @@ +.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 +specifyable rate, by default 2 words per second. +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. +.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. Value 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. +.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 -- cgit v1.2.3-70-g09d2