| 1 | .TH rejmerge 8 "" "pkgutils #VERSION#" "" |
| 2 | .SH NAME |
| 3 | rejmerge \- merge files that were rejected during package upgrades |
| 4 | .SH SYNOPSIS |
| 5 | \fBrejmerge [options]\fP |
| 6 | .SH DESCRIPTION |
| 7 | \fBrejmerge\fP is a \fIpackage management\fP utility that helps you merge files that were rejected |
| 8 | during package upgrades. For each rejected file found in \fI/var/lib/pkg/rejected/\fP, \fBrejmerge\fP |
| 9 | will display the difference between the installed version and the rejected version. The user can then |
| 10 | choose to keep the installed version, upgrade to the rejected version or perform a merge of the two. |
| 11 | |
| 12 | .SH OPTIONS |
| 13 | .TP |
| 14 | .B "\-r, \-\-root <path>" |
| 15 | Specify alternative root (default is "/"). This should be used |
| 16 | if you want to merge rejected files on a temporary mounted partition, |
| 17 | which is "owned" by another system. |
| 18 | .TP |
| 19 | .B "\-v, \-\-version" |
| 20 | Print version and exit. |
| 21 | .TP |
| 22 | .B "\-h, \-\-help" |
| 23 | Print help and exit. |
| 24 | .SH CONFIGURATION |
| 25 | When \fBrejmerge\fP is started it will source \fI/etc/rejmerge.conf\fP. |
| 26 | This file can be used to alter the way \fBrejmerge\fP displays file differences and performs file |
| 27 | merges. Changing the default behaviour is done by re-defining the shell functions \fBrejmerge_diff()\fP |
| 28 | and/or \fBrejmerge_merge()\fP. |
| 29 | .TP |
| 30 | .B rejmerge_diff() |
| 31 | This function is executed once for each rejected file. Arguments \fB$1\fP and \fB$2\fP contain the paths |
| 32 | to the installed and rejected files. Argument \fB$3\fP contains the path to a temporary file where this |
| 33 | function should write its result. The contents of the temporary file will later be presented to the user |
| 34 | as the difference between the two files. |
| 35 | .TP |
| 36 | .B rejmerge_merge() |
| 37 | This function is executed when the user chooses to merge two files. Arguments \fB$1\fP and \fB$2\fP |
| 38 | contain the paths to the installed and rejected files. Argument \fB$3\fP contains the path to a temporary |
| 39 | file where this function should write its result. The contents of the temporary file will later be |
| 40 | presented to the user as the merge result. |
| 41 | This function also has the option to set the variable \fB$REJMERGE_MERGE_INFO\fP. The contents of this |
| 42 | variable will be displayed as informational text after a merge has been performed. Its purpose is to provide |
| 43 | information about the merge, e.g. "5 merge conflicts found". |
| 44 | |
| 45 | .PP |
| 46 | Example: |
| 47 | |
| 48 | .nf |
| 49 | # |
| 50 | # /etc/rejmerge.conf: rejmerge(8) configuration |
| 51 | # |
| 52 | |
| 53 | rejmerge_diff() { |
| 54 | # Use diff(1) to produce side-by-side output |
| 55 | diff -y $1 $2 > $3 |
| 56 | } |
| 57 | |
| 58 | rejmerge_merge() { |
| 59 | # Use sdiff(1) to merge |
| 60 | sdiff -o $3 $1 $2 |
| 61 | } |
| 62 | |
| 63 | # End of file |
| 64 | .fi |
| 65 | |
| 66 | .SH FILES |
| 67 | .TP |
| 68 | .B "/etc/rejmerge.conf" |
| 69 | Configuration file. |
| 70 | .TP |
| 71 | .B "/var/lib/pkg/rejected/" |
| 72 | Directory where rejected files are stored. |
| 73 | .SH SEE ALSO |
| 74 | pkgadd(8), pkgrm(8), pkginfo(8), pkgmk(8) |
| 75 | .SH COPYRIGHT |
| 76 | rejmerge (pkgutils) is Copyright (c) 2000-2005 Per Liden and is licensed through |
| 77 | the GNU General Public License. Read the COPYING file for the complete license. |