update Tue Jun 22 06:37:08 PDT 2010
[pkgsrc.git] / pkgtools / pkgdiff / files / pkgdiff.1
1 .\"     $NetBSD: pkgdiff.1,v 1.4 2003/06/14 19:12:41 atatat Exp $
2 .\"
3 .\" Copyright (c) 2000 by Hubert Feyrer <hubertf@netbsd.org>
4 .\" All Rights Reserved.  Absolutely no warranty.
5 .\"
6 .Dd Jun 14, 2003
7 .Dt PKGDIFF 1
8 .Os
9 .Sh NAME
10 .Nm pkgdiff
11 .Nd diff files in a way appropriate for pkgsrc
12 .Sh SYNOPSIS
13 .Nm
14 .Op Ar options
15 .Ar oldfile
16 .Ar newfile
17 .Sh DESCRIPTION
18 The
19 .Nm
20 utility runs
21 .Xr diff 1
22 on the named files, and generates output on stdout that is appropriate
23 to be put as patch file into pkgsrc.  An empty
24 .Nx
25 RCS ID is output
26 first, and some effort is made to ensure that the generated patch does
27 not include any RCS IDs.
28 .Pp
29 .Ar options
30 can be any options that are allowed for
31 .Xr diff 1 .
32 .Sh ENVIRONMENT
33 .Ss PKGDIFF_FMT
34 The flags passed to
35 .Xr diff 1
36 when generating patches.
37 If not set, the flags
38 .Fl u
39 and
40 .Fl p
41 are used.
42 Though only unified format patches are used in pkgsrc as proper
43 patches, sometimes it can be useful to have context or plain diffs
44 available.
45 .Sh SEE ALSO
46 .Xr cvs 1 ,
47 .Xr diff 1 ,
48 .Xr mkpatches 1 ,
49 .Xr patch 1 ,
50 .Xr pkgvi 1