Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / rpm / original / man1 / gendiff.1

diff --git a/manual/rpm/original/man1/gendiff.1 b/manual/rpm/original/man1/gendiff.1
new file mode 100644 (file)
index 0000000..fd49943
--- /dev/null
+++ b/manual/rpm/original/man1/gendiff.1
@@ -0,0 +1,45 @@
+.TH GENDIFF 1 "Mon Jan 10 2000"
+.UC 4
+.SH NAME
+gendiff \- utility to aid in error-free diff file generation
+.SH SYNOPSIS
+\fBgendiff\fR <directory> <diff-extension>
+.SH DESCRIPTION
+\fBgendiff\fR is a rather simple script which aids in generating a
+diff file from a single directory.  It takes a directory name and a
+"diff-extension" as its only arguments.  The diff extension should be
+a unique sequence of characters added to the end of all original,
+unmodified files.  The output of the program is a diff file which may
+be applied with the \fBpatch\fR program to recreate the changes.
+.PP
+The usual sequence of events for creating a diff is to create two
+identical directories, make changes in one directory, and then use the
+\fBdiff\fR utility to create a list of differences between the two.
+Using gendiff eliminates the need for the extra, original and
+unmodified directory copy.  Instead, only the individual files that
+are modified need to be saved.
+.PP
+Before editing a file, copy the file, appending the extension you have chosen
+to the filename.  I.e. if you were going to edit somefile.cpp and have chosen
+the extension "fix", copy it to somefile.cpp.fix before editing it.
+Then edit the first copy (somefile.cpp).
+.PP
+After editing all the files you need to edit in this fashion, enter the
+directory one level above where your source code resides, and then type
+.sp
+.nf
+    $ gendiff somedirectory .fix > mydiff-fix.patch
+.fi
+.PP
+You should redirect the output to a file (as illustrated) unless you want to
+see the results on stdout.
+
+.PD
+.SH "SEE ALSO"
+.BR diff (1),
+.BR patch (1)
+
+.SH AUTHOR
+.nf
+Marc Ewing <marc@redhat.com>
+.fi