Add mkfile to keep indices up to date.
Remove man pages for things we don't provide.
This commit is contained in:
rsc
parent
058b0118a5
commit
a19c44b83b
18 changed files with 45 additions and 2321 deletions
104
man/man1/9nm.1
104
man/man1/9nm.1
|
|
@ -1,104 +0,0 @@
|
|||
.TH 9NM 1
|
||||
.SH NAME
|
||||
nm \- name list (symbol table)
|
||||
.SH SYNOPSIS
|
||||
.B nm
|
||||
[
|
||||
.B -aghnsu
|
||||
]
|
||||
.I file ...
|
||||
.SH DESCRIPTION
|
||||
.I Nm
|
||||
prints the name list of each executable or object
|
||||
.I file
|
||||
in the argument list.
|
||||
If the
|
||||
.I file
|
||||
is an archive
|
||||
(see
|
||||
.IR ar (1)),
|
||||
the name list of each file in the archive is printed.
|
||||
If more than one file is given in the argument list,
|
||||
the name of each file is printed at the beginning of each line.
|
||||
.PP
|
||||
Each symbol name is preceded by its hexadecimal
|
||||
value (blanks if undefined)
|
||||
and one of the letters
|
||||
.TP
|
||||
.B T
|
||||
text segment symbol
|
||||
.PD0
|
||||
.TP
|
||||
.B t
|
||||
static text segment symbol
|
||||
.TP
|
||||
.B L
|
||||
leaf function text segment symbol
|
||||
.TP
|
||||
.B l
|
||||
static leaf function text segment symbol
|
||||
.TP
|
||||
.B D
|
||||
data segment symbol
|
||||
.TP
|
||||
.B d
|
||||
static data segment symbol
|
||||
.TP
|
||||
.B B
|
||||
bss segment symbol
|
||||
.TP
|
||||
.B b
|
||||
static bss segment symbol
|
||||
.TP
|
||||
.B a
|
||||
automatic (local) variable symbol
|
||||
.TP
|
||||
.B p
|
||||
function parameter symbol
|
||||
.TP
|
||||
.B z
|
||||
source file name
|
||||
.TP
|
||||
.B Z
|
||||
source file line offset
|
||||
.TP
|
||||
.B f
|
||||
source file name components
|
||||
.PD
|
||||
.PP
|
||||
The output is sorted alphabetically.
|
||||
.PP
|
||||
Options are:
|
||||
.TP
|
||||
.B -a
|
||||
Print all symbols; normally only user-defined text, data,
|
||||
and bss segment symbols are printed.
|
||||
.TP
|
||||
.B -g
|
||||
Print only global
|
||||
.RB ( T ,
|
||||
.BR L ,
|
||||
.BR D ,
|
||||
.BR B )
|
||||
symbols.
|
||||
.TP
|
||||
.B -h
|
||||
Do not print file name headers with output lines.
|
||||
.TP
|
||||
.B -n
|
||||
Sort according to the address of the symbols.
|
||||
.TP
|
||||
.B -s
|
||||
Don't sort; print in symbol-table order.
|
||||
.TP
|
||||
.B -u
|
||||
Print only undefined symbols.
|
||||
.SH SOURCE
|
||||
.B /usr/local/plan9/src/cmd/nm.c
|
||||
.SH SEE ALSO
|
||||
.IR ar (1),
|
||||
.IR 2l (1),
|
||||
.IR db (1),
|
||||
.IR acid (1),
|
||||
.IR a.out (6)
|
||||
|
||||
385
man/man1/9sed.1
385
man/man1/9sed.1
|
|
@ -1,385 +0,0 @@
|
|||
.TH SED 1
|
||||
.SH NAME
|
||||
9sed \- stream editor
|
||||
.SH SYNOPSIS
|
||||
.B 9sed
|
||||
[
|
||||
.B -n
|
||||
]
|
||||
[
|
||||
.B -g
|
||||
]
|
||||
[
|
||||
.B -e
|
||||
.I script
|
||||
]
|
||||
[
|
||||
.B -f
|
||||
.I sfile
|
||||
]
|
||||
[
|
||||
.I file ...
|
||||
]
|
||||
.SH DESCRIPTION
|
||||
.I Sed
|
||||
copies the named
|
||||
.I files
|
||||
(standard input default) to the standard output,
|
||||
edited according to a script of commands.
|
||||
The
|
||||
.B -f
|
||||
option causes the script to be taken from file
|
||||
.IR sfile ;
|
||||
these options accumulate.
|
||||
If there is just one
|
||||
.B -e
|
||||
option and no
|
||||
.BR -f 's,
|
||||
the flag
|
||||
.B -e
|
||||
may be omitted.
|
||||
The
|
||||
.B -n
|
||||
option suppresses the default output;
|
||||
.B -g
|
||||
causes all substitutions to be global, as if suffixed
|
||||
.BR g .
|
||||
.PP
|
||||
A script consists of editing commands, one per line,
|
||||
of the following form:
|
||||
.IP
|
||||
[\fIaddress\fR [\fL,\fI address\fR] ] \fIfunction\fR [\fIargument\fR ...]
|
||||
.PP
|
||||
In normal operation
|
||||
.I sed
|
||||
cyclically copies a line of input into a
|
||||
.I pattern space
|
||||
(unless there is something left after
|
||||
a
|
||||
.L D
|
||||
command),
|
||||
applies in sequence
|
||||
all commands whose
|
||||
.I addresses
|
||||
select that pattern space,
|
||||
and at the end of the script copies the pattern space
|
||||
to the standard output (except under
|
||||
.BR -n )
|
||||
and deletes the pattern space.
|
||||
.PP
|
||||
An
|
||||
.I address
|
||||
is either a decimal number that counts
|
||||
input lines cumulatively across files, a
|
||||
.L $
|
||||
that
|
||||
addresses the last line of input, or a context address,
|
||||
.BI / regular-expression / \f1,
|
||||
in the style of
|
||||
.IR regexp (6),
|
||||
with the added convention that
|
||||
.L \en
|
||||
matches a
|
||||
newline embedded in the pattern space.
|
||||
.PP
|
||||
A command line with no addresses selects every pattern space.
|
||||
.PP
|
||||
A command line with
|
||||
one address selects each pattern space that matches the address.
|
||||
.PP
|
||||
A command line with
|
||||
two addresses selects the inclusive range from the first
|
||||
pattern space that matches the first address through
|
||||
the next pattern space that matches
|
||||
the second.
|
||||
(If the second address is a number less than or equal
|
||||
to the line number first selected, only one
|
||||
line is selected.)
|
||||
Thereafter the process is repeated, looking again for the
|
||||
first address.
|
||||
.PP
|
||||
Editing commands can be applied to non-selected pattern
|
||||
spaces by use of the negation function
|
||||
.L !
|
||||
(below).
|
||||
.PP
|
||||
An argument denoted
|
||||
.I text
|
||||
consists of one or more lines,
|
||||
all but the last of which end with
|
||||
.L \e
|
||||
to hide the
|
||||
newline.
|
||||
Backslashes in text are treated like backslashes
|
||||
in the replacement string of an
|
||||
.L s
|
||||
command,
|
||||
and may be used to protect initial blanks and tabs
|
||||
against the stripping that is done on
|
||||
every script line.
|
||||
.PP
|
||||
An argument denoted
|
||||
.I rfile
|
||||
or
|
||||
.I wfile
|
||||
must terminate the command
|
||||
line and must be preceded by exactly one blank.
|
||||
Each
|
||||
.I wfile
|
||||
is created before processing begins.
|
||||
There can be at most 120 distinct
|
||||
.I wfile
|
||||
arguments.
|
||||
.TP \w'\fL!\ \fIfunction\fLXXX'u
|
||||
.B a\e
|
||||
.br
|
||||
.ns
|
||||
.TP
|
||||
.I text
|
||||
Append.
|
||||
Place
|
||||
.I text
|
||||
on the output before
|
||||
reading the next input line.
|
||||
.TP
|
||||
.BI b " label"
|
||||
Branch to the
|
||||
.B :
|
||||
command bearing the
|
||||
.IR label .
|
||||
If
|
||||
.I label
|
||||
is empty, branch to the end of the script.
|
||||
.TP
|
||||
.B c\e
|
||||
.br
|
||||
.ns
|
||||
.TP
|
||||
.I text
|
||||
Change.
|
||||
Delete the pattern space.
|
||||
With 0 or 1 address or at the end of a 2-address range, place
|
||||
.I text
|
||||
on the output.
|
||||
Start the next cycle.
|
||||
.TP
|
||||
.B d
|
||||
Delete the pattern space.
|
||||
Start the next cycle.
|
||||
.TP
|
||||
.B D
|
||||
Delete the initial segment of the
|
||||
pattern space through the first newline.
|
||||
Start the next cycle.
|
||||
.TP
|
||||
.B g
|
||||
Replace the contents of the pattern space
|
||||
by the contents of the hold space.
|
||||
.TP
|
||||
.B G
|
||||
Append the contents of the hold space to the pattern space.
|
||||
.TP
|
||||
.B h
|
||||
Replace the contents of the hold space by the contents of the pattern space.
|
||||
.TP
|
||||
.B H
|
||||
Append the contents of the pattern space to the hold space.
|
||||
.ne 3
|
||||
.TP
|
||||
.B i\e
|
||||
.br
|
||||
.ns
|
||||
.TP
|
||||
.I text
|
||||
Insert.
|
||||
Place
|
||||
.I text
|
||||
on the standard output.
|
||||
.TP
|
||||
.B n
|
||||
Copy the pattern space to the standard output.
|
||||
Replace the pattern space with the next line of input.
|
||||
.TP
|
||||
.B N
|
||||
Append the next line of input to the pattern space
|
||||
with an embedded newline.
|
||||
(The current line number changes.)
|
||||
.TP
|
||||
.B p
|
||||
Print.
|
||||
Copy the pattern space to the standard output.
|
||||
.TP
|
||||
.B P
|
||||
Copy the initial segment of the pattern space through
|
||||
the first newline to the standard output.
|
||||
.TP
|
||||
.B q
|
||||
Quit.
|
||||
Branch to the end of the script.
|
||||
Do not start a new cycle.
|
||||
.TP
|
||||
.BI r " rfile"
|
||||
Read the contents of
|
||||
.IR rfile .
|
||||
Place them on the output before reading
|
||||
the next input line.
|
||||
.TP
|
||||
.B s/\fIregular-expression\fP/\fIreplacement\fP/\fIflags
|
||||
Substitute the
|
||||
.I replacement
|
||||
string for instances of the
|
||||
.I regular-expression
|
||||
in the pattern space.
|
||||
Any character may be used instead of
|
||||
.LR / .
|
||||
For a fuller description see
|
||||
.IR regexp (6).
|
||||
.I Flags
|
||||
is zero or more of
|
||||
.RS
|
||||
.TP
|
||||
.B g
|
||||
Global.
|
||||
Substitute for all non-overlapping instances of the
|
||||
.I regular expression
|
||||
rather than just the
|
||||
first one.
|
||||
.TP
|
||||
.B p
|
||||
Print the pattern space if a replacement was made.
|
||||
.TP
|
||||
.BI w " wfile"
|
||||
Write.
|
||||
Append the pattern space to
|
||||
.I wfile
|
||||
if a replacement
|
||||
was made.
|
||||
.RE
|
||||
.TP
|
||||
.BI t " label"
|
||||
Test.
|
||||
Branch to the
|
||||
.L :
|
||||
command bearing the
|
||||
.I label
|
||||
if any
|
||||
substitutions have been made since the most recent
|
||||
reading of an input line or execution of a
|
||||
.LR t .
|
||||
If
|
||||
.I label
|
||||
is empty, branch to the end of the script.
|
||||
.TP
|
||||
.B w
|
||||
.I wfile
|
||||
.br
|
||||
Write.
|
||||
Append the pattern space to
|
||||
.IR wfile .
|
||||
.TP
|
||||
.B x
|
||||
Exchange the contents of the pattern and hold spaces.
|
||||
.TP
|
||||
.B y/\fIstring1\fP/\fIstring2\fP/
|
||||
Transform.
|
||||
Replace all occurrences of characters in
|
||||
.I string1
|
||||
with the corresponding character in
|
||||
.IR string2 .
|
||||
The lengths of
|
||||
.I
|
||||
string1
|
||||
and
|
||||
.I string2
|
||||
must be equal.
|
||||
.TP
|
||||
.BI ! "function"
|
||||
Don't.
|
||||
Apply the
|
||||
.I function
|
||||
(or group, if
|
||||
.I function
|
||||
is
|
||||
.LR { )
|
||||
only to lines
|
||||
.I not
|
||||
selected by the address(es).
|
||||
.TP
|
||||
.BI : " label"
|
||||
This command does nothing; it bears a
|
||||
.I label
|
||||
for
|
||||
.B b
|
||||
and
|
||||
.B t
|
||||
commands to branch to.
|
||||
.TP
|
||||
.B =
|
||||
Place the current line number on the standard output as a line.
|
||||
.TP
|
||||
.B {
|
||||
Execute the following commands through a matching
|
||||
.L }
|
||||
only when the pattern space is selected.
|
||||
.TP
|
||||
.B " "
|
||||
An empty command is ignored.
|
||||
.ne 4
|
||||
.SH EXAMPLES
|
||||
.TP
|
||||
.B sed 10q file
|
||||
Print the first 10 lines of the file.
|
||||
.TP
|
||||
.B sed '/^$/d'
|
||||
Delete empty lines from standard input.
|
||||
.TP
|
||||
.B sed 's/UNIX/& system/g'
|
||||
Replace every instance of
|
||||
.L UNIX
|
||||
by
|
||||
.LR "UNIX system" .
|
||||
.PP
|
||||
.EX
|
||||
sed 's/ *$// \fRdrop trailing blanks\fP
|
||||
/^$/d \fRdrop empty lines\fP
|
||||
s/ */\e \fRreplace blanks by newlines\fP
|
||||
/g
|
||||
/^$/d' chapter*
|
||||
.EE
|
||||
.ns
|
||||
.IP
|
||||
Print the files
|
||||
.BR chapter1 ,
|
||||
.BR chapter2 ,
|
||||
etc. one word to a line.
|
||||
.PP
|
||||
.EX
|
||||
nroff -ms manuscript | sed '
|
||||
${
|
||||
/^$/p \fRif last line of file is empty, print it\fP
|
||||
}
|
||||
//N \fRif current line is empty, append next line\fP
|
||||
/^\en$/D' \fRif two lines are empty, delete the first\fP
|
||||
.EE
|
||||
.ns
|
||||
.IP
|
||||
Delete all but one of each group of empty lines from a
|
||||
formatted manuscript.
|
||||
.SH SOURCE
|
||||
.B /usr/local/plan9/src/cmd/sed.c
|
||||
.SH SEE ALSO
|
||||
.IR ed (1),
|
||||
.IR grep (1),
|
||||
.IR awk (1),
|
||||
.IR lex (1),
|
||||
.IR sam (1),
|
||||
.IR regexp (6)
|
||||
.br
|
||||
L. E. McMahon,
|
||||
`SED \(em A Non-interactive Text Editor',
|
||||
Unix Research System Programmer's Manual, Volume 2.
|
||||
.SH BUGS
|
||||
If input is from a pipe, buffering may consume
|
||||
characters beyond a line on which a
|
||||
.L q
|
||||
command is executed.
|
||||
118
man/man1/tar.1
118
man/man1/tar.1
|
|
@ -1,118 +0,0 @@
|
|||
.TH TAR 1
|
||||
.SH NAME
|
||||
tar \- archiver
|
||||
.SH SYNOPSIS
|
||||
.B tar
|
||||
.I key
|
||||
[
|
||||
.I file ...
|
||||
]
|
||||
.SH DESCRIPTION
|
||||
.PP
|
||||
.I Tar
|
||||
saves and restores file trees.
|
||||
It is most often used to transport a tree of files from one
|
||||
system to another.
|
||||
The
|
||||
.I key
|
||||
is a string that contains
|
||||
at most one function letter plus optional modifiers.
|
||||
Other arguments to the command are names of
|
||||
files or directories to be dumped or restored.
|
||||
A directory name implies all the contained
|
||||
files and subdirectories (recursively).
|
||||
.PP
|
||||
The function is one of the following letters:
|
||||
.TP
|
||||
.B c
|
||||
Create a new archive with the given files as contents.
|
||||
.TP
|
||||
.B x
|
||||
Extract the named files from the archive.
|
||||
If a file is a directory, the directory is extracted recursively.
|
||||
Modes are restored if possible.
|
||||
If no file argument is given, extract the entire archive.
|
||||
If the archive contains multiple entries for a file,
|
||||
the latest one wins.
|
||||
.TP
|
||||
.B t
|
||||
List all occurrences of each
|
||||
.I file
|
||||
in the archive, or of all files if there are no
|
||||
.I file
|
||||
arguments.
|
||||
.TP
|
||||
.B r
|
||||
The named files
|
||||
are appended to the archive.
|
||||
.PP
|
||||
The modifiers are:
|
||||
.TP
|
||||
.B v
|
||||
(verbose)
|
||||
Print the name of each file treated
|
||||
preceded by the function letter.
|
||||
With
|
||||
.BR t ,
|
||||
give more details about the
|
||||
archive entries.
|
||||
.TP
|
||||
.B f
|
||||
Use the next argument as the name of the archive instead of
|
||||
the default standard input (for keys
|
||||
.B x
|
||||
and
|
||||
.BR t )
|
||||
or standard output (for keys
|
||||
.B c
|
||||
and
|
||||
.BR r ).
|
||||
.TP
|
||||
.B u
|
||||
Use the next (numeric) argument as the user id for files in
|
||||
the output archive. This is only useful when moving files to
|
||||
a non-Plan 9 system.
|
||||
.TP
|
||||
.B g
|
||||
Use the next (numeric) argument as the group id for files in
|
||||
the output archive.
|
||||
.TP
|
||||
.B p
|
||||
Create archive in POSIX ustar format,
|
||||
which raises the maximum pathname length from 100 to 256 bytes.
|
||||
Ustar archives are recognised automatically by
|
||||
.I tar
|
||||
when reading archives.
|
||||
.TP
|
||||
.B R
|
||||
When extracting, ignore leading slash on file names,
|
||||
i.e., extract all files relative to the current directory.
|
||||
.TP
|
||||
.B T
|
||||
Modifies the behavior of
|
||||
.B x
|
||||
to set the mode and modified time
|
||||
of each file to that specified in the archive.
|
||||
.SH EXAMPLES
|
||||
.I Tar
|
||||
can be used to copy hierarchies thus:
|
||||
.IP
|
||||
.EX
|
||||
@{cd fromdir && tar cp .} | @{cd todir && tar xT}
|
||||
.EE
|
||||
.SH SOURCE
|
||||
.B /usr/local/plan9/src/cmd/tar.c
|
||||
.SH SEE ALSO
|
||||
.IR ar (1),
|
||||
.IR bundle (1),
|
||||
.IR tapefs (1)
|
||||
.SH BUGS
|
||||
There is no way to ask for any but the last
|
||||
occurrence of a file.
|
||||
.br
|
||||
File path names are limited to
|
||||
100 characters
|
||||
(256 when using ustar format).
|
||||
.br
|
||||
The tar format allows specification of links and symbolic links,
|
||||
concepts foreign to Plan 9: they are ignored.
|
||||
Loading…
Add table
Add a link
Reference in a new issue