Debian Codegraph @

upstream/debian-trixie/man1/gendiff.1

raw
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