Fixed ``smart'' quotes in code block.

man/man7/depot_tools_tutorial.7

 '\" t
 .\"     Title: depot_tools_tutorial
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 05/09/2014
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
+.\"      Date: 01/13/2015
 .\"    Manual: Chromium depot_tools Manual
-.\"    Source: depot_tools 54dac93
+.\"    Source: depot_tools 379a889
 .\"  Language: English
 .\"
-.TH "DEPOT_TOOLS_TUTORIAL" "7" "05/09/2014" "depot_tools 54dac93" "Chromium depot_tools Manual"
+.TH "DEPOT_TOOLS_TUTORIAL" "7" "01/13/2015" "depot_tools 379a889" "Chromium depot_tools Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .\" http://bugs.debian.org/507673
 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\" -----------------------------------------------------------------
@@ skipping 13 matching lines @@
 The Chromium \fBdepot_tools\fR(7) suite contains many git workflow\-enhancing tools which are designed to work together to enable anyone to wrangle the Chromium codebase expertly\&. This tutorial explains how to do development on Chromium using these tools\&. This will cover:
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Setting up
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Getting the code
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 TL;DR
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Creating / Uploading a CL
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Updating the code
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Managing multiple CLs
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Managing dependent CLs
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 Example Walkthrough
 .RE
 .sp
 Please refer to the manpages (or \-\-help output) for details about any of the commands mentioned in this tutorial\&.
 .if n \{\
 .sp
 .\}
 .RS 4
 .it 1 an-trap
 .nr an-no-space-flag 1
