| OLD | NEW |
| (Empty) |
| 1 '\" t | |
| 2 .\" Title: git-auto-svn | |
| 3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] | |
| 4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> | |
| 5 .\" Date: 07/21/2016 | |
| 6 .\" Manual: Chromium depot_tools Manual | |
| 7 .\" Source: depot_tools bf2a341 | |
| 8 .\" Language: English | |
| 9 .\" | |
| 10 .TH "GIT\-AUTO\-SVN" "1" "07/21/2016" "depot_tools bf2a341" "Chromium depot_tool
s Manual" | |
| 11 .\" ----------------------------------------------------------------- | |
| 12 .\" * Define some portability stuff | |
| 13 .\" ----------------------------------------------------------------- | |
| 14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 15 .\" http://bugs.debian.org/507673 | |
| 16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | |
| 17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 18 .ie \n(.g .ds Aq \(aq | |
| 19 .el .ds Aq ' | |
| 20 .\" ----------------------------------------------------------------- | |
| 21 .\" * set default formatting | |
| 22 .\" ----------------------------------------------------------------- | |
| 23 .\" disable hyphenation | |
| 24 .nh | |
| 25 .\" disable justification (adjust text to left margin only) | |
| 26 .ad l | |
| 27 .\" ----------------------------------------------------------------- | |
| 28 .\" * MAIN CONTENT STARTS HERE * | |
| 29 .\" ----------------------------------------------------------------- | |
| 30 .SH "NAME" | |
| 31 git-auto-svn \- Automatically set up git\-svn metadata for a repo mirrored from
SVN\&. | |
| 32 .SH "SYNOPSIS" | |
| 33 .sp | |
| 34 .nf | |
| 35 \fIgit auto\-svn\fR | |
| 36 .fi | |
| 37 .sp | |
| 38 .SH "DESCRIPTION" | |
| 39 .sp | |
| 40 git auto\-svn automatically sets up git\-svn metadata and runs git\-svn fetch fo
r repos that are homed in SVN but mirrored to Git (such as depot_tools itself)\&
. | |
| 41 .sp | |
| 42 It determines the metadata to use by inspecting the git\-svn\-id footer of the H
EAD of the remote upstream ref (by default, origin/master)\&. git\-svn\-id foote
rs look like this: | |
| 43 .sp | |
| 44 .if n \{\ | |
| 45 .RS 4 | |
| 46 .\} | |
| 47 .nf | |
| 48 git\-svn\-id: svn://some\&.host\&.org/repo/path/to/a/sub/folder@123456 0039d316\
-1c4b\-4281\-b951\-d872f2087c98 | |
| 49 .fi | |
| 50 .if n \{\ | |
| 51 .RE | |
| 52 .\} | |
| 53 .sp | |
| 54 git auto\-svn extracts the repository url (svn://some\&.host\&.org/repo/path/to/
a/sub/folder) from the git\-svn\-id, and splits it into the root repository (svn
://some\&.host\&.org/repo) and the path within that repository (/path/to/a/sub/f
older)\&. | |
| 55 .sp | |
| 56 It then sets up the following stanza in \&.git/config: | |
| 57 .sp | |
| 58 .if n \{\ | |
| 59 .RS 4 | |
| 60 .\} | |
| 61 .nf | |
| 62 [svn\-remote "svn"] | |
| 63 url = svn://some\&.host\&.org/repo | |
| 64 fetch = path/to/a/sub/folder:refs/remotes/origin/master | |
| 65 .fi | |
| 66 .if n \{\ | |
| 67 .RE | |
| 68 .\} | |
| 69 .sp | |
| 70 Finally, it runs git svn fetch to pull in the data from the svn remote\&. | |
| 71 .SH "CONFIGURATION VARIABLES" | |
| 72 .SS "svn\-remote\&.svn\&.url" | |
| 73 .sp | |
| 74 This is the url of the root of the remote svn repository\&. | |
| 75 .SS "svn\-remote\&.svn\&.fetch" | |
| 76 .sp | |
| 77 This looks like a git refspec, but maps a subdirectory of the svn repository to
a single ref in the git remote\&. | |
| 78 .SH "EXAMPLE" | |
| 79 .sp | |
| 80 .if n \{\ | |
| 81 .RS 4 | |
| 82 .\} | |
| 83 .nf | |
| 84 git clone https://chromium\&.googlesource\&.com/chromium/tools/depot_tools | |
| 85 cd depot_tools | |
| 86 git auto\-svn | |
| 87 .fi | |
| 88 .if n \{\ | |
| 89 .RE | |
| 90 .\} | |
| 91 .sp | |
| 92 This results in the following stanza in depot_tools/\&.git/config: | |
| 93 .sp | |
| 94 .if n \{\ | |
| 95 .RS 4 | |
| 96 .\} | |
| 97 .nf | |
| 98 [svn\-remote "svn"] | |
| 99 url = svn://svn\&.chromium\&.org/chrome | |
| 100 fetch = trunk/tools/depot_tools:refs/remotes/origin/master | |
| 101 .fi | |
| 102 .if n \{\ | |
| 103 .RE | |
| 104 .\} | |
| 105 .SH "CHROMIUM DEPOT_TOOLS" | |
| 106 .sp | |
| 107 Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assi
st with the development of chromium and related projects\&. Download the tools f
rom \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&. | |
| 108 .SH "NOTES" | |
| 109 .IP " 1." 4 | |
| 110 here | |
| 111 .RS 4 | |
| 112 \%https://chromium.googlesource.com/chromium/tools/depot_tools | |
| 113 .RE | |
| OLD | NEW |