diff options
author | rsc <devnull@localhost> | 2005-01-03 06:41:38 +0000 |
---|---|---|
committer | rsc <devnull@localhost> | 2005-01-03 06:41:38 +0000 |
commit | a19c44b83b96fefad131ef324c3eb2916e8c604c (patch) | |
tree | 9fee0b867751c0b9fe63a2763067c2e37403a866 /man/man1 | |
parent | 058b0118a52061ad57694c01fc8763b22b789c4d (diff) | |
download | plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.gz plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.tar.bz2 plan9port-a19c44b83b96fefad131ef324c3eb2916e8c604c.zip |
Add mkfile to keep indices up to date.
Remove man pages for things we don't provide.
Diffstat (limited to 'man/man1')
-rw-r--r-- | man/man1/9nm.1 | 104 | ||||
-rw-r--r-- | man/man1/9sed.1 | 385 | ||||
-rw-r--r-- | man/man1/tar.1 | 118 |
3 files changed, 0 insertions, 607 deletions
diff --git a/man/man1/9nm.1 b/man/man1/9nm.1 deleted file mode 100644 index 5841043c..00000000 --- a/man/man1/9nm.1 +++ /dev/null @@ -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) - diff --git a/man/man1/9sed.1 b/man/man1/9sed.1 deleted file mode 100644 index 2f4345ca..00000000 --- a/man/man1/9sed.1 +++ /dev/null @@ -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. diff --git a/man/man1/tar.1 b/man/man1/tar.1 deleted file mode 100644 index 00ac0414..00000000 --- a/man/man1/tar.1 +++ /dev/null @@ -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. |