git-svn.html

   1 <!DOCTYPE html>
   2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
   3 <head>
   4 <meta charset="UTF-8"/>
   5 <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
   7 <meta name="generator" content="Asciidoctor 2.0.20"/>
   8 <title>git-svn(1)</title>
   9 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"/>
  10 <style>
  11 /*! Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
  12 /* Uncomment the following line when using as a custom stylesheet */
  13 /* @import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"; */
  14 html{font-family:sans-serif;-webkit-text-size-adjust:100%}
  15 a{background:none}
  16 a:focus{outline:thin dotted}
  17 a:active,a:hover{outline:0}
  18 h1{font-size:2em;margin:.67em 0}
  19 b,strong{font-weight:bold}
  20 abbr{font-size:.9em}
  21 abbr[title]{cursor:help;border-bottom:1px dotted #dddddf;text-decoration:none}
  22 dfn{font-style:italic}
  23 hr{height:0}
  24 mark{background:#ff0;color:#000}
  25 code,kbd,pre,samp{font-family:monospace;font-size:1em}
  26 pre{white-space:pre-wrap}
  27 q{quotes:"\201C" "\201D" "\2018" "\2019"}
  28 small{font-size:80%}
  29 sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
  30 sup{top:-.5em}
  31 sub{bottom:-.25em}
  32 img{border:0}
  33 svg:not(:root){overflow:hidden}
  34 figure{margin:0}
  35 audio,video{display:inline-block}
  36 audio:not([controls]){display:none;height:0}
  37 fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
  38 legend{border:0;padding:0}
  39 button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
  40 button,input{line-height:normal}
  41 button,select{text-transform:none}
  42 button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}
  43 button[disabled],html input[disabled]{cursor:default}
  44 input[type=checkbox],input[type=radio]{padding:0}
  45 button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
  46 textarea{overflow:auto;vertical-align:top}
  47 table{border-collapse:collapse;border-spacing:0}
  48 *,::before,::after{box-sizing:border-box}
  49 html,body{font-size:100%}
  50 body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;line-height:1;position:relative;cursor:auto;-moz-tab-size:4;-o-tab-size:4;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
  51 a:hover{cursor:pointer}
  52 img,object,embed{max-width:100%;height:auto}
  53 object,embed{height:100%}
  54 img{-ms-interpolation-mode:bicubic}
  55 .left{float:left!important}
  56 .right{float:right!important}
  57 .text-left{text-align:left!important}
  58 .text-right{text-align:right!important}
  59 .text-center{text-align:center!important}
  60 .text-justify{text-align:justify!important}
  61 .hide{display:none}
  62 img,object,svg{display:inline-block;vertical-align:middle}
  63 textarea{height:auto;min-height:50px}
  64 select{width:100%}
  65 .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
  66 div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0}
  67 a{color:#2156a5;text-decoration:underline;line-height:inherit}
  68 a:hover,a:focus{color:#1d4b8f}
  69 a img{border:0}
  70 p{line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
  71 p aside{font-size:.875em;line-height:1.35;font-style:italic}
  72 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
  73 h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
  74 h1{font-size:2.125em}
  75 h2{font-size:1.6875em}
  76 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
  77 h4,h5{font-size:1.125em}
  78 h6{font-size:1em}
  79 hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em}
  80 em,i{font-style:italic;line-height:inherit}
  81 strong,b{font-weight:bold;line-height:inherit}
  82 small{font-size:60%;line-height:inherit}
  83 code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
  84 ul,ol,dl{line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
  85 ul,ol{margin-left:1.5em}
  86 ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0}
  87 ul.circle{list-style-type:circle}
  88 ul.disc{list-style-type:disc}
  89 ul.square{list-style-type:square}
  90 ul.circle ul:not([class]),ul.disc ul:not([class]),ul.square ul:not([class]){list-style:inherit}
  91 ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
  92 dl dt{margin-bottom:.3125em;font-weight:bold}
  93 dl dd{margin-bottom:1.25em}
  94 blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
  95 blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
  96 @media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
  97 h1{font-size:2.75em}
  98 h2{font-size:2.3125em}
  99 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
 100 h4{font-size:1.4375em}}
 101 table{background:#fff;margin-bottom:1.25em;border:1px solid #dedede;word-wrap:normal}
 102 table thead,table tfoot{background:#f7f8f7}
 103 table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
 104 table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
 105 table tr.even,table tr.alt{background:#f8f8f7}
 106 table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6}
 107 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
 108 h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
 109 .center{margin-left:auto;margin-right:auto}
 110 .stretch{width:100%}
 111 .clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
 112 .clearfix::after,.float-group::after{clear:both}
 113 :not(pre).nobreak{word-wrap:normal}
 114 :not(pre).nowrap{white-space:nowrap}
 115 :not(pre).pre-wrap{white-space:pre-wrap}
 116 :not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
 117 pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed}
 118 pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit}
 119 pre>code{display:block}
 120 pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal}
 121 em em{font-style:normal}
 122 strong strong{font-weight:400}
 123 .keyseq{color:rgba(51,51,51,.8)}
 124 kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;border-radius:3px;box-shadow:0 1px 0 rgba(0,0,0,.2),inset 0 0 0 .1em #fff;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
 125 .keyseq kbd:first-child{margin-left:0}
 126 .keyseq kbd:last-child{margin-right:0}
 127 .menuseq,.menuref{color:#000}
 128 .menuseq b:not(.caret),.menuref{font-weight:inherit}
 129 .menuseq{word-spacing:-.02em}
 130 .menuseq b.caret{font-size:1.25em;line-height:.8}
 131 .menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
 132 b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
 133 b.button::before{content:"[";padding:0 3px 0 2px}
 134 b.button::after{content:"]";padding:0 2px 0 3px}
 135 p a>code:hover{color:rgba(0,0,0,.9)}
 136 #header,#content,#footnotes,#footer{width:100%;margin:0 auto;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
 137 #header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
 138 #header::after,#content::after,#footnotes::after,#footer::after{clear:both}
 139 #content{margin-top:1.25em}
 140 #content::before{content:none}
 141 #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
 142 #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
 143 #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
 144 #header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:flex;flex-flow:row wrap}
 145 #header .details span:first-child{margin-left:-.125em}
 146 #header .details span.email a{color:rgba(0,0,0,.85)}
 147 #header .details br{display:none}
 148 #header .details br+span::before{content:"\00a0\2013\00a0"}
 149 #header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
 150 #header .details br+span#revremark::before{content:"\00a0|\00a0"}
 151 #header #revnumber{text-transform:capitalize}
 152 #header #revnumber::after{content:"\00a0"}
 153 #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
 154 #toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
 155 #toc>ul{margin-left:.125em}
 156 #toc ul.sectlevel0>li>a{font-style:italic}
 157 #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
 158 #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
 159 #toc li{line-height:1.3334;margin-top:.3334em}
 160 #toc a{text-decoration:none}
 161 #toc a:active{text-decoration:underline}
 162 #toctitle{color:#7a2518;font-size:1.2em}
 163 @media screen and (min-width:768px){#toctitle{font-size:1.375em}
 164 body.toc2{padding-left:15em;padding-right:0}
 165 #toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
 166 #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
 167 #toc.toc2>ul{font-size:.9em;margin-bottom:0}
 168 #toc.toc2 ul ul{margin-left:0;padding-left:1em}
 169 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
 170 body.toc2.toc-right{padding-left:0;padding-right:15em}
 171 body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
 172 @media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
 173 #toc.toc2{width:20em}
 174 #toc.toc2 #toctitle{font-size:1.375em}
 175 #toc.toc2>ul{font-size:.95em}
 176 #toc.toc2 ul ul{padding-left:1.25em}
 177 body.toc2.toc-right{padding-left:0;padding-right:20em}}
 178 #content #toc{border:1px solid #e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;border-radius:4px}
 179 #content #toc>:first-child{margin-top:0}
 180 #content #toc>:last-child{margin-bottom:0}
 181 #footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em}
 182 #footer-text{color:hsla(0,0%,100%,.8);line-height:1.44}
 183 #content{margin-bottom:.625em}
 184 .sect1{padding-bottom:.625em}
 185 @media screen and (min-width:768px){#content{margin-bottom:1.25em}
 186 .sect1{padding-bottom:1.25em}}
 187 .sect1:last-child{padding-bottom:0}
 188 .sect1+.sect1{border-top:1px solid #e7e7e9}
 189 #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
 190 #content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
 191 #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
 192 #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
 193 #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
 194 details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
 195 details{margin-left:1.25rem}
 196 details>summary{cursor:pointer;display:block;position:relative;line-height:1.6;margin-bottom:.625rem;outline:none;-webkit-tap-highlight-color:transparent}
 197 details>summary::-webkit-details-marker{display:none}
 198 details>summary::before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1.25rem;transform:translateX(15%)}
 199 details[open]>summary::before{border:solid transparent;border-top:solid;border-width:.5em .3em 0;transform:translateY(15%)}
 200 details>summary::after{content:"";width:1.25rem;height:1em;position:absolute;top:.3em;left:-1.25rem}
 201 .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
 202 table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
 203 .paragraph.lead>p,#preamble>.sectionbody>[class=paragraph]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
 204 .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
 205 .admonitionblock>table td.icon{text-align:center;width:80px}
 206 .admonitionblock>table td.icon img{max-width:none}
 207 .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
 208 .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere}
 209 .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
 210 .exampleblock>.content{border:1px solid #e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;border-radius:4px}
 211 .sidebarblock{border:1px solid #dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;border-radius:4px}
 212 .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
 213 .exampleblock>.content>:first-child,.sidebarblock>.content>:first-child{margin-top:0}
 214 .exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
 215 .literalblock pre,.listingblock>.content>pre{border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em}
 216 @media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}}
 217 @media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}}
 218 .literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class=highlight],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8}
 219 .literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)}
 220 .listingblock>.content{position:relative}
 221 .listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5}
 222 .listingblock:hover code[data-lang]::before{display:block}
 223 .listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5}
 224 .listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
 225 .listingblock pre.highlightjs{padding:0}
 226 .listingblock pre.highlightjs>code{padding:1em;border-radius:4px}
 227 .listingblock pre.prettyprint{border-width:0}
 228 .prettyprint{background:#f7f7f8}
 229 pre.prettyprint .linenums{line-height:1.45;margin-left:2em}
 230 pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0}
 231 pre.prettyprint li code[data-lang]::before{opacity:1}
 232 pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none}
 233 table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none}
 234 table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal}
 235 table.linenotable td.code{padding-left:.75em}
 236 table.linenotable td.linenos,pre.pygments .linenos{border-right:1px solid;opacity:.35;padding-right:.5em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}
 237 pre.pygments span.linenos{display:inline-block;margin-right:.75em}
 238 .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
 239 .quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em}
 240 .quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
 241 .quoteblock blockquote{margin:0;padding:0;border:0}
 242 .quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
 243 .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
 244 .quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
 245 .verseblock{margin:0 1em 1.25em}
 246 .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans-serif;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
 247 .verseblock pre strong{font-weight:400}
 248 .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
 249 .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
 250 .quoteblock .attribution br,.verseblock .attribution br{display:none}
 251 .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
 252 .quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
 253 .quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
 254 .quoteblock.abstract{margin:0 1em 1.25em;display:block}
 255 .quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
 256 .quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
 257 .quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0}
 258 .quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
 259 .quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;font-size:.85rem;text-align:left;margin-right:0}
 260 p.tableblock:last-child{margin-bottom:0}
 261 td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere}
 262 td.tableblock>.content>:last-child{margin-bottom:-1.25em}
 263 table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
 264 table.grid-all>*>tr>*{border-width:1px}
 265 table.grid-cols>*>tr>*{border-width:0 1px}
 266 table.grid-rows>*>tr>*{border-width:1px 0}
 267 table.frame-all{border-width:1px}
 268 table.frame-ends{border-width:1px 0}
 269 table.frame-sides{border-width:0 1px}
 270 table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}
 271 table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}
 272 table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0}
 273 table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0}
 274 table.stripes-all>*>tr,table.stripes-odd>*>tr:nth-of-type(odd),table.stripes-even>*>tr:nth-of-type(even),table.stripes-hover>*>tr:hover{background:#f8f8f7}
 275 th.halign-left,td.halign-left{text-align:left}
 276 th.halign-right,td.halign-right{text-align:right}
 277 th.halign-center,td.halign-center{text-align:center}
 278 th.valign-top,td.valign-top{vertical-align:top}
 279 th.valign-bottom,td.valign-bottom{vertical-align:bottom}
 280 th.valign-middle,td.valign-middle{vertical-align:middle}
 281 table thead th,table tfoot th{font-weight:bold}
 282 tbody tr th{background:#f7f8f7}
 283 tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
 284 p.tableblock>code:only-child{background:none;padding:0}
 285 p.tableblock{font-size:1em}
 286 ol{margin-left:1.75em}
 287 ul li ol{margin-left:1.5em}
 288 dl dd{margin-left:1.125em}
 289 dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
 290 li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
 291 ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
 292 ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
 293 ul.unstyled,ol.unstyled{margin-left:0}
 294 li>p:empty:only-child::before{content:"";display:inline-block}
 295 ul.checklist>li>p:first-child{margin-left:-1em}
 296 ul.checklist>li>p:first-child>.fa-square-o:first-child,ul.checklist>li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
 297 ul.checklist>li>p:first-child>input[type=checkbox]:first-child{margin-right:.25em}
 298 ul.inline{display:flex;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
 299 ul.inline>li{margin-left:1.25em}
 300 .unstyled dl dt{font-weight:400;font-style:normal}
 301 ol.arabic{list-style-type:decimal}
 302 ol.decimal{list-style-type:decimal-leading-zero}
 303 ol.loweralpha{list-style-type:lower-alpha}
 304 ol.upperalpha{list-style-type:upper-alpha}
 305 ol.lowerroman{list-style-type:lower-roman}
 306 ol.upperroman{list-style-type:upper-roman}
 307 ol.lowergreek{list-style-type:lower-greek}
 308 .hdlist>table,.colist>table{border:0;background:none}
 309 .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
 310 td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
 311 td.hdlist1{font-weight:bold;padding-bottom:1.25em}
 312 td.hdlist2{word-wrap:anywhere}
 313 .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
 314 .colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
 315 .colist td:not([class]):first-child img{max-width:none}
 316 .colist td:not([class]):last-child{padding:.25em 0}
 317 .thumb,.th{line-height:0;display:inline-block;border:4px solid #fff;box-shadow:0 0 0 1px #ddd}
 318 .imageblock.left{margin:.25em .625em 1.25em 0}
 319 .imageblock.right{margin:.25em 0 1.25em .625em}
 320 .imageblock>.title{margin-bottom:0}
 321 .imageblock.thumb,.imageblock.th{border-width:6px}
 322 .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
 323 .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
 324 .image.left{margin-right:.625em}
 325 .image.right{margin-left:.625em}
 326 a.image{text-decoration:none;display:inline-block}
 327 a.image object{pointer-events:none}
 328 sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
 329 sup.footnote a,sup.footnoteref a{text-decoration:none}
 330 sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
 331 #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
 332 #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
 333 #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
 334 #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
 335 #footnotes .footnote:last-of-type{margin-bottom:0}
 336 #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
 337 div.unbreakable{page-break-inside:avoid}
 338 .big{font-size:larger}
 339 .small{font-size:smaller}
 340 .underline{text-decoration:underline}
 341 .overline{text-decoration:overline}
 342 .line-through{text-decoration:line-through}
 343 .aqua{color:#00bfbf}
 344 .aqua-background{background:#00fafa}
 345 .black{color:#000}
 346 .black-background{background:#000}
 347 .blue{color:#0000bf}
 348 .blue-background{background:#0000fa}
 349 .fuchsia{color:#bf00bf}
 350 .fuchsia-background{background:#fa00fa}
 351 .gray{color:#606060}
 352 .gray-background{background:#7d7d7d}
 353 .green{color:#006000}
 354 .green-background{background:#007d00}
 355 .lime{color:#00bf00}
 356 .lime-background{background:#00fa00}
 357 .maroon{color:#600000}
 358 .maroon-background{background:#7d0000}
 359 .navy{color:#000060}
 360 .navy-background{background:#00007d}
 361 .olive{color:#606000}
 362 .olive-background{background:#7d7d00}
 363 .purple{color:#600060}
 364 .purple-background{background:#7d007d}
 365 .red{color:#bf0000}
 366 .red-background{background:#fa0000}
 367 .silver{color:#909090}
 368 .silver-background{background:#bcbcbc}
 369 .teal{color:#006060}
 370 .teal-background{background:#007d7d}
 371 .white{color:#bfbfbf}
 372 .white-background{background:#fafafa}
 373 .yellow{color:#bfbf00}
 374 .yellow-background{background:#fafa00}
 375 span.icon>.fa{cursor:default}
 376 a span.icon>.fa{cursor:inherit}
 377 .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
 378 .admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
 379 .admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
 380 .admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
 381 .admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
 382 .admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
 383 .conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
 384 .conum[data-value] *{color:#fff!important}
 385 .conum[data-value]+b{display:none}
 386 .conum[data-value]::after{content:attr(data-value)}
 387 pre .conum[data-value]{position:relative;top:-.125em}
 388 b.conum *{color:inherit!important}
 389 .conum:not([data-value]):empty{display:none}
 390 dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
 391 h1,h2,p,td.content,span.alt,summary{letter-spacing:-.01em}
 392 p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
 393 p,blockquote,dt,td.content,td.hdlist1,span.alt,summary{font-size:1.0625rem}
 394 p{margin-bottom:1.25rem}
 395 .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
 396 .exampleblock>.content{background:#fffef7;border-color:#e0e0dc;box-shadow:0 1px 4px #e0e0dc}
 397 .print-only{display:none!important}
 398 @page{margin:1.25cm .75cm}
 399 @media print{*{box-shadow:none!important;text-shadow:none!important}
 400 html{font-size:80%}
 401 a{color:inherit!important;text-decoration:underline!important}
 402 a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
 403 a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
 404 abbr[title]{border-bottom:1px dotted}
 405 abbr[title]::after{content:" (" attr(title) ")"}
 406 pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
 407 thead{display:table-header-group}
 408 svg{max-width:100%}
 409 p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
 410 h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
 411 #header,#content,#footnotes,#footer{max-width:none}
 412 #toc,.sidebarblock,.exampleblock>.content{background:none!important}
 413 #toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
 414 body.book #header{text-align:center}
 415 body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
 416 body.book #header .details{border:0!important;display:block;padding:0!important}
 417 body.book #header .details span:first-child{margin-left:0!important}
 418 body.book #header .details br{display:block}
 419 body.book #header .details br+span::before{content:none!important}
 420 body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
 421 body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
 422 .listingblock code[data-lang]::before{display:block}
 423 #footer{padding:0 .9375em}
 424 .hide-on-print{display:none!important}
 425 .print-only{display:block!important}
 426 .hide-for-print{display:none!important}
 427 .show-for-print{display:inherit!important}}
 428 @media amzn-kf8,print{#header>h1:first-child{margin-top:1.25rem}
 429 .sect1{padding:0!important}
 430 .sect1+.sect1{border:0}
 431 #footer{background:none}
 432 #footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
 433 @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
 434 </style>
 435 <style>
 436 pre>code {
 437    display: inline;
 438 }
 439 </style>
 440 </head>
 441 <body class="manpage">
 442 <div id="header">
 443 <h1>git-svn(1) Manual Page</h1>
 444 <h2 id="_name">NAME</h2>
 445 <div class="sectionbody">
 446 <p>git-svn - Bidirectional operation between a Subversion repository and Git</p>
 447 </div>
 448 </div>
 449 <div id="content">
 450 <div class="sect1">
 451 <h2 id="_synopsis">SYNOPSIS</h2>
 452 <div class="sectionbody">
 453 <div class="verseblock">
 454 <pre class="content"><em>git svn</em> &lt;command&gt; [&lt;options&gt;] [&lt;arguments&gt;]</pre>
 455 </div>
 456 </div>
 457 </div>
 458 <div class="sect1">
 459 <h2 id="_description">DESCRIPTION</h2>
 460 <div class="sectionbody">
 461 <div class="paragraph">
 462 <p><em>git svn</em> is a simple conduit for changesets between Subversion and Git.
 463 It provides a bidirectional flow of changes between a Subversion and a Git
 464 repository.</p>
 465 </div>
 466 <div class="paragraph">
 467 <p><em>git svn</em> can track a standard Subversion repository,
 468 following the common "trunk/branches/tags" layout, with the --stdlayout option.
 469 It can also follow branches and tags in any layout with the -T/-t/-b options
 470 (see options to <em>init</em> below, and also the <em>clone</em> command).</p>
 471 </div>
 472 <div class="paragraph">
 473 <p>Once tracking a Subversion repository (with any of the above methods), the Git
 474 repository can be updated from Subversion by the <em>fetch</em> command and
 475 Subversion updated from Git by the <em>dcommit</em> command.</p>
 476 </div>
 477 </div>
 478 </div>
 479 <div class="sect1">
 480 <h2 id="_commands">COMMANDS</h2>
 481 <div class="sectionbody">
 482 <div class="dlist">
 483 <dl>
 484 <dt class="hdlist1"><em>init</em></dt>
 485 <dd>
 486 <p>Initializes an empty Git repository with additional
 487 metadata directories for <em>git svn</em>.  The Subversion URL
 488 may be specified as a command-line argument, or as full
 489 URL arguments to -T/-t/-b.  Optionally, the target
 490 directory to operate on can be specified as a second
 491 argument.  Normally this command initializes the current
 492 directory.</p>
 493 <div class="dlist">
 494 <dl>
 495 <dt class="hdlist1">-T&lt;trunk-subdir&gt;</dt>
 496 <dt class="hdlist1">--trunk=&lt;trunk-subdir&gt;</dt>
 497 <dt class="hdlist1">-t&lt;tags-subdir&gt;</dt>
 498 <dt class="hdlist1">--tags=&lt;tags-subdir&gt;</dt>
 499 <dt class="hdlist1">-b&lt;branches-subdir&gt;</dt>
 500 <dt class="hdlist1">--branches=&lt;branches-subdir&gt;</dt>
 501 <dt class="hdlist1">-s</dt>
 502 <dt class="hdlist1">--stdlayout</dt>
 503 <dd>
 504 <p>These are optional command-line options for init.  Each of
 505 these flags can point to a relative repository path
 506 (--tags=project/tags) or a full url
 507 (--tags=https://foo.org/project/tags).
 508 You can specify more than one --tags and/or --branches options, in case
 509 your Subversion repository places tags or branches under multiple paths.
 510 The option --stdlayout is
 511 a shorthand way of setting trunk,tags,branches as the relative paths,
 512 which is the Subversion default. If any of the other options are given
 513 as well, they take precedence.</p>
 514 </dd>
 515 <dt class="hdlist1">--no-metadata</dt>
 516 <dd>
 517 <p>Set the <em>noMetadata</em> option in the [svn-remote] config.
 518 This option is not recommended, please read the <em>svn.noMetadata</em>
 519 section of this manpage before using this option.</p>
 520 </dd>
 521 <dt class="hdlist1">--use-svm-props</dt>
 522 <dd>
 523 <p>Set the <em>useSvmProps</em> option in the [svn-remote] config.</p>
 524 </dd>
 525 <dt class="hdlist1">--use-svnsync-props</dt>
 526 <dd>
 527 <p>Set the <em>useSvnsyncProps</em> option in the [svn-remote] config.</p>
 528 </dd>
 529 <dt class="hdlist1">--rewrite-root=&lt;URL&gt;</dt>
 530 <dd>
 531 <p>Set the <em>rewriteRoot</em> option in the [svn-remote] config.</p>
 532 </dd>
 533 <dt class="hdlist1">--rewrite-uuid=&lt;UUID&gt;</dt>
 534 <dd>
 535 <p>Set the <em>rewriteUUID</em> option in the [svn-remote] config.</p>
 536 </dd>
 537 <dt class="hdlist1">--username=&lt;user&gt;</dt>
 538 <dd>
 539 <p>For transports that SVN handles authentication for (http,
 540 https, and plain svn), specify the username.  For other
 541 transports (e.g. <code>svn+ssh://</code>), you must include the username in
 542 the URL, e.g. <code>svn+ssh://foo@svn.bar.com/project</code></p>
 543 </dd>
 544 <dt class="hdlist1">--prefix=&lt;prefix&gt;</dt>
 545 <dd>
 546 <p>This allows one to specify a prefix which is prepended
 547 to the names of remotes if trunk/branches/tags are
 548 specified.  The prefix does not automatically include a
 549 trailing slash, so be sure you include one in the
 550 argument if that is what you want.  If --branches/-b is
 551 specified, the prefix must include a trailing slash.
 552 Setting a prefix (with a trailing slash) is strongly
 553 encouraged in any case, as your SVN-tracking refs will
 554 then be located at "refs/remotes/$prefix/<strong>", which is
 555 compatible with Git&#8217;s own remote-tracking ref layout
 556 (refs/remotes/$remote/</strong>). Setting a prefix is also useful
 557 if you wish to track multiple projects that share a common
 558 repository.
 559 By default, the prefix is set to <em>origin/</em>.</p>
 560 <div class="admonitionblock note">
 561 <table>
 562 <tr>
 563 <td class="icon">
 564 <div class="title">Note</div>
 565 </td>
 566 <td class="content">
 567 Before Git v2.0, the default prefix was "" (no prefix). This
 568 meant that SVN-tracking refs were put at "refs/remotes/*", which is
 569 incompatible with how Git&#8217;s own remote-tracking refs are organized.
 570 If you still want the old default, you can get it by passing
 571 <code>--prefix</code> "" on the command line (<code>--prefix=</code>"" may not work if
 572 your Perl&#8217;s Getopt::Long is &lt; v2.37).
 573 </td>
 574 </tr>
 575 </table>
 576 </div>
 577 </dd>
 578 <dt class="hdlist1">--ignore-refs=&lt;regex&gt;</dt>
 579 <dd>
 580 <p>When passed to <em>init</em> or <em>clone</em> this regular expression will
 581 be preserved as a config key.  See <em>fetch</em> for a description
 582 of <code>--ignore-refs</code>.</p>
 583 </dd>
 584 <dt class="hdlist1">--ignore-paths=&lt;regex&gt;</dt>
 585 <dd>
 586 <p>When passed to <em>init</em> or <em>clone</em> this regular expression will
 587 be preserved as a config key.  See <em>fetch</em> for a description
 588 of <code>--ignore-paths</code>.</p>
 589 </dd>
 590 <dt class="hdlist1">--include-paths=&lt;regex&gt;</dt>
 591 <dd>
 592 <p>When passed to <em>init</em> or <em>clone</em> this regular expression will
 593 be preserved as a config key.  See <em>fetch</em> for a description
 594 of <code>--include-paths</code>.</p>
 595 </dd>
 596 <dt class="hdlist1">--no-minimize-url</dt>
 597 <dd>
 598 <p>When tracking multiple directories (using --stdlayout,
 599 --branches, or --tags options), git svn will attempt to connect
 600 to the root (or highest allowed level) of the Subversion
 601 repository.  This default allows better tracking of history if
 602 entire projects are moved within a repository, but may cause
 603 issues on repositories where read access restrictions are in
 604 place.  Passing <code>--no-minimize-url</code> will allow git svn to
 605 accept URLs as-is without attempting to connect to a higher
 606 level directory.  This option is off by default when only
 607 one URL/branch is tracked (it would do little good).</p>
 608 </dd>
 609 </dl>
 610 </div>
 611 </dd>
 612 <dt class="hdlist1"><em>fetch</em></dt>
 613 <dd>
 614 <p>Fetch unfetched revisions from the Subversion remote we are
 615 tracking.  The name of the [svn-remote "&#8230;&#8203;"] section in the
 616 $GIT_DIR/config file may be specified as an optional
 617 command-line argument.</p>
 618 <div class="paragraph">
 619 <p>This automatically updates the rev_map if needed (see
 620 <em>$GIT_DIR/svn/**/.rev_map.*</em> in the FILES section below for details).</p>
 621 </div>
 622 <div class="dlist">
 623 <dl>
 624 <dt class="hdlist1">--localtime</dt>
 625 <dd>
 626 <p>Store Git commit times in the local time zone instead of UTC.  This
 627 makes <em>git log</em> (even without --date=local) show the same times
 628 that <code>svn</code> <code>log</code> would in the local time zone.</p>
 629 <div class="paragraph">
 630 <p>This doesn&#8217;t interfere with interoperating with the Subversion
 631 repository you cloned from, but if you wish for your local Git
 632 repository to be able to interoperate with someone else&#8217;s local Git
 633 repository, either don&#8217;t use this option or you should both use it in
 634 the same local time zone.</p>
 635 </div>
 636 </dd>
 637 <dt class="hdlist1">--parent</dt>
 638 <dd>
 639 <p>Fetch only from the SVN parent of the current HEAD.</p>
 640 </dd>
 641 <dt class="hdlist1">--ignore-refs=&lt;regex&gt;</dt>
 642 <dd>
 643 <p>Ignore refs for branches or tags matching the Perl regular
 644 expression. A "negative look-ahead assertion" like
 645 <code>^refs/remotes/origin/</code>(?!tags/wanted-tag|<code>wanted-branch</code>).*$
 646 can be used to allow only certain refs.</p>
 647 <div class="verseblock">
 648 <pre class="content">config key: svn-remote.&lt;name&gt;.ignore-refs</pre>
 649 </div>
 650 <div class="paragraph">
 651 <p>If the ignore-refs configuration key is set, and the command-line
 652 option is also given, both regular expressions will be used.</p>
 653 </div>
 654 </dd>
 655 <dt class="hdlist1">--ignore-paths=&lt;regex&gt;</dt>
 656 <dd>
 657 <p>This allows one to specify a Perl regular expression that will
 658 cause skipping of all matching paths from checkout from SVN.
 659 The <code>--ignore-paths</code> option should match for every <em>fetch</em>
 660 (including automatic fetches due to <em>clone</em>, <em>dcommit</em>,
 661 <em>rebase</em>, etc) on a given repository.</p>
 662 <div class="verseblock">
 663 <pre class="content">config key: svn-remote.&lt;name&gt;.ignore-paths</pre>
 664 </div>
 665 <div class="paragraph">
 666 <p>If the ignore-paths configuration key is set, and the command-line
 667 option is also given, both regular expressions will be used.</p>
 668 </div>
 669 <div class="paragraph">
 670 <p>Examples:</p>
 671 </div>
 672 <div class="openblock">
 673 <div class="content">
 674 <div class="dlist">
 675 <dl>
 676 <dt class="hdlist1">Skip "doc*" directory for every fetch</dt>
 677 <dd>
 678 <div class="listingblock">
 679 <div class="content">
 680 <pre>--ignore-paths="^doc"</pre>
 681 </div>
 682 </div>
 683 </dd>
 684 <dt class="hdlist1">Skip "branches" and "tags" of first level directories</dt>
 685 <dd>
 686 <div class="listingblock">
 687 <div class="content">
 688 <pre>--ignore-paths="^[^/]+/(?:branches|tags)"</pre>
 689 </div>
 690 </div>
 691 </dd>
 692 </dl>
 693 </div>
 694 </div>
 695 </div>
 696 </dd>
 697 <dt class="hdlist1">--include-paths=&lt;regex&gt;</dt>
 698 <dd>
 699 <p>This allows one to specify a Perl regular expression that will
 700 cause the inclusion of only matching paths from checkout from SVN.
 701 The <code>--include-paths</code> option should match for every <em>fetch</em>
 702 (including automatic fetches due to <em>clone</em>, <em>dcommit</em>,
 703 <em>rebase</em>, etc) on a given repository. <code>--ignore-paths</code> takes
 704 precedence over <code>--include-paths</code>.</p>
 705 <div class="verseblock">
 706 <pre class="content">config key: svn-remote.&lt;name&gt;.include-paths</pre>
 707 </div>
 708 </dd>
 709 <dt class="hdlist1">--log-window-size=&lt;n&gt;</dt>
 710 <dd>
 711 <p>Fetch &lt;n&gt; log entries per request when scanning Subversion history.
 712 The default is 100. For very large Subversion repositories, larger
 713 values may be needed for <em>clone</em>/<em>fetch</em> to complete in reasonable
 714 time. But overly large values may lead to higher memory usage and
 715 request timeouts.</p>
 716 </dd>
 717 </dl>
 718 </div>
 719 </dd>
 720 <dt class="hdlist1"><em>clone</em></dt>
 721 <dd>
 722 <p>Runs <em>init</em> and <em>fetch</em>.  It will automatically create a
 723 directory based on the basename of the URL passed to it;
 724 or if a second argument is passed; it will create a directory
 725 and work within that.  It accepts all arguments that the
 726 <em>init</em> and <em>fetch</em> commands accept; with the exception of
 727 <code>--fetch-all</code> and <code>--parent</code>.  After a repository is cloned,
 728 the <em>fetch</em> command will be able to update revisions without
 729 affecting the working tree; and the <em>rebase</em> command will be
 730 able to update the working tree with the latest changes.</p>
 731 <div class="dlist">
 732 <dl>
 733 <dt class="hdlist1">--preserve-empty-dirs</dt>
 734 <dd>
 735 <p>Create a placeholder file in the local Git repository for each
 736 empty directory fetched from Subversion.  This includes directories
 737 that become empty by removing all entries in the Subversion
 738 repository (but not the directory itself).  The placeholder files
 739 are also tracked and removed when no longer necessary.</p>
 740 </dd>
 741 <dt class="hdlist1">--placeholder-filename=&lt;filename&gt;</dt>
 742 <dd>
 743 <p>Set the name of placeholder files created by --preserve-empty-dirs.
 744 Default: ".gitignore"</p>
 745 </dd>
 746 </dl>
 747 </div>
 748 </dd>
 749 <dt class="hdlist1"><em>rebase</em></dt>
 750 <dd>
 751 <p>This fetches revisions from the SVN parent of the current HEAD
 752 and rebases the current (uncommitted to SVN) work against it.</p>
 753 <div class="paragraph">
 754 <p>This works similarly to <code>svn</code> <code>update</code> or <em>git pull</em> except that
 755 it preserves linear history with <em>git rebase</em> instead of
 756 <em>git merge</em> for ease of dcommitting with <em>git svn</em>.</p>
 757 </div>
 758 <div class="paragraph">
 759 <p>This accepts all options that <em>git svn fetch</em> and <em>git rebase</em>
 760 accept.  However, <code>--fetch-all</code> only fetches from the current
 761 [svn-remote], and not all [svn-remote] definitions.</p>
 762 </div>
 763 <div class="paragraph">
 764 <p>Like <em>git rebase</em>; this requires that the working tree be clean
 765 and have no uncommitted changes.</p>
 766 </div>
 767 <div class="paragraph">
 768 <p>This automatically updates the rev_map if needed (see
 769 <em>$GIT_DIR/svn/**/.rev_map.*</em> in the FILES section below for details).</p>
 770 </div>
 771 <div class="dlist">
 772 <dl>
 773 <dt class="hdlist1">-l</dt>
 774 <dt class="hdlist1">--local</dt>
 775 <dd>
 776 <p>Do not fetch remotely; only run <em>git rebase</em> against the
 777 last fetched commit from the upstream SVN.</p>
 778 </dd>
 779 </dl>
 780 </div>
 781 </dd>
 782 <dt class="hdlist1"><em>dcommit</em></dt>
 783 <dd>
 784 <p>Commit each diff from the current branch directly to the SVN
 785 repository, and then rebase or reset (depending on whether or
 786 not there is a diff between SVN and head).  This will create
 787 a revision in SVN for each commit in Git.</p>
 788 <div class="paragraph">
 789 <p>When an optional Git branch name (or a Git commit object name)
 790 is specified as an argument, the subcommand works on the specified
 791 branch, not on the current branch.</p>
 792 </div>
 793 <div class="paragraph">
 794 <p>Use of <em>dcommit</em> is preferred to <em>set-tree</em> (below).</p>
 795 </div>
 796 <div class="dlist">
 797 <dl>
 798 <dt class="hdlist1">--no-rebase</dt>
 799 <dd>
 800 <p>After committing, do not rebase or reset.</p>
 801 </dd>
 802 <dt class="hdlist1">--commit-url &lt;URL&gt;</dt>
 803 <dd>
 804 <p>Commit to this SVN URL (the full path).  This is intended to
 805 allow existing <em>git svn</em> repositories created with one transport
 806 method (e.g. <code>svn://</code> or <code>http://</code> for anonymous read) to be
 807 reused if a user is later given access to an alternate transport
 808 method (e.g. <code>svn+ssh://</code> or <code>https://</code>) for commit.</p>
 809 <div class="verseblock">
 810 <pre class="content">config key: svn-remote.&lt;name&gt;.commiturl
 811 config key: svn.commiturl (overwrites all svn-remote.&lt;name&gt;.commiturl options)</pre>
 812 </div>
 813 <div class="paragraph">
 814 <p>Note that the SVN URL of the commiturl config key includes the SVN branch.
 815 If you rather want to set the commit URL for an entire SVN repository use
 816 svn-remote.&lt;name&gt;.pushurl instead.</p>
 817 </div>
 818 <div class="paragraph">
 819 <p>Using this option for any other purpose (don&#8217;t ask) is very strongly
 820 discouraged.</p>
 821 </div>
 822 </dd>
 823 <dt class="hdlist1">--mergeinfo=&lt;mergeinfo&gt;</dt>
 824 <dd>
 825 <p>Add the given merge information during the dcommit
 826 (e.g. <code>--mergeinfo=</code>"/branches/foo:1-10"). All svn server versions can
 827 store this information (as a property), and svn clients starting from
 828 version 1.5 can make use of it. To specify merge information from multiple
 829 branches, use a single space character between the branches
 830 (<code>--mergeinfo=</code>"/branches/foo:1-10 <code>/branches/bar:3,5-6,8</code>")</p>
 831 <div class="verseblock">
 832 <pre class="content">config key: svn.pushmergeinfo</pre>
 833 </div>
 834 <div class="paragraph">
 835 <p>This option will cause git-svn to attempt to automatically populate the
 836 svn:mergeinfo property in the SVN repository when possible. Currently, this can
 837 only be done when dcommitting non-fast-forward merges where all parents but the
 838 first have already been pushed into SVN.</p>
 839 </div>
 840 </dd>
 841 <dt class="hdlist1">--interactive</dt>
 842 <dd>
 843 <p>Ask the user to confirm that a patch set should actually be sent to SVN.
 844 For each patch, one may answer "yes" (accept this patch), "no" (discard this
 845 patch), "all" (accept all patches), or "quit".</p>
 846 <div class="paragraph">
 847 <p><em>git svn dcommit</em> returns immediately if answer is "no" or "quit", without
 848 committing anything to SVN.</p>
 849 </div>
 850 </dd>
 851 </dl>
 852 </div>
 853 </dd>
 854 <dt class="hdlist1"><em>branch</em></dt>
 855 <dd>
 856 <p>Create a branch in the SVN repository.</p>
 857 <div class="dlist">
 858 <dl>
 859 <dt class="hdlist1">-m</dt>
 860 <dt class="hdlist1">--message</dt>
 861 <dd>
 862 <p>Allows to specify the commit message.</p>
 863 </dd>
 864 <dt class="hdlist1">-t</dt>
 865 <dt class="hdlist1">--tag</dt>
 866 <dd>
 867 <p>Create a tag by using the tags_subdir instead of the branches_subdir
 868 specified during git svn init.</p>
 869 </dd>
 870 <dt class="hdlist1">-d&lt;path&gt;</dt>
 871 <dt class="hdlist1">--destination=&lt;path&gt;</dt>
 872 <dd>
 873 <p>If more than one --branches (or --tags) option was given to the <em>init</em>
 874 or <em>clone</em> command, you must provide the location of the branch (or
 875 tag) you wish to create in the SVN repository.  &lt;path&gt; specifies which
 876 path to use to create the branch or tag and should match the pattern
 877 on the left-hand side of one of the configured branches or tags
 878 refspecs.  You can see these refspecs with the commands</p>
 879 <div class="literalblock">
 880 <div class="content">
 881 <pre>git config --get-all svn-remote.&lt;name&gt;.branches
 882 git config --get-all svn-remote.&lt;name&gt;.tags</pre>
 883 </div>
 884 </div>
 885 <div class="paragraph">
 886 <p>where &lt;name&gt; is the name of the SVN repository as specified by the -R option to
 887 <em>init</em> (or "svn" by default).</p>
 888 </div>
 889 </dd>
 890 <dt class="hdlist1">--username</dt>
 891 <dd>
 892 <p>Specify the SVN username to perform the commit as.  This option overrides
 893 the <em>username</em> configuration property.</p>
 894 </dd>
 895 <dt class="hdlist1">--commit-url</dt>
 896 <dd>
 897 <p>Use the specified URL to connect to the destination Subversion
 898 repository.  This is useful in cases where the source SVN
 899 repository is read-only.  This option overrides configuration
 900 property <em>commiturl</em>.</p>
 901 <div class="literalblock">
 902 <div class="content">
 903 <pre>git config --get-all svn-remote.&lt;name&gt;.commiturl</pre>
 904 </div>
 905 </div>
 906 </dd>
 907 <dt class="hdlist1">--parents</dt>
 908 <dd>
 909 <p>Create parent folders. This parameter is equivalent to the parameter
 910 --parents on svn cp commands and is useful for non-standard repository
 911 layouts.</p>
 912 </dd>
 913 </dl>
 914 </div>
 915 </dd>
 916 <dt class="hdlist1"><em>tag</em></dt>
 917 <dd>
 918 <p>Create a tag in the SVN repository. This is a shorthand for
 919 <em>branch -t</em>.</p>
 920 </dd>
 921 <dt class="hdlist1"><em>log</em></dt>
 922 <dd>
 923 <p>This should make it easy to look up svn log messages when svn
 924 users refer to -r/--revision numbers.</p>
 925 <div class="paragraph">
 926 <p>The following features from &#8216;svn log&#8217; are supported:</p>
 927 </div>
 928 <div class="openblock">
 929 <div class="content">
 930 <div class="dlist">
 931 <dl>
 932 <dt class="hdlist1">-r &lt;n&gt;[:&lt;n&gt;]</dt>
 933 <dt class="hdlist1">--revision=&lt;n&gt;[:&lt;n&gt;]</dt>
 934 <dd>
 935 <p>is supported, non-numeric args are not:
 936 HEAD, NEXT, BASE, PREV, etc &#8230;&#8203;</p>
 937 </dd>
 938 <dt class="hdlist1">-v</dt>
 939 <dt class="hdlist1">--verbose</dt>
 940 <dd>
 941 <p>it&#8217;s not completely compatible with the --verbose
 942 output in svn log, but reasonably close.</p>
 943 </dd>
 944 <dt class="hdlist1">--limit=&lt;n&gt;</dt>
 945 <dd>
 946 <p>is NOT the same as --max-count, doesn&#8217;t count
 947 merged/excluded commits</p>
 948 </dd>
 949 <dt class="hdlist1">--incremental</dt>
 950 <dd>
 951 <p>supported</p>
 952 </dd>
 953 </dl>
 954 </div>
 955 </div>
 956 </div>
 957 <div class="paragraph">
 958 <p>New features:</p>
 959 </div>
 960 <div class="openblock">
 961 <div class="content">
 962 <div class="dlist">
 963 <dl>
 964 <dt class="hdlist1">--show-commit</dt>
 965 <dd>
 966 <p>shows the Git commit sha1, as well</p>
 967 </dd>
 968 <dt class="hdlist1">--oneline</dt>
 969 <dd>
 970 <p>our version of --pretty=oneline</p>
 971 </dd>
 972 </dl>
 973 </div>
 974 </div>
 975 </div>
 976 <div class="admonitionblock note">
 977 <table>
 978 <tr>
 979 <td class="icon">
 980 <div class="title">Note</div>
 981 </td>
 982 <td class="content">
 983 SVN itself only stores times in UTC and nothing else. The regular svn
 984 client converts the UTC time to the local time (or based on the TZ=
 985 environment). This command has the same behaviour.
 986 </td>
 987 </tr>
 988 </table>
 989 </div>
 990 <div class="paragraph">
 991 <p>Any other arguments are passed directly to <em>git log</em></p>
 992 </div>
 993 </dd>
 994 <dt class="hdlist1"><em>blame</em></dt>
 995 <dd>
 996 <p>Show what revision and author last modified each line of a file. The
 997 output of this mode is format-compatible with the output of
 998 &#8216;svn blame&#8217; by default. Like the SVN blame command,
 999 local uncommitted changes in the working tree are ignored;
1000 the version of the file in the HEAD revision is annotated. Unknown
1001 arguments are passed directly to <em>git blame</em>.</p>
1002 <div class="dlist">
1003 <dl>
1004 <dt class="hdlist1">--git-format</dt>
1005 <dd>
1006 <p>Produce output in the same format as <em>git blame</em>, but with
1007 SVN revision numbers instead of Git commit hashes. In this mode,
1008 changes that haven&#8217;t been committed to SVN (including local
1009 working-copy edits) are shown as revision 0.</p>
1010 </dd>
1011 </dl>
1012 </div>
1013 </dd>
1014 <dt class="hdlist1"><em>find-rev</em></dt>
1015 <dd>
1016 <p>When given an SVN revision number of the form <em>rN</em>, returns the
1017 corresponding Git commit hash (this can optionally be followed by a
1018 tree-ish to specify which branch should be searched).  When given a
1019 tree-ish, returns the corresponding SVN revision number.</p>
1020 <div class="dlist">
1021 <dl>
1022 <dt class="hdlist1">-B</dt>
1023 <dt class="hdlist1">--before</dt>
1024 <dd>
1025 <p>Don&#8217;t require an exact match if given an SVN revision, instead find
1026 the commit corresponding to the state of the SVN repository (on the
1027 current branch) at the specified revision.</p>
1028 </dd>
1029 <dt class="hdlist1">-A</dt>
1030 <dt class="hdlist1">--after</dt>
1031 <dd>
1032 <p>Don&#8217;t require an exact match if given an SVN revision; if there is
1033 not an exact match return the closest match searching forward in the
1034 history.</p>
1035 </dd>
1036 </dl>
1037 </div>
1038 </dd>
1039 <dt class="hdlist1"><em>set-tree</em></dt>
1040 <dd>
1041 <p>You should consider using <em>dcommit</em> instead of this command.
1042 Commit specified commit or tree objects to SVN.  This relies on
1043 your imported fetch data being up to date.  This makes
1044 absolutely no attempts to do patching when committing to SVN, it
1045 simply overwrites files with those specified in the tree or
1046 commit.  All merging is assumed to have taken place
1047 independently of <em>git svn</em> functions.</p>
1048 </dd>
1049 <dt class="hdlist1"><em>create-ignore</em></dt>
1050 <dd>
1051 <p>Recursively finds the svn:ignore and svn:global-ignores properties
1052 on directories and creates matching .gitignore files. The resulting
1053 files are staged to be committed, but are not committed. Use
1054 -r/--revision to refer to a specific revision.</p>
1055 </dd>
1056 <dt class="hdlist1"><em>show-ignore</em></dt>
1057 <dd>
1058 <p>Recursively finds and lists the svn:ignore and svn:global-ignores
1059 properties on directories. The output is suitable for appending to
1060 the $GIT_DIR/info/exclude file.</p>
1061 </dd>
1062 <dt class="hdlist1"><em>mkdirs</em></dt>
1063 <dd>
1064 <p>Attempts to recreate empty directories that core Git cannot track
1065 based on information in $GIT_DIR/svn/&lt;refname&gt;/unhandled.log files.
1066 Empty directories are automatically recreated when using
1067 "git svn clone" and "git svn rebase", so "mkdirs" is intended
1068 for use after commands like "git checkout" or "git reset".
1069 (See the svn-remote.&lt;name&gt;.automkdirs config file option for
1070 more information.)</p>
1071 </dd>
1072 <dt class="hdlist1"><em>commit-diff</em></dt>
1073 <dd>
1074 <p>Commits the diff of two tree-ish arguments from the
1075 command-line.  This command does not rely on being inside a <code>git</code> <code>svn</code>
1076 <code>init</code>-ed repository.  This command takes three arguments, (a) the
1077 original tree to diff against, (b) the new tree result, (c) the
1078 URL of the target Subversion repository.  The final argument
1079 (URL) may be omitted if you are working from a <em>git svn</em>-aware
1080 repository (that has been <code>init</code>-ed with <em>git svn</em>).
1081 The -r&lt;revision&gt; option is required for this.</p>
1082 <div class="paragraph">
1083 <p>The commit message is supplied either directly with the <code>-m</code> or <code>-F</code>
1084 option, or indirectly from the tag or commit when the second tree-ish
1085 denotes such an object, or it is requested by invoking an editor (see
1086 <code>--edit</code> option below).</p>
1087 </div>
1088 <div class="dlist">
1089 <dl>
1090 <dt class="hdlist1">-m &lt;msg&gt;</dt>
1091 <dt class="hdlist1">--message=&lt;msg&gt;</dt>
1092 <dd>
1093 <p>Use the given <code>msg</code> as the commit message. This option
1094 disables the <code>--edit</code> option.</p>
1095 </dd>
1096 <dt class="hdlist1">-F &lt;filename&gt;</dt>
1097 <dt class="hdlist1">--file=&lt;filename&gt;</dt>
1098 <dd>
1099 <p>Take the commit message from the given file. This option
1100 disables the <code>--edit</code> option.</p>
1101 </dd>
1102 </dl>
1103 </div>
1104 </dd>
1105 <dt class="hdlist1"><em>info</em></dt>
1106 <dd>
1107 <p>Shows information about a file or directory similar to what
1108 &#8216;svn info&#8217; provides.  Does not currently support a -r/--revision
1109 argument.  Use the --url option to output only the value of the
1110 <em>URL:</em> field.</p>
1111 </dd>
1112 <dt class="hdlist1"><em>proplist</em></dt>
1113 <dd>
1114 <p>Lists the properties stored in the Subversion repository about a
1115 given file or directory.  Use -r/--revision to refer to a specific
1116 Subversion revision.</p>
1117 </dd>
1118 <dt class="hdlist1"><em>propget</em></dt>
1119 <dd>
1120 <p>Gets the Subversion property given as the first argument, for a
1121 file.  A specific revision can be specified with -r/--revision.</p>
1122 </dd>
1123 <dt class="hdlist1"><em>propset</em></dt>
1124 <dd>
1125 <p>Sets the Subversion property given as the first argument, to the
1126 value given as the second argument for the file given as the
1127 third argument.</p>
1128 <div class="paragraph">
1129 <p>Example:</p>
1130 </div>
1131 <div class="listingblock">
1132 <div class="content">
1133 <pre>git svn propset svn:keywords "FreeBSD=%H" devel/py-tipper/Makefile</pre>
1134 </div>
1135 </div>
1136 <div class="paragraph">
1137 <p>This will set the property <em>svn:keywords</em> to <em>FreeBSD=%H</em> for the file
1138 <em>devel/py-tipper/Makefile</em>.</p>
1139 </div>
1140 </dd>
1141 <dt class="hdlist1"><em>show-externals</em></dt>
1142 <dd>
1143 <p>Shows the Subversion externals.  Use -r/--revision to specify a
1144 specific revision.</p>
1145 </dd>
1146 <dt class="hdlist1"><em>gc</em></dt>
1147 <dd>
1148 <p>Compress $GIT_DIR/svn/&lt;refname&gt;/unhandled.log files and remove
1149 $GIT_DIR/svn/&lt;refname&gt;/index files.</p>
1150 </dd>
1151 <dt class="hdlist1"><em>reset</em></dt>
1152 <dd>
1153 <p>Undoes the effects of <em>fetch</em> back to the specified revision.
1154 This allows you to re-<em>fetch</em> an SVN revision.  Normally the
1155 contents of an SVN revision should never change and <em>reset</em>
1156 should not be necessary.  However, if SVN permissions change,
1157 or if you alter your --ignore-paths option, a <em>fetch</em> may fail
1158 with "not found in commit" (file not previously visible) or
1159 "checksum mismatch" (missed a modification).  If the problem
1160 file cannot be ignored forever (with --ignore-paths) the only
1161 way to repair the repo is to use <em>reset</em>.</p>
1162 <div class="paragraph">
1163 <p>Only the rev_map and refs/remotes/git-svn are changed (see
1164 <em>$GIT_DIR/svn/**/.rev_map.*</em> in the FILES section below for details).
1165 Follow <em>reset</em> with a <em>fetch</em> and then <em>git reset</em> or <em>git rebase</em> to
1166 move local branches onto the new tree.</p>
1167 </div>
1168 <div class="dlist">
1169 <dl>
1170 <dt class="hdlist1">-r &lt;n&gt;</dt>
1171 <dt class="hdlist1">--revision=&lt;n&gt;</dt>
1172 <dd>
1173 <p>Specify the most recent revision to keep.  All later revisions
1174 are discarded.</p>
1175 </dd>
1176 <dt class="hdlist1">-p</dt>
1177 <dt class="hdlist1">--parent</dt>
1178 <dd>
1179 <p>Discard the specified revision as well, keeping the nearest
1180 parent instead.</p>
1181 </dd>
1182 <dt class="hdlist1">Example:</dt>
1183 <dd>
1184 <p>Assume you have local changes in "master", but you need to refetch "r2".</p>
1185 <div class="listingblock">
1186 <div class="content">
1187 <pre>    r1---r2---r3 remotes/git-svn
1188                 \
1189                  A---B master</pre>
1190 </div>
1191 </div>
1192 <div class="paragraph">
1193 <p>Fix the ignore-paths or SVN permissions problem that caused "r2" to
1194 be incomplete in the first place.  Then:</p>
1195 </div>
1196 <div class="verseblock">
1197 <pre class="content">git svn reset -r2 -p
1198 git svn fetch</pre>
1199 </div>
1200 <div class="listingblock">
1201 <div class="content">
1202 <pre>    r1---r2'--r3' remotes/git-svn
1203       \
1204        r2---r3---A---B master</pre>
1205 </div>
1206 </div>
1207 <div class="paragraph">
1208 <p>Then fixup "master" with <em>git rebase</em>.
1209 Do NOT use <em>git merge</em> or your history will not be compatible with a
1210 future <em>dcommit</em>!</p>
1211 </div>
1212 <div class="verseblock">
1213 <pre class="content">git rebase --onto remotes/git-svn A^ master</pre>
1214 </div>
1215 <div class="listingblock">
1216 <div class="content">
1217 <pre>    r1---r2'--r3' remotes/git-svn
1218                 \
1219                  A'--B' master</pre>
1220 </div>
1221 </div>
1222 </dd>
1223 </dl>
1224 </div>
1225 </dd>
1226 </dl>
1227 </div>
1228 </div>
1229 </div>
1230 <div class="sect1">
1231 <h2 id="_options">OPTIONS</h2>
1232 <div class="sectionbody">
1233 <div class="dlist">
1234 <dl>
1235 <dt class="hdlist1">--shared[=(false|true|umask|group|all|world|everybody)]</dt>
1236 <dt class="hdlist1">--template=&lt;template-directory&gt;</dt>
1237 <dd>
1238 <p>Only used with the <em>init</em> command.
1239 These are passed directly to <em>git init</em>.</p>
1240 </dd>
1241 <dt class="hdlist1">-r &lt;arg&gt;</dt>
1242 <dt class="hdlist1">--revision &lt;arg&gt;</dt>
1243 <dd>
1244 <p>Used with the <em>fetch</em> command.</p>
1245 <div class="paragraph">
1246 <p>This allows revision ranges for partial/cauterized history
1247 to be supported.  $NUMBER, $NUMBER1:$NUMBER2 (numeric ranges),
1248 $NUMBER:HEAD, and BASE:$NUMBER are all supported.</p>
1249 </div>
1250 <div class="paragraph">
1251 <p>This can allow you to make partial mirrors when running fetch;
1252 but is generally not recommended because history will be skipped
1253 and lost.</p>
1254 </div>
1255 </dd>
1256 <dt class="hdlist1">-</dt>
1257 <dt class="hdlist1">--stdin</dt>
1258 <dd>
1259 <p>Only used with the <em>set-tree</em> command.</p>
1260 <div class="paragraph">
1261 <p>Read a list of commits from stdin and commit them in reverse
1262 order.  Only the leading sha1 is read from each line, so
1263 <em>git rev-list --pretty=oneline</em> output can be used.</p>
1264 </div>
1265 </dd>
1266 <dt class="hdlist1">--rmdir</dt>
1267 <dd>
1268 <p>Only used with the <em>dcommit</em>, <em>set-tree</em> and <em>commit-diff</em> commands.</p>
1269 <div class="paragraph">
1270 <p>Remove directories from the SVN tree if there are no files left
1271 behind.  SVN can version empty directories, and they are not
1272 removed by default if there are no files left in them.  Git
1273 cannot version empty directories.  Enabling this flag will make
1274 the commit to SVN act like Git.</p>
1275 </div>
1276 <div class="verseblock">
1277 <pre class="content">config key: svn.rmdir</pre>
1278 </div>
1279 </dd>
1280 <dt class="hdlist1">-e</dt>
1281 <dt class="hdlist1">--edit</dt>
1282 <dd>
1283 <p>Only used with the <em>dcommit</em>, <em>set-tree</em> and <em>commit-diff</em> commands.</p>
1284 <div class="paragraph">
1285 <p>Edit the commit message before committing to SVN.  This is off by
1286 default for objects that are commits, and forced on when committing
1287 tree objects.</p>
1288 </div>
1289 <div class="verseblock">
1290 <pre class="content">config key: svn.edit</pre>
1291 </div>
1292 </dd>
1293 <dt class="hdlist1">-l&lt;num&gt;</dt>
1294 <dt class="hdlist1">--find-copies-harder</dt>
1295 <dd>
1296 <p>Only used with the <em>dcommit</em>, <em>set-tree</em> and <em>commit-diff</em> commands.</p>
1297 <div class="paragraph">
1298 <p>They are both passed directly to <em>git diff-tree</em>; see
1299 <a href="git-diff-tree.html">git-diff-tree(1)</a> for more information.</p>
1300 </div>
1301 <div class="verseblock">
1302 <pre class="content">config key: svn.l
1303 config key: svn.findcopiesharder</pre>
1304 </div>
1305 </dd>
1306 <dt class="hdlist1">-A&lt;filename&gt;</dt>
1307 <dt class="hdlist1">--authors-file=&lt;filename&gt;</dt>
1308 <dd>
1309 <p>Syntax is compatible with the file used by <em>git cvsimport</em> but
1310 an empty email address can be supplied with <em>&lt;&gt;</em>:</p>
1311 <div class="listingblock">
1312 <div class="content">
1313 <pre>        loginname = Joe User &lt;user@example.com&gt;</pre>
1314 </div>
1315 </div>
1316 <div class="paragraph">
1317 <p>If this option is specified and <em>git svn</em> encounters an SVN
1318 committer name that does not exist in the authors-file, <em>git svn</em>
1319 will abort operation. The user will then have to add the
1320 appropriate entry.  Re-running the previous <em>git svn</em> command
1321 after the authors-file is modified should continue operation.</p>
1322 </div>
1323 <div class="verseblock">
1324 <pre class="content">config key: svn.authorsfile</pre>
1325 </div>
1326 </dd>
1327 <dt class="hdlist1">--authors-prog=&lt;filename&gt;</dt>
1328 <dd>
1329 <p>If this option is specified, for each SVN committer name that
1330 does not exist in the authors file, the given file is executed
1331 with the committer name as the first argument.  The program is
1332 expected to return a single line of the form "Name &lt;email&gt;" or
1333 "Name &lt;&gt;", which will be treated as if included in the authors
1334 file.</p>
1335 <div class="paragraph">
1336 <p>Due to historical reasons a relative <em>filename</em> is first searched
1337 relative to the current directory for <em>init</em> and <em>clone</em> and relative
1338 to the root of the working tree for <em>fetch</em>. If <em>filename</em> is
1339 not found, it is searched like any other command in <em>$PATH</em>.</p>
1340 </div>
1341 <div class="verseblock">
1342 <pre class="content">config key: svn.authorsProg</pre>
1343 </div>
1344 </dd>
1345 <dt class="hdlist1">-q</dt>
1346 <dt class="hdlist1">--quiet</dt>
1347 <dd>
1348 <p>Make <em>git svn</em> less verbose. Specify a second time to make it
1349 even less verbose.</p>
1350 </dd>
1351 <dt class="hdlist1">-m</dt>
1352 <dt class="hdlist1">--merge</dt>
1353 <dt class="hdlist1">-s&lt;strategy&gt;</dt>
1354 <dt class="hdlist1">--strategy=&lt;strategy&gt;</dt>
1355 <dt class="hdlist1">-p</dt>
1356 <dt class="hdlist1">--rebase-merges</dt>
1357 <dd>
1358 <p>These are only used with the <em>dcommit</em> and <em>rebase</em> commands.</p>
1359 <div class="paragraph">
1360 <p>Passed directly to <em>git rebase</em> when using <em>dcommit</em> if a
1361 <em>git reset</em> cannot be used (see <em>dcommit</em>).</p>
1362 </div>
1363 </dd>
1364 <dt class="hdlist1">-n</dt>
1365 <dt class="hdlist1">--dry-run</dt>
1366 <dd>
1367 <p>This can be used with the <em>dcommit</em>, <em>rebase</em>, <em>branch</em> and
1368 <em>tag</em> commands.</p>
1369 <div class="paragraph">
1370 <p>For <em>dcommit</em>, print out the series of Git arguments that would show
1371 which diffs would be committed to SVN.</p>
1372 </div>
1373 <div class="paragraph">
1374 <p>For <em>rebase</em>, display the local branch associated with the upstream svn
1375 repository associated with the current branch and the URL of svn
1376 repository that will be fetched from.</p>
1377 </div>
1378 <div class="paragraph">
1379 <p>For <em>branch</em> and <em>tag</em>, display the urls that will be used for copying when
1380 creating the branch or tag.</p>
1381 </div>
1382 </dd>
1383 <dt class="hdlist1">--use-log-author</dt>
1384 <dd>
1385 <p>When retrieving svn commits into Git (as part of <em>fetch</em>, <em>rebase</em>, or
1386 <em>dcommit</em> operations), look for the first <code>From:</code> line or <code>Signed-off-by</code> trailer
1387 in the log message and use that as the author string.</p>
1388 <div class="verseblock">
1389 <pre class="content">config key: svn.useLogAuthor</pre>
1390 </div>
1391 </dd>
1392 <dt class="hdlist1">--add-author-from</dt>
1393 <dd>
1394 <p>When committing to svn from Git (as part of <em>set-tree</em> or <em>dcommit</em>
1395 operations), if the existing log message doesn&#8217;t already have a
1396 <code>From:</code> or <code>Signed-off-by</code> trailer, append a <code>From:</code> line based on the
1397 Git commit&#8217;s author string.  If you use this, then <code>--use-log-author</code>
1398 will retrieve a valid author string for all commits.</p>
1399 <div class="verseblock">
1400 <pre class="content">config key: svn.addAuthorFrom</pre>
1401 </div>
1402 </dd>
1403 </dl>
1404 </div>
1405 </div>
1406 </div>
1407 <div class="sect1">
1408 <h2 id="_advanced_options">ADVANCED OPTIONS</h2>
1409 <div class="sectionbody">
1410 <div class="dlist">
1411 <dl>
1412 <dt class="hdlist1">-i&lt;GIT_SVN_ID&gt;</dt>
1413 <dt class="hdlist1">--id &lt;GIT_SVN_ID&gt;</dt>
1414 <dd>
1415 <p>This sets GIT_SVN_ID (instead of using the environment).  This
1416 allows the user to override the default refname to fetch from
1417 when tracking a single URL.  The <em>log</em> and <em>dcommit</em> commands
1418 no longer require this switch as an argument.</p>
1419 </dd>
1420 <dt class="hdlist1">-R&lt;remote-name&gt;</dt>
1421 <dt class="hdlist1">--svn-remote &lt;remote-name&gt;</dt>
1422 <dd>
1423 <p>Specify the [svn-remote "&lt;remote-name&gt;"] section to use,
1424 this allows SVN multiple repositories to be tracked.
1425 Default: "svn"</p>
1426 </dd>
1427 <dt class="hdlist1">--follow-parent</dt>
1428 <dd>
1429 <p>This option is only relevant if we are tracking branches (using
1430 one of the repository layout options --trunk, --tags,
1431 --branches, --stdlayout). For each tracked branch, try to find
1432 out where its revision was copied from, and set
1433 a suitable parent in the first Git commit for the branch.
1434 This is especially helpful when we&#8217;re tracking a directory
1435 that has been moved around within the repository.  If this
1436 feature is disabled, the branches created by <em>git svn</em> will all
1437 be linear and not share any history, meaning that there will be
1438 no information on where branches were branched off or merged.
1439 However, following long/convoluted histories can take a long
1440 time, so disabling this feature may speed up the cloning
1441 process. This feature is enabled by default, use
1442 --no-follow-parent to disable it.</p>
1443 <div class="verseblock">
1444 <pre class="content">config key: svn.followparent</pre>
1445 </div>
1446 </dd>
1447 </dl>
1448 </div>
1449 </div>
1450 </div>
1451 <div class="sect1">
1452 <h2 id="_config_file_only_options">CONFIG FILE-ONLY OPTIONS</h2>
1453 <div class="sectionbody">
1454 <div class="dlist">
1455 <dl>
1456 <dt class="hdlist1">svn.noMetadata</dt>
1457 <dt class="hdlist1">svn-remote.&lt;name&gt;.noMetadata</dt>
1458 <dd>
1459 <p>This gets rid of the <em>git-svn-id:</em> lines at the end of every commit.</p>
1460 <div class="paragraph">
1461 <p>This option can only be used for one-shot imports as <em>git svn</em>
1462 will not be able to fetch again without metadata. Additionally,
1463 if you lose your <em>$GIT_DIR/svn/**/.rev_map.*</em> files, <em>git svn</em> will not
1464 be able to rebuild them.</p>
1465 </div>
1466 <div class="paragraph">
1467 <p>The <em>git svn log</em> command will not work on repositories using
1468 this, either.  Using this conflicts with the <em>useSvmProps</em>
1469 option for (hopefully) obvious reasons.</p>
1470 </div>
1471 <div class="paragraph">
1472 <p>This option is NOT recommended as it makes it difficult to track down
1473 old references to SVN revision numbers in existing documentation, bug
1474 reports, and archives.  If you plan to eventually migrate from SVN to
1475 Git and are certain about dropping SVN history, consider
1476 <a href="https://github.com/newren/git-filter-repo">git-filter-repo</a> instead.
1477 filter-repo also allows reformatting of metadata for ease-of-reading
1478 and rewriting authorship info for non-"svn.authorsFile" users.</p>
1479 </div>
1480 </dd>
1481 <dt class="hdlist1">svn.useSvmProps</dt>
1482 <dt class="hdlist1">svn-remote.&lt;name&gt;.useSvmProps</dt>
1483 <dd>
1484 <p>This allows <em>git svn</em> to re-map repository URLs and UUIDs from
1485 mirrors created using SVN::Mirror (or svk) for metadata.</p>
1486 <div class="paragraph">
1487 <p>If an SVN revision has a property, "svm:headrev", it is likely
1488 that the revision was created by SVN::Mirror (also used by SVK).
1489 The property contains a repository UUID and a revision.  We want
1490 to make it look like we are mirroring the original URL, so
1491 introduce a helper function that returns the original identity
1492 URL and UUID, and use it when generating metadata in commit
1493 messages.</p>
1494 </div>
1495 </dd>
1496 <dt class="hdlist1">svn.useSvnsyncProps</dt>
1497 <dt class="hdlist1">svn-remote.&lt;name&gt;.useSvnsyncprops</dt>
1498 <dd>
1499 <p>Similar to the useSvmProps option; this is for users
1500 of the svnsync(1) command distributed with SVN 1.4.x and
1501 later.</p>
1502 </dd>
1503 <dt class="hdlist1">svn-remote.&lt;name&gt;.rewriteRoot</dt>
1504 <dd>
1505 <p>This allows users to create repositories from alternate
1506 URLs.  For example, an administrator could run <em>git svn</em> on the
1507 server locally (accessing via file://) but wish to distribute
1508 the repository with a public http:// or svn:// URL in the
1509 metadata so users of it will see the public URL.</p>
1510 </dd>
1511 <dt class="hdlist1">svn-remote.&lt;name&gt;.rewriteUUID</dt>
1512 <dd>
1513 <p>Similar to the useSvmProps option; this is for users who need
1514 to remap the UUID manually. This may be useful in situations
1515 where the original UUID is not available via either useSvmProps
1516 or useSvnsyncProps.</p>
1517 </dd>
1518 <dt class="hdlist1">svn-remote.&lt;name&gt;.pushurl</dt>
1519 <dd>
1520 <p>Similar to Git&#8217;s <code>remote.</code><em>&lt;name&gt;</em><code>.pushurl</code>, this key is designed
1521 to be used in cases where <em>url</em> points to an SVN repository
1522 via a read-only transport, to provide an alternate read/write
1523 transport. It is assumed that both keys point to the same
1524 repository. Unlike <em>commiturl</em>, <em>pushurl</em> is a base path. If
1525 either <em>commiturl</em> or <em>pushurl</em> could be used, <em>commiturl</em>
1526 takes precedence.</p>
1527 </dd>
1528 <dt class="hdlist1">svn.brokenSymlinkWorkaround</dt>
1529 <dd>
1530 <p>This disables potentially expensive checks to workaround
1531 broken symlinks checked into SVN by broken clients.  Set this
1532 option to "false" if you track a SVN repository with many
1533 empty blobs that are not symlinks.  This option may be changed
1534 while <em>git svn</em> is running and take effect on the next
1535 revision fetched.  If unset, <em>git svn</em> assumes this option to
1536 be "true".</p>
1537 </dd>
1538 <dt class="hdlist1">svn.pathnameencoding</dt>
1539 <dd>
1540 <p>This instructs git svn to recode pathnames to a given encoding.
1541 It can be used by windows users and by those who work in non-utf8
1542 locales to avoid corrupted file names with non-ASCII characters.
1543 Valid encodings are the ones supported by Perl&#8217;s Encode module.</p>
1544 </dd>
1545 <dt class="hdlist1">svn-remote.&lt;name&gt;.automkdirs</dt>
1546 <dd>
1547 <p>Normally, the "git svn clone" and "git svn rebase" commands
1548 attempt to recreate empty directories that are in the
1549 Subversion repository.  If this option is set to "false", then
1550 empty directories will only be created if the "git svn mkdirs"
1551 command is run explicitly.  If unset, <em>git svn</em> assumes this
1552 option to be "true".</p>
1553 </dd>
1554 </dl>
1555 </div>
1556 <div class="paragraph">
1557 <p>Since the noMetadata, rewriteRoot, rewriteUUID, useSvnsyncProps and useSvmProps
1558 options all affect the metadata generated and used by <em>git svn</em>; they
1559 <strong>must</strong> be set in the configuration file before any history is imported
1560 and these settings should never be changed once they are set.</p>
1561 </div>
1562 <div class="paragraph">
1563 <p>Additionally, only one of these options can be used per svn-remote
1564 section because they affect the <em>git-svn-id:</em> metadata line, except
1565 for rewriteRoot and rewriteUUID which can be used together.</p>
1566 </div>
1567 </div>
1568 </div>
1569 <div class="sect1">
1570 <h2 id="_basic_examples">BASIC EXAMPLES</h2>
1571 <div class="sectionbody">
1572 <div class="paragraph">
1573 <p>Tracking and contributing to the trunk of a Subversion-managed project
1574 (ignoring tags and branches):</p>
1575 </div>
1576 <div class="listingblock">
1577 <div class="content">
1578 <pre># Clone a repo (like git clone):
1579         git svn clone http://svn.example.com/project/trunk
1580 # Enter the newly cloned directory:
1581         cd trunk
1582 # You should be on master branch, double-check with 'git branch'
1583         git branch
1584 # Do some work and commit locally to Git:
1585         git commit ...
1586 # Something is committed to SVN, rebase your local changes against the
1587 # latest changes in SVN:
1588         git svn rebase
1589 # Now commit your changes (that were committed previously using Git) to SVN,
1590 # as well as automatically updating your working HEAD:
1591         git svn dcommit
1592 # Append svn:ignore and svn:global-ignores settings to the default Git exclude file:
1593         git svn show-ignore &gt;&gt; .git/info/exclude</pre>
1594 </div>
1595 </div>
1596 <div class="paragraph">
1597 <p>Tracking and contributing to an entire Subversion-managed project
1598 (complete with a trunk, tags and branches):</p>
1599 </div>
1600 <div class="listingblock">
1601 <div class="content">
1602 <pre># Clone a repo with standard SVN directory layout (like git clone):
1603         git svn clone http://svn.example.com/project --stdlayout --prefix svn/
1604 # Or, if the repo uses a non-standard directory layout:
1605         git svn clone http://svn.example.com/project -T tr -b branch -t tag --prefix svn/
1606 # View all branches and tags you have cloned:
1607         git branch -r
1608 # Create a new branch in SVN
1609         git svn branch waldo
1610 # Reset your master to trunk (or any other branch, replacing 'trunk'
1611 # with the appropriate name):
1612         git reset --hard svn/trunk
1613 # You may only dcommit to one branch/tag/trunk at a time.  The usage
1614 # of dcommit/rebase/show-ignore should be the same as above.</pre>
1615 </div>
1616 </div>
1617 <div class="paragraph">
1618 <p>The initial <em>git svn clone</em> can be quite time-consuming
1619 (especially for large Subversion repositories). If multiple
1620 people (or one person with multiple machines) want to use
1621 <em>git svn</em> to interact with the same Subversion repository, you can
1622 do the initial <em>git svn clone</em> to a repository on a server and
1623 have each person clone that repository with <em>git clone</em>:</p>
1624 </div>
1625 <div class="listingblock">
1626 <div class="content">
1627 <pre># Do the initial import on a server
1628         ssh server "cd /pub &amp;&amp; git svn clone http://svn.example.com/project [options...]"
1629 # Clone locally - make sure the refs/remotes/ space matches the server
1630         mkdir project
1631         cd project
1632         git init
1633         git remote add origin server:/pub/project
1634         git config --replace-all remote.origin.fetch '+refs/remotes/*:refs/remotes/*'
1635         git fetch
1636 # Prevent fetch/pull from remote Git server in the future,
1637 # we only want to use git svn for future updates
1638         git config --remove-section remote.origin
1639 # Create a local branch from one of the branches just fetched
1640         git checkout -b master FETCH_HEAD
1641 # Initialize 'git svn' locally (be sure to use the same URL and
1642 # --stdlayout/-T/-b/-t/--prefix options as were used on server)
1643         git svn init http://svn.example.com/project [options...]
1644 # Pull the latest changes from Subversion
1645         git svn rebase</pre>
1646 </div>
1647 </div>
1648 </div>
1649 </div>
1650 <div class="sect1">
1651 <h2 id="_rebase_vs_pullmerge">REBASE VS. PULL/MERGE</h2>
1652 <div class="sectionbody">
1653 <div class="paragraph">
1654 <p>Prefer to use <em>git svn rebase</em> or <em>git rebase</em>, rather than
1655 <em>git pull</em> or <em>git merge</em> to synchronize unintegrated commits with a <em>git svn</em>
1656 branch. Doing so will keep the history of unintegrated commits linear with
1657 respect to the upstream SVN repository and allow the use of the preferred
1658 <em>git svn dcommit</em> subcommand to push unintegrated commits back into SVN.</p>
1659 </div>
1660 <div class="paragraph">
1661 <p>Originally, <em>git svn</em> recommended that developers pulled or merged from
1662 the <em>git svn</em> branch.  This was because the author favored
1663 <code>git</code> <code>svn</code> <code>set-tree</code> <code>B</code> to commit a single head rather than the
1664 <code>git</code> <code>svn</code> <code>set-tree</code> <code>A</code><code>..</code><code>B</code> notation to commit multiple commits. Use of
1665 <em>git pull</em> or <em>git merge</em> with <code>git</code> <code>svn</code> <code>set-tree</code> <code>A</code><code>..</code><code>B</code> will cause non-linear
1666 history to be flattened when committing into SVN and this can lead to merge
1667 commits unexpectedly reversing previous commits in SVN.</p>
1668 </div>
1669 </div>
1670 </div>
1671 <div class="sect1">
1672 <h2 id="_merge_tracking">MERGE TRACKING</h2>
1673 <div class="sectionbody">
1674 <div class="paragraph">
1675 <p>While <em>git svn</em> can track
1676 copy history (including branches and tags) for repositories adopting a
1677 standard layout, it cannot yet represent merge history that happened
1678 inside git back upstream to SVN users.  Therefore it is advised that
1679 users keep history as linear as possible inside Git to ease
1680 compatibility with SVN (see the CAVEATS section below).</p>
1681 </div>
1682 </div>
1683 </div>
1684 <div class="sect1">
1685 <h2 id="_handling_of_svn_branches">HANDLING OF SVN BRANCHES</h2>
1686 <div class="sectionbody">
1687 <div class="paragraph">
1688 <p>If <em>git svn</em> is configured to fetch branches (and --follow-branches
1689 is in effect), it sometimes creates multiple Git branches for one
1690 SVN branch, where the additional branches have names of the form
1691 <em>branchname@nnn</em> (with nnn an SVN revision number).  These additional
1692 branches are created if <em>git svn</em> cannot find a parent commit for the
1693 first commit in an SVN branch, to connect the branch to the history of
1694 the other branches.</p>
1695 </div>
1696 <div class="paragraph">
1697 <p>Normally, the first commit in an SVN branch consists
1698 of a copy operation. <em>git svn</em> will read this commit to get the SVN
1699 revision the branch was created from. It will then try to find the
1700 Git commit that corresponds to this SVN revision, and use that as the
1701 parent of the branch. However, it is possible that there is no suitable
1702 Git commit to serve as parent.  This will happen, among other reasons,
1703 if the SVN branch is a copy of a revision that was not fetched by <em>git
1704 svn</em> (e.g. because it is an old revision that was skipped with
1705 <code>--revision</code>), or if in SVN a directory was copied that is not tracked
1706 by <em>git svn</em> (such as a branch that is not tracked at all, or a
1707 subdirectory of a tracked branch). In these cases, <em>git svn</em> will still
1708 create a Git branch, but instead of using an existing Git commit as the
1709 parent of the branch, it will read the SVN history of the directory the
1710 branch was copied from and create appropriate Git commits.  This is
1711 indicated by the message "Initializing parent: &lt;branchname&gt;".</p>
1712 </div>
1713 <div class="paragraph">
1714 <p>Additionally, it will create a special branch named
1715 <em>&lt;branchname&gt;@&lt;SVN-Revision&gt;</em>, where &lt;SVN-Revision&gt; is the SVN revision
1716 number the branch was copied from.  This branch will point to the newly
1717 created parent commit of the branch.  If in SVN the branch was deleted
1718 and later recreated from a different version, there will be multiple
1719 such branches with an <em>@</em>.</p>
1720 </div>
1721 <div class="paragraph">
1722 <p>Note that this may mean that multiple Git commits are created for a
1723 single SVN revision.</p>
1724 </div>
1725 <div class="paragraph">
1726 <p>An example: in an SVN repository with a standard
1727 trunk/tags/branches layout, a directory trunk/sub is created in r.100.
1728 In r.200, trunk/sub is branched by copying it to branches/. <em>git svn
1729 clone -s</em> will then create a branch <em>sub</em>. It will also create new Git
1730 commits for r.100 through r.199 and use these as the history of branch
1731 <em>sub</em>. Thus there will be two Git commits for each revision from r.100
1732 to r.199 (one containing trunk/, one containing trunk/sub/). Finally,
1733 it will create a branch <em>sub@200</em> pointing to the new parent commit of
1734 branch <em>sub</em> (i.e. the commit for r.200 and trunk/sub/).</p>
1735 </div>
1736 </div>
1737 </div>
1738 <div class="sect1">
1739 <h2 id="_caveats">CAVEATS</h2>
1740 <div class="sectionbody">
1741 <div class="paragraph">
1742 <p>For the sake of simplicity and interoperating with Subversion,
1743 it is recommended that all <em>git svn</em> users clone, fetch and dcommit
1744 directly from the SVN server, and avoid all <em>git clone</em>/<em>pull</em>/<em>merge</em>/<em>push</em>
1745 operations between Git repositories and branches.  The recommended
1746 method of exchanging code between Git branches and users is
1747 <em>git format-patch</em> and <em>git am</em>, or just 'dcommit&#8217;ing to the SVN repository.</p>
1748 </div>
1749 <div class="paragraph">
1750 <p>Running <em>git merge</em> or <em>git pull</em> is NOT recommended on a branch you
1751 plan to <em>dcommit</em> from because Subversion users cannot see any
1752 merges you&#8217;ve made.  Furthermore, if you merge or pull from a Git branch
1753 that is a mirror of an SVN branch, <em>dcommit</em> may commit to the wrong
1754 branch.</p>
1755 </div>
1756 <div class="paragraph">
1757 <p>If you do merge, note the following rule: <em>git svn dcommit</em> will
1758 attempt to commit on top of the SVN commit named in</p>
1759 </div>
1760 <div class="listingblock">
1761 <div class="content">
1762 <pre>git log --grep=^git-svn-id: --first-parent -1</pre>
1763 </div>
1764 </div>
1765 <div class="paragraph">
1766 <p>You <em>must</em> therefore ensure that the most recent commit of the branch
1767 you want to dcommit to is the <em>first</em> parent of the merge.  Chaos will
1768 ensue otherwise, especially if the first parent is an older commit on
1769 the same SVN branch.</p>
1770 </div>
1771 <div class="paragraph">
1772 <p><em>git clone</em> does not clone branches under the refs/remotes/ hierarchy or
1773 any <em>git svn</em> metadata, or config.  So repositories created and managed with
1774 using <em>git svn</em> should use <em>rsync</em> for cloning, if cloning is to be done
1775 at all.</p>
1776 </div>
1777 <div class="paragraph">
1778 <p>Since <em>dcommit</em> uses rebase internally, any Git branches you <em>git push</em> to
1779 before <em>dcommit</em> on will require forcing an overwrite of the existing ref
1780 on the remote repository.  This is generally considered bad practice,
1781 see the <a href="git-push.html">git-push(1)</a> documentation for details.</p>
1782 </div>
1783 <div class="paragraph">
1784 <p>Do not use the --amend option of <a href="git-commit.html">git-commit(1)</a> on a change you&#8217;ve
1785 already dcommitted.  It is considered bad practice to --amend commits
1786 you&#8217;ve already pushed to a remote repository for other users, and
1787 dcommit with SVN is analogous to that.</p>
1788 </div>
1789 <div class="paragraph">
1790 <p>When cloning an SVN repository, if none of the options for describing
1791 the repository layout is used (--trunk, --tags, --branches,
1792 --stdlayout), <em>git svn clone</em> will create a Git repository with
1793 completely linear history, where branches and tags appear as separate
1794 directories in the working copy.  While this is the easiest way to get a
1795 copy of a complete repository, for projects with many branches it will
1796 lead to a working copy many times larger than just the trunk. Thus for
1797 projects using the standard directory structure (trunk/branches/tags),
1798 it is recommended to clone with option <code>--stdlayout</code>. If the project
1799 uses a non-standard structure, and/or if branches and tags are not
1800 required, it is easiest to only clone one directory (typically trunk),
1801 without giving any repository layout options.  If the full history with
1802 branches and tags is required, the options <code>--trunk</code> / <code>--branches</code> /
1803 <code>--tags</code> must be used.</p>
1804 </div>
1805 <div class="paragraph">
1806 <p>When using multiple --branches or --tags, <em>git svn</em> does not automatically
1807 handle name collisions (for example, if two branches from different paths have
1808 the same name, or if a branch and a tag have the same name).  In these cases,
1809 use <em>init</em> to set up your Git repository then, before your first <em>fetch</em>, edit
1810 the $GIT_DIR/config file so that the branches and tags are associated
1811 with different name spaces.  For example:</p>
1812 </div>
1813 <div class="literalblock">
1814 <div class="content">
1815 <pre>branches = stable/*:refs/remotes/svn/stable/*
1816 branches = debug/*:refs/remotes/svn/debug/*</pre>
1817 </div>
1818 </div>
1819 </div>
1820 </div>
1821 <div class="sect1">
1822 <h2 id="_configuration">CONFIGURATION</h2>
1823 <div class="sectionbody">
1824 <div class="paragraph">
1825 <p><em>git svn</em> stores [svn-remote] configuration information in the
1826 repository $GIT_DIR/config file.  It is similar the core Git
1827 [remote] sections except <em>fetch</em> keys do not accept glob
1828 arguments; but they are instead handled by the <em>branches</em>
1829 and <em>tags</em> keys.  Since some SVN repositories are oddly
1830 configured with multiple projects glob expansions such those
1831 listed below are allowed:</p>
1832 </div>
1833 <div class="listingblock">
1834 <div class="content">
1835 <pre>[svn-remote "project-a"]
1836         url = http://server.org/svn
1837         fetch = trunk/project-a:refs/remotes/project-a/trunk
1838         branches = branches/*/project-a:refs/remotes/project-a/branches/*
1839         branches = branches/release_*:refs/remotes/project-a/branches/release_*
1840         branches = branches/re*se:refs/remotes/project-a/branches/*
1841         tags = tags/*/project-a:refs/remotes/project-a/tags/*</pre>
1842 </div>
1843 </div>
1844 <div class="paragraph">
1845 <p>Keep in mind that the * (asterisk) wildcard of the local ref
1846 (right of the <code>:</code>) <strong>must</strong> be the farthest right path component;
1847 however the remote wildcard may be anywhere as long as it&#8217;s an
1848 independent path component (surrounded by <code>/</code> or EOL).   This
1849 type of configuration is not automatically created by <em>init</em> and
1850 should be manually entered with a text-editor or using <em>git config</em>.</p>
1851 </div>
1852 <div class="paragraph">
1853 <p>Also note that only one asterisk is allowed per word. For example:</p>
1854 </div>
1855 <div class="literalblock">
1856 <div class="content">
1857 <pre>branches = branches/re*se:refs/remotes/project-a/branches/*</pre>
1858 </div>
1859 </div>
1860 <div class="paragraph">
1861 <p>will match branches <em>release</em>, <em>rese</em>, <em>re123se</em>, however</p>
1862 </div>
1863 <div class="literalblock">
1864 <div class="content">
1865 <pre>branches = branches/re*s*e:refs/remotes/project-a/branches/*</pre>
1866 </div>
1867 </div>
1868 <div class="paragraph">
1869 <p>will produce an error.</p>
1870 </div>
1871 <div class="paragraph">
1872 <p>It is also possible to fetch a subset of branches or tags by using a
1873 comma-separated list of names within braces. For example:</p>
1874 </div>
1875 <div class="listingblock">
1876 <div class="content">
1877 <pre>[svn-remote "huge-project"]
1878         url = http://server.org/svn
1879         fetch = trunk/src:refs/remotes/trunk
1880         branches = branches/{red,green}/src:refs/remotes/project-a/branches/*
1881         tags = tags/{1.0,2.0}/src:refs/remotes/project-a/tags/*</pre>
1882 </div>
1883 </div>
1884 <div class="paragraph">
1885 <p>Multiple fetch, branches, and tags keys are supported:</p>
1886 </div>
1887 <div class="listingblock">
1888 <div class="content">
1889 <pre>[svn-remote "messy-repo"]
1890         url = http://server.org/svn
1891         fetch = trunk/project-a:refs/remotes/project-a/trunk
1892         fetch = branches/demos/june-project-a-demo:refs/remotes/project-a/demos/june-demo
1893         branches = branches/server/*:refs/remotes/project-a/branches/*
1894         branches = branches/demos/2011/*:refs/remotes/project-a/2011-demos/*
1895         tags = tags/server/*:refs/remotes/project-a/tags/*</pre>
1896 </div>
1897 </div>
1898 <div class="paragraph">
1899 <p>Creating a branch in such a configuration requires disambiguating which
1900 location to use using the -d or --destination flag:</p>
1901 </div>
1902 <div class="listingblock">
1903 <div class="content">
1904 <pre>$ git svn branch -d branches/server release-2-3-0</pre>
1905 </div>
1906 </div>
1907 <div class="paragraph">
1908 <p>Note that git-svn keeps track of the highest revision in which a branch
1909 or tag has appeared. If the subset of branches or tags is changed after
1910 fetching, then $GIT_DIR/svn/.metadata must be manually edited to remove
1911 (or reset) branches-maxRev and/or tags-maxRev as appropriate.</p>
1912 </div>
1913 </div>
1914 </div>
1915 <div class="sect1">
1916 <h2 id="_files">FILES</h2>
1917 <div class="sectionbody">
1918 <div class="dlist">
1919 <dl>
1920 <dt class="hdlist1">$GIT_DIR/svn/**/.rev_map.*</dt>
1921 <dd>
1922 <p>Mapping between Subversion revision numbers and Git commit
1923 names.  In a repository where the noMetadata option is not set,
1924 this can be rebuilt from the git-svn-id: lines that are at the
1925 end of every commit (see the <em>svn.noMetadata</em> section above for
1926 details).</p>
1927 <div class="paragraph">
1928 <p><em>git svn fetch</em> and <em>git svn rebase</em> automatically update the rev_map
1929 if it is missing or not up to date.  <em>git svn reset</em> automatically
1930 rewinds it.</p>
1931 </div>
1932 </dd>
1933 </dl>
1934 </div>
1935 </div>
1936 </div>
1937 <div class="sect1">
1938 <h2 id="_bugs">BUGS</h2>
1939 <div class="sectionbody">
1940 <div class="paragraph">
1941 <p>We ignore all SVN properties except svn:executable.  Any unhandled
1942 properties are logged to $GIT_DIR/svn/&lt;refname&gt;/unhandled.log</p>
1943 </div>
1944 <div class="paragraph">
1945 <p>Renamed and copied directories are not detected by Git and hence not
1946 tracked when committing to SVN.  I do not plan on adding support for
1947 this as it&#8217;s quite difficult and time-consuming to get working for all
1948 the possible corner cases (Git doesn&#8217;t do it, either).  Committing
1949 renamed and copied files is fully supported if they&#8217;re similar enough
1950 for Git to detect them.</p>
1951 </div>
1952 <div class="paragraph">
1953 <p>In SVN, it is possible (though discouraged) to commit changes to a tag
1954 (because a tag is just a directory copy, thus technically the same as a
1955 branch). When cloning an SVN repository, <em>git svn</em> cannot know if such a
1956 commit to a tag will happen in the future. Thus it acts conservatively
1957 and imports all SVN tags as branches, prefixing the tag name with <em>tags/</em>.</p>
1958 </div>
1959 </div>
1960 </div>
1961 <div class="sect1">
1962 <h2 id="_see_also">SEE ALSO</h2>
1963 <div class="sectionbody">
1964 <div class="paragraph">
1965 <p><a href="git-rebase.html">git-rebase(1)</a></p>
1966 </div>
1967 </div>
1968 </div>
1969 <div class="sect1">
1970 <h2 id="_git">GIT</h2>
1971 <div class="sectionbody">
1972 <div class="paragraph">
1973 <p>Part of the <a href="git.html">git(1)</a> suite</p>
1974 </div>
1975 </div>
1976 </div>
1977 </div>
1978 <div id="footer">
1979 <div id="footer-text">
1980 Last updated 2024-08-21 14:01:26 -0700
1981 </div>
1982 </div>
1983 </body>
1984 </html>