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 |