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: 09/30/2014 |
| 6 .\" Manual: Chromium depot_tools Manual |
| 7 .\" Source: depot_tools 2bbacdc |
| 8 .\" Language: English |
| 9 .\" |
| 10 .TH "GIT\-AUTO\-SVN" "1" "09/30/2014" "depot_tools 2bbacdc" "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.git |
| 113 .RE |
OLD | NEW |