diff --git a/man/man1/Makefile b/man/man1/Makefile index 3f2fc78ec..89a0d30b9 100644 --- a/man/man1/Makefile +++ b/man/man1/Makefile @@ -14,9 +14,9 @@ MAN= acd.1 anm.1 ar.1 ash.1 asize.1 at.1 banner.1 basename.1 \ man.1 mdb.1 mesg.1 mixer.1 mkdep.1 mkdir.1 mkfifo.1 mkfs.1 \ mkproto.1 modem.1 mount.1 mt.1 nice.1 nm.1 nohup.1 od.1 \ ossinfo.1 ossmix.1 ossplay.1 ossrecord.1 osstest.1 passwd.1 \ - paste.1 patch.1 ping.1 playwave.1 postmort.1 pr.1 prep.1 \ + paste.1 ping.1 playwave.1 postmort.1 pr.1 prep.1 \ profile.1 ps.1 pwd.1 rcp.1 readall.1 readfs.1 recwave.1 \ - ref.1 remsync.1 rget.1 rlogin.1 rmdir.1 rsh.1 rz.1 sed.1 \ + ref.1 remsync.1 rget.1 rlogin.1 rmdir.1 rsh.1 rz.1 \ shar.1 size.1 sleep.1 sort.1 soundoff.1 soundon.1 spell.1 \ split.1 stat.1 strings.1 strip.1 stty.1 su.1 sum.1 svc.1 \ synctree.1 sysenv.1 sz.1 tail.1 tee.1 telnet.1 template.1 \ diff --git a/man/man1/patch.1 b/man/man1/patch.1 deleted file mode 100644 index 25cd85d07..000000000 --- a/man/man1/patch.1 +++ /dev/null @@ -1,555 +0,0 @@ -.\" -*- nroff -*- -.rn '' }` -'\" $Header$ -'\" -'\" $Log$ -'\" Revision 1.1 2005/05/02 13:01:39 beng -'\" Added man pages. -'\" -'\" Revision 2.0.1.2 88/06/22 20:47:18 lwall -'\" patch12: now avoids Bell System Logo -'\" -'\" Revision 2.0.1.1 88/06/03 15:12:51 lwall -'\" patch10: -B switch was contributed. -'\" -'\" Revision 2.0 86/09/17 15:39:09 lwall -'\" Baseline for netwide release. -'\" -'\" Revision 1.4 86/08/01 19:23:22 lwall -'\" Documented -v, -p, -F. -'\" Added notes to patch senders. -'\" -'\" Revision 1.3 85/03/26 15:11:06 lwall -'\" Frozen. -'\" -'\" Revision 1.2.1.4 85/03/12 16:14:27 lwall -'\" Documented -p. -'\" -'\" Revision 1.2.1.3 85/03/12 16:09:41 lwall -'\" Documented -D. -'\" -'\" Revision 1.2.1.2 84/12/05 11:06:55 lwall -'\" Added -l switch, and noted bistability bug. -'\" -'\" Revision 1.2.1.1 84/12/04 17:23:39 lwall -'\" Branch for sdcrdcf changes. -'\" -'\" Revision 1.2 84/12/04 17:22:02 lwall -'\" Baseline version. -'\" -.de Sh -.br -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp -.if t .sp .5v -.if n .sp -.. -'\" -'\" Set up \*(-- to give an unbreakable dash; -'\" string Tr holds user defined translation string. -'\" Bell System Logo is used as a dummy character. -'\" -'\" Shut up a groff -ww warning. -'\".if \n(.g .if !dTr .ds Tr -'\".ie n \{\ -.tr \(*W-\*(Tr -'\".ds -- \(*W- -'\".if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -'\".if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -.ds L" "" -.ds R" "" -.ds L' ' -.ds R' ' -'\"'br \} -'\".el \{\ -.ds -- \(em\| -.tr \*(Tr -.ds L" `` -.ds R" '' -.ds L' ` -.ds R' ' -'\"'br\} -.TH PATCH 1 LOCAL -.SH NAME -patch - apply a diff file to an original -.SH SYNOPSIS -.B patch -[options] [origfile [patchfile]] [+ [options] [origfile]]... -.sp -but usually just -.sp -.B patch - -sets the maximum fuzz factor. -This switch only applies to context diffs, and causes -.I patch -to ignore up to that many lines in looking for places to install a hunk. -Note that a larger fuzz factor increases the odds of a faulty patch. -The default fuzz factor is 2, and it may not be set to more than -the number of lines of context in the context diff, ordinarily 3. -.TP 5 -.B \-l -causes the pattern matching to be done loosely, in case the tabs and -spaces have been munged in your input file. -Any sequence of whitespace in the pattern line will match any sequence -in the input file. -Normal characters must still match exactly. -Each line of the context must still match a line in the input file. -.TP 5 -.B \-n -forces -.I patch -to interpret the patch file as a normal diff. -.TP 5 -.B \-N -causes -.I patch -to ignore patches that it thinks are reversed or already applied. -See also -.B \-R . -.TP 5 -.B \-o -causes the next argument to be interpreted as the output file name. -.TP 5 -.B \-p -sets the pathname strip count, -which controls how pathnames found in the patch file are treated, in case -the you keep your files in a different directory than the person who sent -out the patch. -The strip count specifies how many slashes are to be stripped from -the front of the pathname. -(Any intervening directory names also go away.) -For example, supposing the filename in the patch file was -.sp - /u/howard/src/blurfl/blurfl.c -.sp -setting -.B \-p -or -.B \-p0 -gives the entire pathname unmodified, -.B \-p1 -gives -.sp - u/howard/src/blurfl/blurfl.c -.sp -without the leading slash, -.B \-p4 -gives -.sp - blurfl/blurfl.c -.sp -and not specifying -.B \-p -at all just gives you "blurfl.c", unless all of the directories in the -leading path (u/howard/src/blurfl) exist and that path is relative, -in which case you get the entire pathname unmodified. -Whatever you end up with is looked for either in the current directory, -or the directory specified by the -.B \-d -switch. -.TP 5 -.B \-r -causes the next argument to be interpreted as the reject file name. -.TP 5 -.B \-R -tells -.I patch -that this patch was created with the old and new files swapped. -(Yes, I'm afraid that does happen occasionally, human nature being what it -is.) -.I Patch -will attempt to swap each hunk around before applying it. -Rejects will come out in the swapped format. -The -.B \-R -switch will not work with ed diff scripts because there is too little -information to reconstruct the reverse operation. -.Sp -If the first hunk of a patch fails, -.I patch -will reverse the hunk to see if it can be applied that way. -If it can, you will be asked if you want to have the -.B \-R -switch set. -If it can't, the patch will continue to be applied normally. -(Note: this method cannot detect a reversed patch if it is a normal diff -and if the first command is an append (i.e. it should have been a delete) -since appends always succeed, due to the fact that a null context will match -anywhere. -Luckily, most patches add or change lines rather than delete them, so most -reversed normal diffs will begin with a delete, which will fail, triggering -the heuristic.) -.TP 5 -.B \-s -makes -.I patch -do its work silently, unless an error occurs. -.TP 5 -.B \-S -causes -.I patch -to ignore this patch from the patch file, but continue on looking -for the next patch in the file. -Thus -.sp - patch -S + -S + -sets internal debugging flags, and is of interest only to -.I patch -patchers. -.SH AUTHOR -Larry Wall -.br -with many other contributors. -.SH ENVIRONMENT -.TP -.B TMPDIR -Directory to put temporary files in; default is /tmp. -.TP -.B SIMPLE_BACKUP_SUFFIX -Extension to use for backup file names instead of \*(L".orig\*(R" or -\*(L"~\*(R". -.TP -.B VERSION_CONTROL -Selects when numbered backup files are made. -.SH FILES -$TMPDIR/patch* -.SH SEE ALSO -diff(1) -.SH NOTES FOR PATCH SENDERS -There are several things you should bear in mind if you are going to -be sending out patches. -First, you can save people a lot of grief by keeping a patchlevel.h file -which is patched to increment the patch level as the first diff in the -patch file you send out. -If you put a Prereq: line in with the patch, it won't let them apply -patches out of order without some warning. -Second, make sure you've specified the filenames right, either in a -context diff header, or with an Index: line. -If you are patching something in a subdirectory, be sure to tell the patch -user to specify a -.B \-p -switch as needed. -Third, you can create a file by sending out a diff that compares a -null file to the file you want to create. -This will only work if the file you want to create doesn't exist already in -the target directory. -Fourth, take care not to send out reversed patches, since it makes people wonder -whether they already applied the patch. -Fifth, while you may be able to get away with putting 582 diff listings into -one file, it is probably wiser to group related patches into separate files in -case something goes haywire. -.SH DIAGNOSTICS -Too many to list here, but generally indicative that -.I patch -couldn't parse your patch file. -.PP -The message \*(L"Hmm...\*(R" indicates that there is unprocessed text in -the patch file and that -.I patch -is attempting to intuit whether there is a patch in that text and, if so, -what kind of patch it is. -.PP -.I Patch -will exit with a non-zero status if any reject files were created. -When applying a set of patches in a loop it behooves you to check this -exit status so you don't apply a later patch to a partially patched file. -.SH CAVEATS -.I Patch -cannot tell if the line numbers are off in an ed script, and can only detect -bad line numbers in a normal diff when it finds a \*(L"change\*(R" or -a \*(L"delete\*(R" command. -A context diff using fuzz factor 3 may have the same problem. -Until a suitable interactive interface is added, you should probably do -a context diff in these cases to see if the changes made sense. -Of course, compiling without errors is a pretty good indication that the patch -worked, but not always. -.PP -.I Patch -usually produces the correct results, even when it has to do a lot of -guessing. -However, the results are guaranteed to be correct only when the patch is -applied to exactly the same version of the file that the patch was -generated from. -.SH BUGS -Could be smarter about partial matches, excessively \&deviant offsets and -swapped code, but that would take an extra pass. -.PP -If code has been duplicated (for instance with #ifdef OLDCODE ... #else ... -#endif), -.I patch -is incapable of patching both versions, and, if it works at all, will likely -patch the wrong one, and tell you that it succeeded to boot. -.PP -If you apply a patch you've already applied, -.I patch -will think it is a reversed patch, and offer to un-apply the patch. -This could be construed as a feature. -.rn }` '' diff --git a/man/man1/sed.1 b/man/man1/sed.1 deleted file mode 100644 index 137af30fc..000000000 --- a/man/man1/sed.1 +++ /dev/null @@ -1,283 +0,0 @@ -.TH sed 1 "March 30, 2006" -.SH NAME -sed \- the stream editor -.SH SYNOPSIS -sed [-n] [-g] [-e script ] [-f sfile ] [ file ] ... -.SH DESCRIPTION -Sed copies the named files (standard input default) to the standard -output, edited according to a script of commands. -.P -An -e option supplies a single edit command from the next argument; -if there are several of these they are executed in the order in which -they appear. If there is just one -e option and no -f 's, the -e flag -may be omitted. -.P -An -f option causes commands to be taken from the file "sfile"; if -there are several of these they are executed in the order in which -they appear; -e and -f commands may be mixed. -.P -The -g option causes sed to act as though every substitute command -in the script has a g suffix. -.P -The -n option suppresses the default output. -.P -A script consists of commands, one per line, of the following form: - - [address [, address] ] function [arguments] - -Normally sed cyclically copies a line of input into a current text -buffer, then applies all commands whose addresses select the buffer in -sequence, then copies the buffer to standard output and clears it. -.P -The -n option suppresses normal output (so that only p and w output -is done). Also, some commands (n, N) do their own line reads, and some -others (d, D) cause all commands following in the script to be skipped -(the D command also suppresses the clearing of the current text buffer -that would normally occur before the next cycle). -.P -It is also helpful to know that there's a second buffer (called the `hold -space' that can be copied or appended to or from or swapped with -the current text buffer. -.P -An address is: a decimal numeral (which matches the line it numbers where line -numbers start at 1 and run cumulatively across files), or a `$' that addresses -the last line of input, or a context address, which is a `/regular -expression/', in the style of ed (1) modified thus: -.P -.TP 5 -(1) -The escape sequence `\\n' matches a newline embedded in the buffer, -and `\\t' matches a tab. -.TP 5 -(2) -A command line with no addresses selects every buffer. -.TP 5 -(3) -A command line with one address selects every buffer that matches -that address. -.TP 5 -(4) -A command line with two addresses selects the inclusive range from -the first input buffer that matches the first address through the -next input buffer 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.) Once the second address is matched sed -starts looking for the first one again; thus, any number of these -ranges will be matched. -.P -The negation operator '!' can prefix a command to apply it to every -line not selected by the address(es). -.P -In the following list of functions, the maximum number of addresses -permitted for each function is indicated in parentheses. -.P -An argument denoted "text" consists of one or more lines, with all -but the last ending with `\' to hide the newline. -.P -Backslashes in text are treated like backslashes in the replacement -string of an `s' command and may be used to protect initial whitespace -(blanks and tabs) against the stripping that is done on every line of -the script. -.P -An argument denoted "rfile" or "wfile" must be last on the command -line. Each wfile is created before processing begins. There can be at -most 10 distinct wfile arguments. -.TP 5 -a "text" (1) -Append. Place text on output before reading the next input line. -.TP 5 -b "label" (2) -Branch to the `:' command bearing the label. If no label is given, -branch to the end of the script. -.TP 5 -c "text" (2) -Change. Delete the current text buffer. With 0 or 1 address, or at -the end of a 2-address range, place text on the output. Start the next -cycle. -.TP 5 -d (2) -Delete the current text buffer. Start the next cycle. -.TP 5 -D (2) -Delete the first line of the current text buffer (all chars up to the -first newline). Start the next cycle. -.TP 5 -g (2) -Replace the contents of the current text buffer with the contents of -the hold space. -.TP 5 -G (2) -Append the contents of the hold space to the current text buffer. -.TP 5 -h (2) -Copy the current text buffer into the hold space. -.TP 5 -H (2) -Append a copy of the current text buffer to the hold space. -.TP 5 -i "text" (1) -Insert. Place text on the standard output. -.TP 5 -l (2) -List. Sends the pattern space to standard output. A "w" option may -follow as in the s command below. Non-printable characters expand to: - - \\b -- backspace (ASCII 08) - \\t -- tab (ASCII 09) - \\n -- newline (ASCII 10) - \\r -- return (ASCII 13) - \\e -- escape (ASCII 27) - \\xx -- the ASCII character corresponding to 2 hex digits xx. -.TP 5 -Dump. Hex-dump the pattern space to standard output. -.TP 5 -n (2) -Copy the current text buffer to standard output. Read the next line -of input into it. -.TP 5 -N (2) -Append the next line of input to the current text buffer, inserting -an embedded newline between the two. The current line number changes. -.TP 5 -p (2) -Print. Copy the current text buffer to the standard output. -.TP 5 -P (2) -Copy the first line of the current text buffer (all chars up to the -first newline) to standard output. -.TP 5 -q (1) -Quit. Branch to the end of the script. Do not start a new cycle. -.TP 5 -r "rfile" (1) -Read the contents of rfile. Place them on the output before reading -the next input line. -.TP 5 -s /regular expression/replacement/flags (2) -Substitute the replacement for instances of the regular expression -in the current text buffer. Any character may be used instead of `/'. -For a fuller description see ed (1). -Flags is zero or more of the following: - -g -- Global. Substitute for all nonoverlapping instances of the string - rather than just the first one. - -p -- Print the pattern space if a replacement was made. - -w -- Write. Append the current text buffer to a file argument as in a - w command if a replacement is made. Standard output is used if no - file argument is given - -.TP 5 -t "label" (2) -Branch-if-test. Branch to the : command with the given label if any -substitutes have been made since the most recent read of an input line -or execution of a `t'or `T'. If no label is given, branch to the end -of the script. -.TP 5 -T "label" (2) -Branch-on-error. Branch to the : command with the given label if no -substitutes have succeeded since the last input line or t or T command. -Branch to the end of the script if no label is given. -.TP 5 -w "wfile" (2) -Write. Append the current text buffer to wfile . -.TP 5 -W "wfile" (2) -Write first line. Append first line of the current text buffer -to wfile. -.TP 5 -x (2) -Exchange the contents of the current text buffer and hold space. -.TP 5 -y /string1/string2/ (2) -Translate. Replace each occurrence of a character in string1 with -the corresponding character in string2. The lengths of these strings -must be equal. -.TP 5 -! "command" (2) -All-but. Apply the function (or group, if function is `{') only to -lines not selected by the address(es). -.TP 5 -: "label" (0) -This command does nothing but hold a label for `b' and `t' commands -to branch to. -.TP 5 -= (1) -Place the current line number on the standard output as a line. -.TP 5 -{ (2) -Execute the following commands through a matching `}' only when the -current line matches the address or address range given. -.P -An empty command is ignored. -.P -.SH PORTABILITY -This tool was reverse-engineered from BSD 4.1 UNIX sed, and (as far -as the author's knowledge and tests can determine) is compatible with -it. All documented features of BSD 4.1 sed are supported. -.P -One undocumented feature (a leading 'n' in the first comment having -the same effect as an -n command-line option) has been omitted. -.P -The following bugs and limitations have been fixed: -.TP 5 -* -There is no hidden length limit (40 in BSD sed) on w file names. -.TP 5 -* -There is no limit (8 in BSD sed) on the length of labels. -.TP 5 -* -The exchange command now works for long pattern and hold spaces. -.P -The following enhancements to existing commands have been made: -.TP 5 -* -a, i commands don't insist on a leading backslash-\\n in the text. -.TP 5 -* -r, w commands don't insist on whitespace before the filename. -.TP 5 -* -The g, p and P options on s commands may be given in any order. -.P -Some enhancements to regular-expression syntax have been made: -.TP 5 -* -\\t is recognized in REs (and elswhere) as an escape for tab. -.TP 5 -* -In an RE, + calls for 1..n repeats of the previous pattern. -.P -The following are completely new features: -.TP 5 -* -The l command (list, undocumented and weaker in BSD) -.TP 5 -The 'L' command (hex dump). -.TP 5 -* -The W command (write first line of pattern space to file). -.TP 5 -* -The T command (branch on last substitute failed). -.TP 5 -* -Trailing comments are now allowed on command lines. -.P -In addition, sed's error messages have been made more specific and -informative. -.P -The implementation is also significantly smaller and faster than -BSD 4.1 sed. It uses only the standard I/O library and exit(3). -.P -.SH SEE ALSO -.P -ed(1), grep(1), awk(1), lex(1), regexp(5) -.P -.SH AUTHOR -Eric S. Raymond and Rene Rebe . -This program is distributed under the GPL. - -