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.
142 lines
1.7 KiB
Groff
142 lines
1.7 KiB
Groff
.TH 9 1
|
||
.SH NAME
|
||
9, 9.rc, u, u.rc \- run Plan 9 or Unix commands
|
||
.SH SYNOPSIS
|
||
.B 9
|
||
.I cmd
|
||
[
|
||
.I args
|
||
\&...
|
||
]
|
||
.PP
|
||
.B .
|
||
.B 9
|
||
(from
|
||
.IM sh (1) )
|
||
.PP
|
||
.B 9.rc
|
||
.I cmd
|
||
[
|
||
.I args
|
||
\&...
|
||
]
|
||
.PP
|
||
.B .
|
||
.B 9.rc
|
||
(from
|
||
.IM rc (1) )
|
||
.PP
|
||
.B u
|
||
.I cmd
|
||
[
|
||
.I args
|
||
\&...
|
||
]
|
||
.PP
|
||
.B .
|
||
.B u
|
||
(from
|
||
.IM sh (1) )
|
||
.PP
|
||
.B u.rc
|
||
.I cmd
|
||
[
|
||
.I args
|
||
\&...
|
||
]
|
||
.PP
|
||
.B .
|
||
.B u.rc
|
||
(from
|
||
.IM rc (1) )
|
||
.SH DESCRIPTION
|
||
Because Plan 9 supplies commands with the same name as but different
|
||
behavior than many basic Unix system commands
|
||
(e.g.,
|
||
.BR grep ,
|
||
.BR sed ,
|
||
.BR mkdir ,
|
||
.BR rm ),
|
||
it is not recommended to run with the Plan 9 bin directory
|
||
ahead of the system directories.
|
||
.PP
|
||
.I 9
|
||
is a shell script that sets up a Plan 9 environment and runs
|
||
.I cmd .
|
||
It sets
|
||
.B $PLAN9
|
||
if necessary
|
||
and adds
|
||
.B $PLAN9/bin
|
||
to the beginning of
|
||
.B $PATH
|
||
before running
|
||
.IR cmd .
|
||
.PP
|
||
If run with no arguments,
|
||
.B 9
|
||
does not do anything, so it can be invoked from
|
||
.IR sh -style
|
||
shells using
|
||
.B .
|
||
.B 9
|
||
in order to make the current shell start running in the Plan 9 environment.
|
||
.PP
|
||
.I 9.rc
|
||
is the same as
|
||
.I 9
|
||
but written for use by the shell
|
||
.IM rc (1) .
|
||
.PP
|
||
.I U
|
||
and
|
||
.I u.rc
|
||
are the inverse of
|
||
.I 9
|
||
and
|
||
.IR 9.rc :
|
||
they move
|
||
.B $PLAN9/bin
|
||
to the end of the path.
|
||
.SH EXAMPLES
|
||
Search for greek in the password file:
|
||
.IP
|
||
.EX
|
||
$ 9 grep '[α-ζ]' /etc/passwd
|
||
.EE
|
||
.PP
|
||
Start an
|
||
.IM rc (1)
|
||
with the Plan 9 commands in the path before the system commands,
|
||
and then run the Unix
|
||
.IR ls :
|
||
.IP
|
||
.EX
|
||
$ 9 rc
|
||
% u ls
|
||
.EE
|
||
.SH SOURCE
|
||
.B \*9/bin/9
|
||
.br
|
||
.B \*9/bin/9.rc
|
||
.br
|
||
.B \*9/bin/u
|
||
.br
|
||
.B \*9/bin/u.rc
|
||
.SH SEE ALSO
|
||
.IM intro (1)
|
||
.SH BUGS
|
||
Some shell configurations
|
||
(notably, oh-my-zsh)
|
||
define
|
||
.B 9
|
||
as an alias for
|
||
.B cd
|
||
.BR \-9 ,
|
||
which makes the
|
||
.I 9
|
||
command described here inaccessible.
|
||
In such shells, it is necessary to
|
||
.B unalias
|
||
.B 9
|
||
in your initialization scripts.
|