mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
977b25a76a
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.
88 lines
1.2 KiB
Groff
88 lines
1.2 KiB
Groff
.TH PLUMB 1
|
|
.SH NAME
|
|
plumb \- send message to plumber
|
|
.SH SYNOPSIS
|
|
.B plumb
|
|
[
|
|
.B -p
|
|
.I plumbfile
|
|
] [
|
|
.B -a
|
|
.I attributes
|
|
] [
|
|
.B -s
|
|
.I source
|
|
] [
|
|
.B -d
|
|
.I destination
|
|
] [
|
|
.B -t
|
|
.I type
|
|
] [
|
|
.B -w
|
|
.I directory
|
|
]
|
|
.B -i
|
|
|
|
|
.I data...
|
|
.SH DESCRIPTION
|
|
The
|
|
.I plumb
|
|
command formats and sends a plumbing message whose data
|
|
is, by default, the concatenation of the argument strings separated by blanks.
|
|
The options are:
|
|
.TP
|
|
.B -p
|
|
write the message to
|
|
.I plumbfile
|
|
(default
|
|
.BR /mnt/plumb/send ).
|
|
.TP
|
|
.B -a
|
|
set the
|
|
.B attr
|
|
field of the message (default is empty).
|
|
.TP
|
|
.B -s
|
|
set the
|
|
.B src
|
|
field of the message (default is
|
|
.BR plumb ).
|
|
.TP
|
|
.B -d
|
|
set the
|
|
.B dst
|
|
field of the message (default is empty).
|
|
.TP
|
|
.B -t
|
|
set the
|
|
.B type
|
|
field of the message (default is
|
|
.BR text ).
|
|
.TP
|
|
.B -w
|
|
set the
|
|
.B wdir
|
|
field of the message (default is the current working directory of
|
|
.IR plumb ).
|
|
.TP
|
|
.B -i
|
|
take the data from standard input rather than the argument strings.
|
|
If an
|
|
.B action=
|
|
attribute is not otherwise specified,
|
|
.I plumb
|
|
will add an
|
|
.B action=showdata
|
|
attribute to the message.
|
|
.SH FILES
|
|
.TF $HOME/lib/plumbing
|
|
.TP
|
|
.B $HOME/lib/plumbing
|
|
default rules file
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/plumb
|
|
.SH "SEE ALSO"
|
|
.IM plumb (3) ,
|
|
.IM plumber (4) ,
|
|
.IM plumb (7)
|