@@ skipping 12 matching lines @@
 This tutorial assumes basic familiarity with git terminology and concepts\&. If you need to brush up on these, the following are very good resources:
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 \m[blue]\fBThink like (a) Git\fR\m[]\&\s-2\u[1]\d\s+2
 \- A lighthearted overview of git\&. If you\(cqre sorta\-familiar with git, but not
 \fIcomfortable\fR
 with it, then give this a look\&.
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 \m[blue]\fBGit Immersion Tutorial\fR\m[]\&\s-2\u[2]\d\s+2
 \- An in\-depth git tutorial\&.
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 \m[blue]\fBpcottle\(cqs Visual Git Branching\fR\m[]\&\s-2\u[3]\d\s+2
 \- An excellent interactive/graphical demo on how git handles commits, branches, and shows the operations git performs on them\&.
 .RE
 .sp
 .RS 4
 .ie n \{\
 \h'-04'\(bu\h'+03'\c
 .\}
 .el \{\
 .sp -1
 .IP \(bu 2.3
 .\}
-
 \m[blue]\fBPro Git book\fR\m[]\&\s-2\u[4]\d\s+2
 \- \(lqThe\(rq book for learning git from basics to advanced concepts\&. A bit dry, but very through\&.
 .RE
 .sp
 If you\(cqve tried these out and are still having some trouble getting started, there are \fImany\fR other resources online which should help\&. If you\(cqre \fIreally\fR \fB\fIreally\fR\fR stuck, then chat up one of the Chromium infrastructure team members for some pointers\&.
 .PP
 Litmus Test
 .RS 4
 If you know what
 git add,
@@ skipping 34 matching lines @@
 .\}
 .sp
 .SS "BOOTSTRAPPING CONFIGURATION"
 .sp
 If you have never used git before, you\(cqll need to set some global git configurations; substitute your name and email address in the following commands:
 .sp
 .if n \{\
 .RS 4
 .\}
 .nf
-\fB$ git config \-\-global user\&.name \(lqJohn Doe\(rq\fR
-\fB$ git config \-\-global user\&.email \(lqjdoe@email\&.com\(rq\fR
+\fB$ git config \-\-global user\&.name "John Doe"\fR
+\fB$ git config \-\-global user\&.email "jdoe@email\&.com"\fR
 \fB$ git config \-\-global core\&.autocrlf false\fR
 \fB$ git config \-\-global core\&.filemode false\fR
 \fB$\fR # and for fun!
 \fB$ git config \-\-global color\&.ui true\fR
 .fi
 .if n \{\
 .RE
 .\}
 .sp
 .SH "TL;DR"
@@ skipping 209 matching lines @@
 origin/master
   cool_feature
     subfeature
   frozen_changes *
   master
 .fi
 .if n \{\
 .RE
 .\}
 .sp
+
 .PP
 \fBgit-map\fR(1)
 .RS 4
 This tool shows you the history of all of your branches in a pseudo\-graphical format\&. In particular, it will show you which commits all of your branches are on, which commit you currently have checked out, and more\&. Check out the doc for the full details\&.
 .RE
 .PP
 \fBgit-map-branches\fR(1)
 .RS 4
 This tool just shows you which branches you have in your repo, and their upstream relationship to each other (as well as which branch you have checked out at the moment)\&.
 .RE
@@ skipping 73 matching lines @@
 .sp
 Let\*(Aqs fix something!
 .sp
 .if n \{\
 .RS 4
 .\}
 .nf
 \fB$ git new\-branch fix_typo\fR
 \fB$ echo \-e \*(Aq/Banana\ens/Banana/Kuun\enwq\*(Aq | ed build/whitespace_file\&.txt\fR
 1503
-1501
 It was a Domo\-Banana\&.
 It was a Domo\-Kuun\&.
+1501
 \fB$ git commit \-am \*(AqFix terrible typo\&.\*(Aq\fR
 [fix_typo 615ffa7] Fix terrible typo\&.
  1 file changed, 1 insertion(+), 1 deletion(\-)
 \fB$ git map\fR
 \fB* 615ffa7    \fR (\fBfix_typo\fR) 2014\-04\-10 ~ Fix terrible typo\&.
 * \fBbeec6f4    \fR (origin/master, origin/HEAD) 2014\-04\-10 ~ Make ReflectorImpl use mailboxes\fB    <(fix_typo)\fR
 * \fB41290e0    \fR 2014\-04\-10 ~ don\*(Aqt use glibc\-specific execinfo\&.h on uclibc builds
 * \fBa76fde7    \fR 2014\-04\-10 ~ [fsp] Add requestUnmount() method together with the request manager\&.
 * \fB9de7a71    \fR 2014\-04\-10 ~ linux_aura: Use system configuration for middle clicking the titlebar\&.
 * \fB073b0c2    \fR 2014\-04\-10 ~ ContentView\->ContentViewCore in ContentViewRenderView
@@ skipping 51 matching lines @@
 .RS 4
 .\}
 .nf
 \fB$ git freeze\fR
 \fB$ git checkout fix_typo\fR
 Switched to branch \*(Aqfix_typo\*(Aq
 Your branch is ahead of \*(Aqorigin/master\*(Aq by 1 commit\&.
   (use "git push" to publish your local commits)
 \fB$ echo \-e \*(Aq/Kuun\ens/Kuun/Kun\enwq\*(Aq | ed build/whitespace_file\&.txt\fR
 1501
-1500
 It was a Domo\-Kuun\&.
 It was a Domo\-Kun\&.
+1500
 \fB$ git upstream\-diff \-\-wordwise\fR
 \fBdiff \-\-git a/build/whitespace_file\&.txt b/build/whitespace_file\&.txt\fR
 \fBindex 3eba355\&.\&.57cdcee 100644\fR
 \fB\-\-\- a/build/whitespace_file\&.txt\fR
 \fB+++ b/build/whitespace_file\&.txt\fR
 @@ \-17,7 +17,7 @@ swept up the streets (for it is in London that our scene lies), rattling along
 the housetops, and fiercely agitating the scanty flame of the lamps that
 struggled against the elements\&. A hooded figure emerged\&.
 
 It was a Domo\-BananaKun\&.
@@ skipping 51 matching lines @@
 changes and commit them, and you can discard any commits you make in this
 state without impacting any branches by performing another checkout\&.
 
 If you want to create a new branch to retain commits you create, you may
 do so (now or later) by using \-b with the checkout command again\&. Example:
 
   git checkout \-b new_branch_name
 
 HEAD is now at beec6f4\&.\&.\&. Make ReflectorImpl use mailboxes
 \fB$ git nav\-downstream\fR
+Previous HEAD position was beec6f4\&.\&.\&. Make ReflectorImpl use mailboxes
+Switched to branch \*(Aqchap2\*(Aq
+Your branch is ahead of \*(Aqorigin/master\*(Aq by 1 commit\&.
+  (use "git push" to publish your local commits)
 Please select a downstream branch
   0\&. chap2
   1\&. fix_typo
 Selection (0\-1)[0]: 0
-Previous HEAD position was beec6f4\&.\&.\&. Make ReflectorImpl use mailboxes
-Switched to branch \*(Aqchap2\*(Aq
-Your branch is ahead of \*(Aqorigin/master\*(Aq by 1 commit\&.
-  (use "git push" to publish your local commits)
 \fB$ git map\-branches\fR
 origin/master
 \fB  chap2 *
 \fR  fix_typo
 .fi
 .if n \{\
 .RE
 .\}
 .sp
 Now we can pick up on chapter2 where we left off\&.
@@ skipping 311 matching lines @@
 .IP " 6." 4
 main Chromium waterfall
 .RS 4
 \%http://build.chromium.org
 .RE
 .IP " 7." 4
 here
 .RS 4
 \%https://chromium.googlesource.com/chromium/tools/depot_tools.git
 .RE