patch(1): add the manpage
forgot it in the last commit
This commit is contained in:
parent
07e1620911
commit
9e547f50d1
1 changed files with 90 additions and 0 deletions
90
sys/man/1/patch
Normal file
90
sys/man/1/patch
Normal file
|
@ -0,0 +1,90 @@
|
|||
.TH PATCH 1
|
||||
.SH NAME
|
||||
patch \- apply diffs
|
||||
.SH SYNOPSIS
|
||||
.B patch
|
||||
[
|
||||
.B -lR
|
||||
]
|
||||
[
|
||||
.B -p
|
||||
.I nstrip
|
||||
]
|
||||
[
|
||||
.B -f
|
||||
.I maxfuzz
|
||||
]
|
||||
[
|
||||
.I patch ...
|
||||
]
|
||||
.SH DESCRIPTION
|
||||
.I Patch
|
||||
scans its input for a sequence of patches, and applies them, printing the list of changed files.
|
||||
When an applied patch does not match precisely,
|
||||
.I patch
|
||||
will scan the input file for matching context, applying the patch up to 250 lines away from
|
||||
its original location.
|
||||
If a hunk does not apply, then the file is left untouched.
|
||||
.PP
|
||||
The following options are supported:
|
||||
.TP
|
||||
.B -R
|
||||
Reverse direction of the patch. Additions become removals,
|
||||
and the new and old file names are swapped.
|
||||
.TP
|
||||
.BI -p \ nstrip
|
||||
Remove the prefix containing
|
||||
.I nstrip
|
||||
leading slashes from each file path in the diff file.
|
||||
.SH INPUT FORMAT
|
||||
A patch begins with a patch header, and is followed by a sequence of one or more hunks.
|
||||
All lines before a patch header or after the last hunk of a patch are comments,
|
||||
and are ignored by patch. A patch header is a sequence of 2 lines in the following
|
||||
format:
|
||||
.IP
|
||||
.EX
|
||||
--- oldfile [trailing text]
|
||||
+++ newfile [trailing text]
|
||||
.EE
|
||||
.PP
|
||||
A hunk must immediately follow a patch header or another hunk.
|
||||
It begins with a header line in the following format:
|
||||
.IP
|
||||
.EX
|
||||
@@ -count,addr +count,addr @@
|
||||
.EE
|
||||
.PP
|
||||
And contains a sequence of lines beginning with a
|
||||
.LR - ,
|
||||
.LR + ,
|
||||
or space characters.
|
||||
A
|
||||
.L -
|
||||
indicates that the line is to be removed from the old file.
|
||||
A
|
||||
.L +
|
||||
indicates that the line is to be inserted into the new file.
|
||||
A space indicates that the line is context.
|
||||
It will be copied unchanged from the old file to the new file.
|
||||
.PP
|
||||
If the old file is
|
||||
.LR /dev/null ,
|
||||
the patch indicates a file creation.
|
||||
If the new file is
|
||||
.LR /dev/null ,
|
||||
the patch indicates a file deletion.
|
||||
In this case, the file printed is the file being removed.
|
||||
.SH SEE ALSO
|
||||
.IR diff (1),
|
||||
.IR git/export (1)
|
||||
.SH BUGS
|
||||
.PP
|
||||
The output of
|
||||
.B diff -c
|
||||
is not handled.
|
||||
.PP
|
||||
Reject files and backups are not supported.
|
||||
.PP
|
||||
All files are processed in memory, limiting the maximum file size to available RAM.
|
||||
|
||||
|
Loading…
Reference in a new issue