plan9port/man/man1/wintext.1
Russ Cox 977b25a76a tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
2020-08-13 23:43:43 -04:00

100 lines
1.4 KiB
Groff

.TH WINTEXT 1
.SH NAME
wintext, ", "" \- access text in current window
.ds x \C'"'
.ds xx \C'"'\^\^\^\^\C'"'
.ds y \*x\^
.ds yy \*(xx\^
.SH SYNOPSIS
.B wintext
.br
.B \*y
[
.I prefix
]
.br
.B \*(yy
[
.I prefix
]
.SH DESCRIPTION
.I Wintext
prints the text of the current
.I win
(see
.IM acme (1) ),
.IM 9term (1) ,
or
(Unix's)
.IM tmux (1)
window to standard output.
.PP
.I \*y
searches the window text for commands typed with a particular prefix
and prints them, indented, to standard output.
.I Prefix
is a regular expression that is matched against the beginning of the command-line.
If
.I prefix
is omitted,
.I \*y
prints the last command executed.
.I \*(yy
prints the last command that
.I \*y
would print and then executes it by piping it into
.IM rc (1) .
.PP
Both
.I \*y
and
.I \*(yy
identify commands in the window text by looking for lines
beginning with a shell prompt.
Prompts are assumed to be an unindented sequence of
non-whitespace characters followed by one of the
characters
.BR % ,
.BR ; ,
.BR $ ,
or
.BR # .
.SH EXAMPLES
Print the
.IM ls (1)
and
.I lc
commands executed in this window:
.IP
.EX
.ta +4n
% \*x 'l[sc]'
% ls -l /tmp/qq*
# ls -lrt /etc
% lc r*
%
.EE
.PP
Execute the most recent
.I lc
command again:
.IP
.EX
.ta +4n
% \*(xx lc
% lc r*
ramfs rc read rio rm
%
.EE
.SH SEE ALSO
.IM 9term (1) ,
.IM acme (1)
.SH SOURCE
.B \*9/bin
.SH BUGS
.I \*y
and
.I \*(yy
are hard to type in shells other than
.IM rc (1) .
.\" and in troff!