doc/mergesvn.1

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sh \" Subsection heading
   6 .br
   7 .if t .Sp
   8 .ne 5
   9 .PP
  10 \fB\\$1\fR
  11 .PP
  12 ..
  13 .de Sp \" Vertical space (when we can't use .PP)
  14 .if t .sp .5v
  15 .if n .sp
  16 ..
  17 .de Vb \" Begin verbatim text
  18 .ft CW
  19 .nf
  20 .ne \\$1
  21 ..
  22 .de Ve \" End verbatim text
  23 .ft R
  24 .fi
  25 ..
  26 .\" Set up some character translations and predefined strings.  \*(-- will
  27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  28 .\" double quote, and \*(R" will give a right double quote.  | will give a
  29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  32 .tr \(*W-|\(bv\*(Tr
  33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  34 .ie n \{\
  35 .    ds -- \(*W-
  36 .    ds PI pi
  37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  39 .    ds L" ""
  40 .    ds R" ""
  41 .    ds C` ""
  42 .    ds C' ""
  43 'br\}
  44 .el\{\
  45 .    ds -- \|\(em\|
  46 .    ds PI \(*p
  47 .    ds L" ``
  48 .    ds R" ''
  49 'br\}
  50 .\"
  51 .\" If the F register is turned on, we'll generate index entries on stderr for
  52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  54 .\" output yourself in some meaningful fashion.
  55 .if \nF \{\
  56 .    de IX
  57 .    tm Index:\\$1\t\\n%\t"\\$2"
  58 ..
  59 .    nr % 0
  60 .    rr F
  61 .\}
  62 .\"
  63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  64 .\" way too many mistakes in technical documents.
  65 .hy 0
  66 .if n .na
  67 .\"
  68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  70 .    \" fudge factors for nroff and troff
  71 .if n \{\
  72 .    ds #H 0
  73 .    ds #V .8m
  74 .    ds #F .3m
  75 .    ds #[ \f1
  76 .    ds #] \fP
  77 .\}
  78 .if t \{\
  79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  80 .    ds #V .6m
  81 .    ds #F 0
  82 .    ds #[ \&
  83 .    ds #] \&
  84 .\}
  85 .    \" simple accents for nroff and troff
  86 .if n \{\
  87 .    ds ' \&
  88 .    ds ` \&
  89 .    ds ^ \&
  90 .    ds , \&
  91 .    ds ~ ~
  92 .    ds /
  93 .\}
  94 .if t \{\
  95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 101 .\}
 102 .    \" troff and (daisy-wheel) nroff accents
 103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 110 .ds ae a\h'-(\w'a'u*4/10)'e
 111 .ds Ae A\h'-(\w'A'u*4/10)'E
 112 .    \" corrections for vroff
 113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 115 .    \" for low resolution devices (crt and lpr)
 116 .if \n(.H>23 .if \n(.V>19 \
 117 \{\
 118 .    ds : e
 119 .    ds 8 ss
 120 .    ds o a
 121 .    ds d- d\h'-1'\(ga
 122 .    ds D- D\h'-1'\(hy
 123 .    ds th \o'bp'
 124 .    ds Th \o'LP'
 125 .    ds ae ae
 126 .    ds Ae AE
 127 .\}
 128 .rm #[ #] #H #V #F C
 129 .\" ========================================================================
 130 .\"
 131 .IX Title "MERGESVN 1"
 132 .TH MERGESVN 1 "2007-04-04" "perl v5.8.4" "User Contributed Perl Documentation"
 133 .SH "NAME"
 134 mergesvn
 135 .SH "REVISION"
 136 .IX Header "REVISION"
 137 $Id: mergesvn 200 2007\-04\-03 23:51:02Z sunny256 $
 138 .SH "SYNOPSIS"
 139 .IX Header "SYNOPSIS"
 140 mergesvn [options] [file [files [...]]]
 141 .SH "DESCRIPTION"
 142 .IX Header "DESCRIPTION"
 143 Merge changes between Subversion controlled files or directories.
 144 Elements without the \*(L"mergesvn\*(R" property will be ignored.
 145 If no filenames are specified on the command line, it reads filenames
 146 from stdin.
 147 .PP
 148 Files or directories to be controlled by mergesvn must have the
 149 following property set:
 150 .IP "\fBmergesvn\fR" 4
 151 .IX Item "mergesvn"
 152 .PP
 153 Contains one line for every place to merge from.
 154 The line consists of two elements, the revision in the master file the
 155 last merge was done, and path or \s-1URL\s0 to the master file.
 156 These two fields are separated by exactly one space (U+0020).
 157 .SH "OPTIONS"
 158 .IX Header "OPTIONS"
 159 .IP "\fB\-a\fR, \fB\-\-alias\fR \fIx\fR" 4
 160 .IX Item "-a, --alias x"
 161 Use \fIx\fR as alias for the master \s-1URL\s0. The old value will still be
 162 written to the mergesvn property.
 163 .IP "\fB\-C\fR, \fB\-\-conflict\fR" 4
 164 .IX Item "-C, --conflict"
 165 Do not merge, but search for the first revision a conflict will occur
 166 when a merge is done. After the search is finished, the first revision
 167 number of a troublesome patch is printed, and you can choose by using
 168 the \-t option if you want to include the conflicting revision in the
 169 merge.
 170 .IP "\fB\-d\fR, \fB\-\-diff\fR" 4
 171 .IX Item "-d, --diff"
 172 Instead of merging, show a repository diff between the master \s-1URL\s0 and
 173 the versioned element.
 174 .IP "\fB\-\-dry\-run\fR" 4
 175 .IX Item "--dry-run"
 176 Try operation without making any changes.
 177 Can be used to see if the merge will result in conflicts.
 178 .IP "\fB\-h\fR, \fB\-\-help\fR" 4
 179 .IX Item "-h, --help"
 180 Print a brief help summary.
 181 .IP "\fB\-l\fR, \fB\-\-log\fR" 4
 182 .IX Item "-l, --log"
 183 Show a revision log of the remaining merges.
 184 .IP "\fB\-s\fR, \fB\-\-set\fR \fIx\fR[@\fIy\fR]" 4
 185 .IX Item "-s, --set x[@y]"
 186 Set merge source for all filenames on the command line.
 187 If \fI@y\fR is specified, revision y will be used as the merge source,
 188 otherwise \s-1HEAD\s0 is used.
 189 The revision number actually used is the newest revision the source
 190 changed.
 191 .IP "\fB\-t\fR, \fB\-\-to\fR \fIx\fR" 4
 192 .IX Item "-t, --to x"
 193 Merge to revision \fIx\fR instead of \s-1HEAD\s0.
 194 .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
 195 .IX Item "-v, --verbose"
 196 Increase level of verbosity. Can be repeated.
 197 .IP "\fB\-\-version\fR" 4
 198 .IX Item "--version"
 199 Print version information.
 200 .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
 201 .IX Item "-v, --verbose"
 202 Use the \-v option together with svn commands that accepts it.
 203 .IP "\fB\-\-debug\fR" 4
 204 .IX Item "--debug"
 205 Print debugging messages.
 206 .SH "BUGS"
 207 .IX Header "BUGS"
 208 .IP "The \fIsvn\fR\|(1) client does not support diffs between different repositories (yet), so the \fB\-\-diff\fR option will only work with elements that has the master in the same repository." 4
 209 .IX Item "The svn client does not support diffs between different repositories (yet), so the --diff option will only work with elements that has the master in the same repository."
 210 .SH "AUTHOR"
 211 .IX Header "AUTHOR"
 212 Made by Øyvind A. Holm <sunny@sunbase.org>.
 213 .SH "COPYRIGHT"
 214 .IX Header "COPYRIGHT"
 215 Copyleft © Øyvind A. Holm <sunny@sunbase.org>
 216 This is free software; see the file \fI\s-1COPYING\s0\fR for legalese stuff.
 217 .SH "LICENCE"
 218 .IX Header "LICENCE"
 219 This program is free software; you can redistribute it and/or modify it
 220 under the terms of the \s-1GNU\s0 General Public License as published by the
 221 Free Software Foundation; either version 2 of the License, or (at your
 222 option) any later version.
 223 .PP
 224 This program is distributed in the hope that it will be useful, but
 225 \&\s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
 226 \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.
 227 See the \s-1GNU\s0 General Public License for more details.
 228 .PP
 229 You should have received a copy of the \s-1GNU\s0 General Public License along
 230 with this program; if not, write to the Free Software Foundation, Inc.,
 231 59 Temple Place, Suite 330, Boston, \s-1MA\s0  02111\-1307  \s-1USA\s0
 232 .SH "SEE ALSO"
 233 .IX Header "SEE ALSO"
 234 \&\fIsvn\fR\|(1)