| 1 |
.\" Automatically generated by Pandoc 3.1.11.1 |
| 2 |
.\" |
| 3 |
.TH "GENDIFF" "1" "Mon Jan 10 2000" "" "" |
| 4 |
.SH NAME |
| 5 |
gendiff \- utility to aid in error\-free diff file generation |
| 6 |
.SH SYNOPSIS |
| 7 |
\f[B]gendiff\f[R] <directory> <diff\-extension> |
| 8 |
.SH DESCRIPTION |
| 9 |
\f[B]gendiff\f[R] is a rather simple script which aids in generating a |
| 10 |
diff file from a single directory. |
| 11 |
It takes a directory name and a \[dq]diff\-extension\[dq] as its only |
| 12 |
arguments. |
| 13 |
The diff extension should be a unique sequence of characters added to |
| 14 |
the end of all original, unmodified files. |
| 15 |
The output of the program is a diff file which may be applied with the |
| 16 |
\f[B]patch\f[R] program to recreate the changes. |
| 17 |
.PP |
| 18 |
The usual sequence of events for creating a diff is to create two |
| 19 |
identical directories, make changes in one directory, and then use the |
| 20 |
\f[B]diff\f[R] utility to create a list of differences between the two. |
| 21 |
Using gendiff eliminates the need for the extra, original and unmodified |
| 22 |
directory copy. |
| 23 |
Instead, only the individual files that are modified need to be saved. |
| 24 |
.PP |
| 25 |
Before editing a file, copy the file, appending the extension you have |
| 26 |
chosen to the filename. |
| 27 |
I.e. |
| 28 |
if you were going to edit somefile.cpp and have chosen the extension |
| 29 |
\[dq]fix\[dq], copy it to somefile.cpp.fix before editing it. |
| 30 |
Then edit the first copy (somefile.cpp). |
| 31 |
.PP |
| 32 |
After editing all the files you need to edit in this fashion, enter the |
| 33 |
directory one level above where your source code resides, and then type |
| 34 |
.IP |
| 35 |
.EX |
| 36 |
$ gendiff somedirectory .fix > mydiff\-fix.patch |
| 37 |
.EE |
| 38 |
.PP |
| 39 |
You should redirect the output to a file (as illustrated) unless you |
| 40 |
want to see the results on stdout. |
| 41 |
.SH SEE ALSO |
| 42 |
\f[B]diff\f[R](1), \f[B]patch\f[R](1) |
| 43 |
.SH AUTHOR |
| 44 |
.IP |
| 45 |
.EX |
| 46 |
Marc Ewing <marc\[at]redhat.com> |
| 47 |
.EE |