<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> 

<base href="https://wiki.asterisk.org/wiki" /> 

<title>Message Title</title>  

<style type="text/css">@media only screen and (max-device-width: 480px) {.mobile-only {

        width: auto !important;

        height: auto !important;

        overflow: visible !important;

        line-height: normal !important;

        font-size: inherit !important;

        mso-hide: all;

}

.desktop-only {

        display: none !important;

}

/* iPhone 3GS fix for unwanted 20px right margin */

body { min-width: 100% !important; padding: 0; margin: 0; }

#center-content-table { max-width: none; !important; }

#header-pattern-container { padding: 10px 10px 10px 10px !important; line-height: 20px !important; }

#header-avatar-image-container { padding-right: 8px !important; }

#email-content-container { padding: 0 !important; }

.mobile-expand { border-radius: 0 !important; border-left: 0 !important; border-right: 0 !important; padding-left: 26px !important;}

.mobile-resize-text { font-size: 16px !important; line-height: 22px !important; }

#page-title-pattern-header { font-size: 20px !important; line-height: 28px !important; }

#page-title-pattern-icon-image-container-cell { padding-top: 7px !important; }

#inline-user-pattern { display: block !important; }

#inline-user-pattern-avatar { padding-top: 3px !important; }

.contextual-area-pattern { border-bottom: 1px solid #ccc !important; padding: 15px 10px 0 10px !important;}

.users-involved-pattern-column-table { width: 100% !important;  }

.users-involved-pattern-avatar-table-cell { padding: 3px 5px 5px 0 !important; }

.users-involved-pattern-column-container { padding-right: 0 !important; }

.contextual-excerpt-pattern, #users-involved-pattern { border: 0 !important; }

/** Aui Typography upsized for mobile **/

#content-excerpt-pattern-container, #contextual-excerpt-pattern-text-container { font-size: 16px !important; line-height: 22px !important; }

#content-excerpt-pattern-container h1, #contextual-excerpt-pattern-text-container h1 { font-size: 24px !important; line-height: 28px !important; }

#content-excerpt-pattern-container h2, #contextual-excerpt-pattern-text-container h2 { font-size: 20px !important; line-height: 28px !important; }

#content-excerpt-pattern-container h3, #contextual-excerpt-pattern-text-container h3 { font-size: 18px !important; line-height: 24px !important; }

#content-excerpt-pattern-container h4, #contextual-excerpt-pattern-text-container h4 { font-size: 16px !important; line-height: 22px !important; }

#content-excerpt-pattern-container h5, #contextual-excerpt-pattern-text-container h5 { font-size: 14px !important; line-height: 20px !important; }

#content-excerpt-pattern-container h6, #contextual-excerpt-pattern-text-container h6 { font-size: 14px !important; line-height: 20px !important; }

.user-mention { line-height: 18px !important; }

/** Aui Typography end **/

/* Show appropriate footer logo on mobile, display links vertically */

#footer-pattern { padding: 15px 10px !important; }

#footer-pattern-logo-desktop-container { padding: 0 !important; }

#footer-pattern-logo-desktop { width: 0 !important; height: 0 !important; }

#footer-pattern-logo-mobile {

    padding-top: 10px !important;

    width: 30px !important;

    height: 27px !important;

    display: inline !important;

}

#footer-pattern-text {

    display: block !important;

}

#footer-pattern-links-container { line-height: 0 !important;}

.footer-pattern-links.mobile-resize-text,

.footer-pattern-links.mobile-resize-text,

#footer-pattern-text.mobile-resize-text,

#footer-pattern-links-container.no-footer-links {

    font-size: 14px !important;

    line-height: 20px !important;

}

.footer-link { display: block !important; }

#footer-pattern-links-container table { display: inline-block !important; float: none !important; }

#footer-pattern-links-container, #footer-pattern-text { text-align: center !important; }

#footer-pattern-links { padding-bottom: 5px !important; }

/** Team Calendar overrides, these should be removed when notifications are updated in Team Calendars. For now CSS

    overrides are being used because the structure of the content can't change without rereleasing the plugin */

.mail-calendar-container .day-header + table tr td:first-child {

    vertical-align: top !important;

    padding-top: 5px !important;

}}

@media (min-width: 900px) {#center-content-table { width: 900px; }}

@media all {#outlook a {padding:0;} /* Force Outlook to provide a "view in browser" menu link. */

/* Prevent Webkit and Windows Mobile platforms from changing default font sizes.*/

body{-webkit-text-size-adjust:100%; -ms-text-size-adjust:100%;}

.ExternalClass {width:100%;} /* Force Hotmail to display emails at full width */

#background-table {margin:0; padding:0; width:100% !important; }

/* Needed to override highlighting on date and time links in iOS */

.grey a {color: #707070; text-decoration: none; }/* These styles are appended to the head element of a notification in order to prevent Apple Mail and similar

   clients from underlining the due dates with a blue hyperlink */

/* a lozenge outside an inline task should always be #333, lozenges inside an inline task should be

   colored according to their upcoming due dates, a completed task date lozenge or deleted task date

   lozenge should always be #707070 */

.date-time-lozenge a {color: #333333; text-decoration: none; }

.inline-task-text-container .date-time-lozenge.date-upcoming a {color: #DF6F00; text-decoration: none; }

.inline-task-text-container .date-time-lozenge.date-past a {color: #D04437; text-decoration: none; }

.inline-task-text-container.content-deleted-color .date-time-lozenge a,

.inline-task-text-container.checked .date-time-lozenge a {

    color: #707070; text-decoration: none;

}}

</style> 

</head>

<body>

<table id="background-table" cellpadding="0" cellspacing="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; background-color: #f5f5f5"> 

<tbody> 

<tr> 

<td id="header-pattern-container" style="padding: 0px; border-collapse: collapse; padding: 10px 20px"> 

<table id="header-pattern" cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="header-avatar-image-container" valign="top" style="padding: 0px; border-collapse: collapse; vertical-align: top; width: 32px; padding-right: 9px"><a href="https://wiki.asterisk.org/wiki/display/~gjoseph?src=email" style="color: #3b73af; text-decoration: none"><img id="header-avatar-image" class="image_fix" src="cid:avatar_4482ca8c6a1804a0ce7a25b1939bb31d" height="32" width="32" border="0" style="border-radius: 3px; vertical-align: top" /></a></td>

<td id="header-text-container" valign="middle" style="padding: 0px; border-collapse: collapse; vertical-align: middle; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px">George Joseph <strong>edited</strong> a page</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<!-- End Header pattern --> 

<tr> 

<td id="email-content-container" style="padding: 0px; border-collapse: collapse; padding: 0 20px"> 

<table id="email-content-table" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; border-spacing: 0; border-collapse: separate"> 

<tbody> 

<tr> 

<td class="email-content-rounded-top mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; padding: 0 15px 0 16px; height: 15px; background-color: #fff; border-left: 1px solid #ccc; border-top: 1px solid #ccc; border-right: 1px solid #ccc; border-bottom: 0; border-top-right-radius: 5px; border-top-left-radius: 5px"> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff"> 

<table id="page-title-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="page-title-pattern-icon-image-container" valign="top" style="padding: 0px; border-collapse: collapse; width: 16px; vertical-align: top"> 

<table cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="page-title-pattern-icon-image-container-cell" style="padding: 0px; border-collapse: collapse; width: 16px; padding: 9px 8px 0px 0px; mso-text-raise: 5px; mso-line-height-rule: exactly"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?src=email" title="page icon" style="vertical-align: top;; color: #3b73af; text-decoration: none"><img style="vertical-align: top; display: block;" src="cid:page-icon" alt="page icon" title="page icon" height="16" width="16" border="0" /></a></td> 

</tr> 

</tbody> 

</table> </td>

<td style="vertical-align: top;; padding: 0px; border-collapse: collapse; padding-right: 5px; font-size: 20px; line-height: 30px; mso-line-height-rule: exactly" id="page-title-pattern-header-container"><span id="page-title-pattern-header" style="font-family: Arial, sans-serif; padding: 0; font-size: 20px; line-height: 30px; mso-text-raise: 2px; mso-line-height-rule: exactly; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?src=email" title="Gerrit Usage" style="color: #3b73af; text-decoration: none">Gerrit Usage</a></span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff"> 

<table class="content-excerpt-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px"> 

<tbody> 

<tr> 

<td class="content-excerpt-pattern-container mobile-resize-text " style="padding: 0px; border-collapse: collapse; padding: 0 0 0 24px"> 

<div class="contentLayout2 diff-block-target"> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout two-right-sidebar" data-layout="two-right-sidebar"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-Overview" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Overview</h1> 

<p style="margin: 10px 0 0 0">The Asterisk project uses <a href="https://gerrit.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Gerrit</a> for code reviews, continuous integration validation, and git management. When creating a patch to Asterisk or its various related projects, all patches should be pushed to Gerrit for review.</p> 

<p style="margin: 10px 0 0 0">Use of Gerrit is beyond the scope of this wiki page - for in depth information, see the <a href="https://gerrit.asterisk.org/Documentation/index.html" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Gerrit documentation</a>.</p> 

<h1 id="GerritUsage-CreatinganAccount" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Creating an Account</h1> 

<p style="margin: 10px 0 0 0">Gerrit uses <a href="https://openid.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">OpenID</a> in conjunction with the Asterisk project's Atlassian infrastructure to provide single sign-on. If you already have an account in the Asterisk project infrastructure (such as <a href="https://issues.asterisk.org/jira" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">JIRA</a>) and have signed a <a href="https://issues.asterisk.org/jira/secure/DigiumLicense.jspa" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Contributor License Agreement</a>, you should be able to sign in to Gerrit automatically.</p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Create an account at <a href="https://signup.asterisk.org/signup" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">signup.asterisk.org</a>.</p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Sign a <a href="https://issues.asterisk.org/jira/secure/DigiumLicense.jspa" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Contributor License Agreement</a>.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/warning.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Warning</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">Until your Contributor License Agreement is approved, you will not be able to sign into the project OpenID provider or Gerrit.</p> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Browse to <a href="https://gerrit.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Gerrit</a>, and click <strong>Sign In</strong>.</p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">This will redirect to <a href="https://openid.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">openid.asterisk.org</a>. Sign in with your Atlassian username/password.</p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Upon signing in successfully, you will need to authorize Gerrit to access your OpenID. When you have done so, you should be redirected back to Gerrit, and will be signed in.</p> </li> 

</ol> 

<h1 id="GerritUsage-SettingupyourGerritAccount" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Setting up your Gerrit Account</h1> 

<p style="margin: 10px 0 0 0">Upon logging in for the first time, you will need to perform the following:</p> 

<ol style="margin: 10px 0 0 0"> 

<li>Set your username for your account. This can be any username, although we highly recommend matching your Atlassian username. To set your username: 

<ol style="margin: 10px 0 0 0; margin-top: 0"> 

<li>Click on your name in the top-right corner.</li> 

<li>Click "Settings"</li> 

<li>Click "Profile" on the left side of the screen.</li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">In the top text box in the center, enter your user name, and confirm.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/warning.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Warning</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">Failure to set your username will result in clones using SSH failing, despite adding your SSH key. If you can not clone using SSH please ensure you have set your username.</p> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> </li> 

<li>Add your SSH public key.</li> 

</ol> 

</div> </td> 

<td valign="top" width="30%" class="cell aside" data-type="aside" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/panel.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Panel</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">On This Page</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0"></p> 

<table class="diff-macro bodyless" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/toc.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Table of Contents</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">maxLevel</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">2</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"></p> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0"> </p> 

<p style="margin: 10px 0 0 0"> </p> 

<p style="margin: 10px 0 0 0"> </p> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-Settingupyourenvironment" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Setting up your environment</h1> 

<h2 id="GerritUsage-CreatinganSSHAlias" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 10px">Creating an SSH Alias</h2> 

<p style="margin: 10px 0 0 0">Since access to <a href="https://gerrit.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">gerrit.asterisk.org</a> is likely to occur often if <span class="diff-html-removed" id="removed-diff-0" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">yo</span><span class="diff-html-added" id="added-diff-0" style="font-size: 100%; background-color: #ddfade;">you</span>'re submitting patches, you may want to set up an SSH alias:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ cat ~/.ssh/config

...

Host asterisk

  Hostname gerrit.asterisk.org

  Port 29418

  User {user}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">This will allow you to access the repository as shown below:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git clone asterisk:{repo}</pre> </td> 

</tr> 

</tbody> 

</table> 

<h2 id="GerritUsage-Installgit-review" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Install git-review</h2> 

<p style="margin: 10px 0 0 0">You can skip this step if you're only downloading patches for testing.</p> 

<p style="margin: 10px 0 0 0">Most Gerrit users will be submitting patches for review and will need the <code style="font-family: monospace">git review</code> command.  It's not normally installed by default when you install git so it must be installed separately.  The package is called <code style="font-family: monospace">git-review</code> and should be available via most package managers.  If not, you can install it using pip: </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Install git-review from git</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">bash</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ pip install git-review</pre> </td> 

</tr> 

</tbody> 

</table> 

<h2 id="GerritUsage-Preparegit" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span>Prepare git</span> </h2> 

<p style="margin: 10px 0 0 0">You can skip this step if you're only downloading patches for testing.</p> 

<p style="margin: 10px 0 0 0">In every repository you plan on submitting patches from, you'll need to set your email to match that expected by Gerrit.  You can set it in each repository after you've cloned it or you can set it globally.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Set per repository</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ cd <repository>

$ git config --local --add user.email <your email>

$ git config --local --add user.name <your full name></pre> </td> 

</tr> 

</tbody> 

</table> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Set globally</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git config --global --add user.email <your email>

$ git config --global --add user.name <your full name></pre> </td> 

</tr> 

</tbody> 

</table> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-CloningfromGerrit" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0"> <span>Cloning from Gerrit</span> </h1> 

<p style="margin: 10px 0 0 0">While access to the underlying git repository is open to anyone via anonymous HTTP access, this guide will assume that you want to push changes up as well. For that, Gerrit uses SSH. If you are only looking to obtain the source code for a particular repository, clone it from the <a href="https://github.com/asterisk/asterisk" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Official Asterisk GitHub Mirror</a> </p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Clone the repository:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Clone using full SSH URL</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git clone ssh://{user}@gerrit.asterisk.org:29418/{repo}</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0">or</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Clone using SSH alias</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git clone ssh://asterisk/{repo}</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0">You can also clone and check out a branch in one step</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Clone asterisk and check out branch 13</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" id="added-diff-1" style="font-size: 100%; background-color: #ddfade;">$ </span>git clone -b 13 ssh://asterisk/asterisk asterisk-13</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" id="added-diff-2" style="font-size: 100%; background-color: #ddfade;">If you're only retrieving patches and don't need to submit, you can clone from https:</span> </p> 

<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">title</span></td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Clone using Anonymouns HTTPS</span></td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">language</span></td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">text</span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">$ git clone https://gerrit.asterisk.org/asterisk</span>

</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">To push reviews to Gerrit, you'll need the commit hook that generates the Gerrit Change-Id and appends it to every commit message.  You can install the hook easily with git review.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Install the Gerrit commit hook</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git review -s</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0">It's imperative that once a Change-Id is added to a review it's not changed.  Gerrit uses it to associate multiple commits with a single review and associate cherry-picks among branches.</p> </li> 

</ol> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-GerritReviewSubmitWorkflow" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Gerrit Review Submit Workflow</h1> 

<p style="margin: 10px 0 0 0">Now that the repository is set up, it's time to do some real work!  Let's say you have a change you wish to make against the Asterisk 13 branch.</p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong>Get an Asterisk Issue ID</strong> <br />There should be an Asterisk issue open for every change you submit.  If you don't have one already, create a new issue at <a href="https://issues.asterisk.org" style="font-family: "Helvetica Neue" , Helvetica , Arial , sans-serif;font-size: 14.0px;; color: #3b73af; text-decoration: none" class="external-link" rel="nofollow">https://issues.asterisk.org</a><span style="color: rgb(51,51,51);">.  Let's say you're using ASTERISK-12345.</span> </p> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);"> <br /> </span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Create a working branch in your repository</strong> <br />You'll want to keep the local branches that track remote branches, like 13, 14 <span class="diff-html-removed" id="removed-diff-1" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">, </span><span class="diff-html-added" id="added-diff-3" style="font-size: 100%; background-color: #ddfade;">and </span>master, in a pristine condition so create a new working branch that's based on the remote branch you're making the change against.  Using the Asterisk issue id as the branch name will make things easier later on.  You should always start your change in the oldest branch to which the change will apply which is 13 in this example.<br /> </span> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git checkout 13

$ git checkout -b ASTERISK-12345</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);"> </span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Do Some Work!</strong> <br /> </span> </p> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);"><strong> <br /> </strong></span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Test Your Work!<br /> </strong>When you submit your review, it will automatically be built and the Asterisk unit tests run so to save re-work time, you should run the Asterisk unit tests against your changes before you submit.  To do so, configure asterisk with the <code style="font-family: monospace">--enable-dev-mode</code> flag and enable <code style="font-family: monospace">TEST_FRAMEWORK</code> in menuselect.  After installing Asterisk in your test environment (and you should have a test environment), you can run the tests from the Asterisk CLI with the <code style="font-family: monospace">test execute all</code> command.  </span> </p> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);">If you have the Asterisk Testsuite installed, running the test suite is also recommended since it will be run against your change before the change is merged.  See <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none">Installing the Asterisk Test Suite</a> for more information.<br /> <br /> </span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Commit</strong> <br />You have to commit before you submit and the commit message is crucial.  For more information about commit messages, see <a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none">Commit Messages</a>.  You'll notice that when you edit the commit message, you'll see that the Gerrit Change-Id was automatically added to the end.  DON'T ALTER OR REMOVE IT!!  You'll see why this is important later.</span> </p> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);">Here's a quick sample commit message:<br /> </span> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">res_pjsip:  Change something in res_pjsip

This is where you should describe the change and any background information

that will help a reviewer or future developer understand the purpose of

the change.

ASTERISK-12345 #close

Reported-by: Someone other than you

Change-Id: I6dca12979f482ffb0450aaf58db0fe0f6d2e389

 </pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Submit<br /> </strong>Submitting is easy:<br /> </span> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Submit a patch for review</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">text</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git review 13 </pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);"> <code style="font-family: monospace">13</code> represents the branch you're submitting this patch against.  The default is <code style="font-family: monospace">master</code> so don't forget to specify it.  </span> </p> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);">If the submit is successful, you'll see a confirmation that looks like so:</span> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">remote: Processing changes: new: 1, refs: 1, done            

remote: 

remote: New Changes:        

remote:   http://gerrit.asterisk.org/r/9999 new review        

remote: 

To ssh://gerrit.asterisk.org:29418/asterisk

 * [new branch]      HEAD -> refs/publish/13/9999

</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span style="color: rgb(51,51,51);"><code style="font-family: monospace">9999</code> is the review number.<br /> <br /> </span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);"><strong>Cherry Pick<br /> </strong>If you're making your change to the Asterisk 13 or 14 branches, you'll probably need to cherry-pick your change to other branches.  For changes to 13, cherry-pick to 14 and master.  For changes to 14, cherry-pick to master.  The easiest way to do this is via the Gerrit web user interface.</span> </p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span style="color: rgb(51,51,51);">Log into Gerrit at <a href="http://https//gerrit.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">http://https://gerrit.asterisk.org</a> and open your change.  </span>Notice that the change topic is set to ASTERISK-12345.  This was automatically set because the name of the working branch you submitted from was ASTERISK-12345.   If it's not set correctly to the Asterisk issue id, set it now.   If you don't use the Asterisk issue id as the working branch name, you can set the topic when you submit using the <code style="font-family: monospace">-t</code> option to <code style="font-family: monospace">git review</code> as follows: <code style="font-family: monospace">git review -t ASTERISK-12345</code> 13</p> </li> 

<li>Whenever possible, you should cherry pick from the oldest branch to the newest in order.  Click the Cherry Pick button and choose the destination branch.  Assuming the change was originally submitted against 13, choose 14 and click the Cherry Pick Change button.  Gerrit will create a new review for you against the destination branch.  Notice though that Gerrit altered the Topic by appending the destination branch.  You'll need to reset it to just the Asterisk issue id.  Once that's done, click Cherry Pick again and repeat the process for the master branch. <br /> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span><span class="diff-html-added" id="added-diff-4" style="font-size: 100%; background-color: #ddfade;"> You'll get new review numbers for each cherry-pick of course.</span> </li> 

</ol> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">You can cherry-pick a review from the command line if you so wish:</span> </p> 

<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">title</span></td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Cherry pick a review from the command line</span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">$ git review --cherrypick 9999 14 </span>

</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">This will cherry pick review 9999 to the 14 branch.</span> </p> </li> 

</ol> 

<ol style="margin: 10px 0 0 0"> 

<li> <strong>Watch for verification<br /> </strong>As each review is created, Gerrit will automatically schedule a verification step with Jenkins (our continuous integration platform).  To pass the verification, Asterisk has to build successfully with your change and all unit tests must pass.  Passing is usually the signal to reviewers that it's a valid patch and they can spend time reviewing it.  If it fails, it's up to you to examine the results by following the links that Jenkins added to the comments and taking appropriate action.<br /> <br /> </li> 

<li> <strong>Respond to comments<br />The worst thing you can do is push a review then not respond to comments!.  </strong>This tells reviewers that the review isn't important to you and the review will probably keep falling further back in the queue.<span class="diff-html-removed" id="removed-diff-3" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> </li> 

<li> <strong>Next Steps<br /> </strong>If your review is accepted without the need for re-work, you need to nothing further.  Otherwise, read on.<br /> <strong> <br /> <br /> </strong> </li> 

</ol> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-UpdatingaReview" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0"> <span class="diff-html-changed" id="changed-diff-1" style="background-color: #d6f0ff;">Updating a Review</span> </h1> 

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span> 

<span class="diff-html-removed" id="removed-diff-4" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">(documentation update in progress)</span> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Reviews are automatically updated so long as commits contain the same Change ID. If your review has any findings, rebase the commits as appropriate, making sure the Change ID is preserved:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">$ git rebase -i</span>

</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Re-push the changes:</span> 

<h1 id="GerritUsage-UpdatingaReview" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"></h1> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Making updates to a review is a bit tricky because you don't want to create new commits or new reviews with each update.  Here are the steps:</span> </p> 

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">As an example, if we previously posted for review a code change for Asterisk 11, and the Gerrit Review ID is 30, we might use the following for Asterisk 13</span> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Pull down the current review: </span></strong> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git review <span class="diff-html-removed" id="removed-diff-5" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">{branchname}</span>

</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">or:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">$ git push asterisk:{repo} HEAD:refs/for/master</span>

</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> 

<h1 id="GerritUsage-BranchCherry-Picking" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Branch Cherry-Picking</span> </h1> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Patches being submitted to the project must be cherry-picked to other branches when either:</span> </p> 

<ul style="margin: 10px 0 0 0"> 

<li> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The patch is a bug fix. In this case, the patch should be cherry-picked to all supported branches that have the bug.</span> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The patch is a new feature or improvement, and tests have been written to cover the new feature or improvement. In that case, the patch may be submitted to other supported branches.</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/note.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Note</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Not all changes are appropriate for all branches. See </span><a class="confluence-link unresolved" href="#" style="color: #3b73af; text-decoration: none"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Software Configuration Management Policies</span></a><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> for more information. If you have questions about whether or not a change is appropriate for a particular branch, feel free to ask on the asterisk-dev mailing list or in #asterisk-dev.</span> </p> </td> 

</tr> 

</tbody> 

</table> </li> 

</ul> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry-picking can be done either when a patch is first proposed, or it may be done when the patch has been reviewed but prior to it being submitted. If you plan on cherry-picking after an initial review, please indicate so in a comment on the review.</span> </p> 

<h2 id="GerritUsage-Cherry-PickinginGerrit" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry-Picking in Gerrit</span> </h2> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If your patch applies cleanly to a branch, you can cherry-pick directly in Gerrit. On your review, select the </span><strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry-Pick</span></strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> button:</span> </p> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed diff-html-image-container" style="background-color: #ffe7e7;display: inline-block;position: relative;text-align: center;"><img class="confluence-embedded-image" src="/wiki/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2" title="gerrit-cherry-pick.png" /><span class="diff-image-overlay diff-removed-image" style="color: #535353;display: block;padding: 4px 4px 8px 4px;text-decoration: none;">Image Removed</span></span> </p> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">In the resulting dialog, enter the branch you want to cherry-pick to, then select </span><strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry Pick Change</span></strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">.</span> </p> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed diff-html-image-container" style="background-color: #ffe7e7;display: inline-block;position: relative;text-align: center;"><img class="confluence-embedded-image" src="/wiki/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2" title="cherry-pick-dialog.png" /><span class="diff-image-overlay diff-removed-image" style="color: #535353;display: block;padding: 4px 4px 8px 4px;text-decoration: none;">Image Removed</span></span> </p> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If the change merges cleanly, a new review will be opened with your cherry-picked change. If the change could not be merged, and error will appear and you will need to use one of the manual methods listed below.</span> </p> 

<h2 id="GerritUsage-Cherry-Pickingusinggitreview" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry-Picking using </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">git review</span></code> </h2> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">If you have already submitted a patch for review, you may cherry pick to a new branch using </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">git review</span></code><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">$ git review --cherrypick {review id} {origin branch}</span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<ol style="margin: 10px 0 0 0"> 

<li> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" id="added-diff-6" style="font-size: 100%; background-color: #ddfade;">-d 9999</span>

</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">This will create (or reuse) a branch named "review/<your_name>/<topic>" and switch you to it.  In this example and assuming your name is "Joe Developer", the branch would be "review/joe_developer/ASTERISK-12345".</span> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Make and test your changes</span></strong> <br /> <br /> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong><strong><span style="color: rgb(255,0,0);"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Amend</span></span><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> the original commit:</span> <br /> </strong></strong> </p> 

<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">title</span></td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Amend a commit</span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> $ git commit -a --amend</span>

</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">It is </span><strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">CRITICAL</span></strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> that you amend your original commit and not create a new commit.  Failing to amend will generate a new Change-Id and will cause Gerrit to create a NEW review instead of creating a new patchset on the existing review.</span> <br /> <br /> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Re-submit</span><span class="diff-html-changed" id="changed-diff-2" style="background-color: #d6f0ff;">:</span></strong> </p> 

<table class="diff-macro diff-html-changed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-changed" style="background-color: #d6f0ff;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-changed" style="background-color: #d6f0ff;">$ git review </span>

</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> 

<span class="diff-html-removed" id="removed-diff-6" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">--cherrypick 30 </span> 

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span> 

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">$ git review -t ASTERISK-12345 11</span> 

<ol style="margin: 10px 0 0 0"> 

<li> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-changed" id="changed-diff-4" style="background-color: #d6f0ff;">13</span>

</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> 

<h2 id="GerritUsage-Cherry-Pickingusinggitcherry-pick" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0"> <span class="diff-html-removed" id="removed-diff-7" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Cherry-Picking using </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">git cherry-pick</span></code> </h2> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">You may cherry pick using </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">git cherry-pick</span></code><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> as well. When performing the cherry-pick using git, make sure that the </span><code style="font-family: monospace"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Change-Id</span></code><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> header is the same between all branches.</span> </p> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">As an example, if we committed the following to Asterisk 13:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">commit dc8f87145c352c1bcf1a3361802aac26da5f50e2

Refs: review/asteriskteam/file-version-13, file-version-13

Author:     Asterisk Development Team <asteriskteam@digium.com>

AuthorDate: Sun Apr 12 12:59:22 2015 -0500

Commit:     Asterisk Development Team <asteriskteam@digium.com>

CommitDate: Sun Apr 12 20:20:19 2015 -0500

    git migration: Remove support for file versions

    Git does not support the ability to replace a token with a version

    string during check-in. While it does have support for replacing a

    token on clone, this is somewhat sub-optimal: the token is replaced

    with the object hash, which is not particularly easy for human

    consumption. What's more, in practice, the source file version was often

    not terribly useful. Generally, when triaging bugs, the overall version

    of Asterisk is far more useful than an individual SVN version of a file.

    As a result, this patch removes Asterisk's support for showing source file

    versions.

        ASTERISK-12345

    Change-Id: Ia932d3c64cd18a14a3c894109baa657ec0a85d28</span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">We could then cherry pick this back to Asterisk 11 using the following:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">$ git cherry-pick dc8f87145c352c1bcf1a3361802aac26da5f50e2</span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">The resulting commit </span><strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">must</span></strong><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> have the same Change-Id as the Asterisk 13 commit for Gerrit to recognize that this is a cherry-picked commit:</span> </p> 

<table class="diff-macro diff-html-removed" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ffe7e7;border-color: #df9898;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">    Change-Id: Ia932d3c64cd18a14a3c894109baa657ec0a85d28</span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-removed" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">When posting it for review to Gerrit, you should also use the same topic as the original patch. Generally, this is the ASTERISK issue.</span> </p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <span class="diff-html-added" id="added-diff-7" style="font-size: 100%; background-color: #ddfade;">Don't forget the base branch.</span> <br /> <br /> </p> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0"> <strong><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Cherry Pick:</span></strong> <br /> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">As with the initial submit, cherry-pick to the other applicable branches. </span> </p> </li> 

</ol> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">If you have to make multiple changes over the lifetime of the review, you should always download the same review, 9999 in this case.  This is because the branch name that gets generated for the review doesn't include the base branch.  In our example, let's say you got review 10000 when you cherry-picked 9999 to the 14 branch.  If you do </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">git review -d 9999</span></code><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> then later do </span><code style="font-family: monospace"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">git review -d 10000</span></code><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">, you'll get a warning from git that the base branches aren't the same.  If this happens, check out another branch temporarily, delete the review branch, then download the review again.</span> </p> 

<table class="diff-macro diff-html-added" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;background-color: #ddfade;border-color: #93c49f;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</span></th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">

<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">$ git checkout 13

$ git branch -D reviews/joe_developer/ASTERISK-12345

$ git review -d 10000</span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-AdvancedTopics" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Advanced Topics</span> </h1> 

<p style="margin: 10px 0 0 0"> <span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">What do do when a cherry-pick fails, etc.  Coming Soon!</span> </p> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-TeamBranches" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Team Branches</h1> 

<p style="margin: 10px 0 0 0">The repositories on <a href="https://gerrit.asterisk.org" class="external-link" rel="nofollow" style="color: #3b73af; text-decoration: none">Gerrit</a> typically require all changes in all of the mainline branches to be reviewed prior to merging. While this is appropriate for the mainline branches, sometimes, it is useful to have a branch on the central server that multiple developers can use for collaboration. These branches exist within a special branch namespace, <code style="font-family: monospace">team</code>. Registered Gerrit users have the ability to manipulate branches within that namespace directly, bypassing the usual Gerrit code review process.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/note.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Note</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Posting For Peer Review</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">When a code change in a team branch is ready for peer review, using the <code style="font-family: monospace">git review</code> tool or pushing the change to Gerrit's <code style="font-family: monospace">refs/for/[branch]</code> will still automatically post it for review on Gerrit. The instructions on this page assume that developers wanting to use team branches want to perform some development collaboratively without posting the change for review.</p> <p style="margin: 10px 0 0 0">For instruction on posting a change for review, see <a href="#GerritUsage-git-review" style="color: #3b73af; text-decoration: none"><span class="diff-html-changed" id="changed-diff-6" style="background-color: #d6f0ff;">Pushing to Gerrit for Code Review</span></a>.</p> </td> 

</tr> 

</tbody> 

</table> 

<h2 id="GerritUsage-TeamBranchManipulationinGerrit" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Team Branch Manipulation in Gerrit</h2> 

<h3 id="GerritUsage-CreatinganewTeamBranch" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0; margin-top: 10px">Creating a new Team Branch</h3> 

<p style="margin: 10px 0 0 0">Creating a new team branch can be done at any time from a local branch. For example, to create a new team branch from local <code style="font-family: monospace">master</code>:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git push origin master:refs/heads/team/mjordan/awesome-feature</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="GerritUsage-CheckoutaTeamBranch" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0"> Check out a Team Branch</h3> 

<p style="margin: 10px 0 0 0">Checking out a team branch is done in the same way as a mainline branch:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git checkout -b awesome-feature -t origin/team/mjordan/awesome-feature</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="GerritUsage-PushingtoaTeamBranch" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">Pushing to a Team Branch</h3> 

<p style="margin: 10px 0 0 0">Pushing to a team branch can be done directly. This bypasses Gerrit's peer review. Note that team branches can be peer reviewed if desired, using the same mechanism as a 'normal' Gerrit peer review.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git push origin HEAD:refs/heads/team/mjordan/awesome-feature</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="GerritUsage-DeleteaTeamBranch" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">Delete a Team Branch</h3> 

<p style="margin: 10px 0 0 0">Deleting a team branch is done by pushing an empty local branch (nothing) to the team branch. Note that you have to use <code style="font-family: monospace">git push --force</code>.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git push --force origin :refs/heads/team/mjordan/awesome-feature</pre> </td> 

</tr> 

</tbody> 

</table> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/warning.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Warning</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">It should go without saying, but be careful when deleting a team branch. All registered users have access rights to the <code style="font-family: monospace">team</code> area - as such, anyone can affect someone else's team branch.</p> </td> 

</tr> 

</tbody> 

</table> 

<h2 id="GerritUsage-RecoveringaSubversionTeamBranch" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Recovering a Subversion Team Branch</h2> 

<p style="margin: 10px 0 0 0">While the Subversion Team branches were moved over to Git with their entire history, much of that history typically consists of Automerge commits. These commits are not well understood by Git; from Git's perspective, they are completely independent from the mainline commits they merged over. This can cause a "standard" rebase to fail miserably: the rebase will not realize that the Automerge commits are identical to those on the branch being rebased to. As a result, you'll often have a lot of merge conflicts if you attempt to rebase directly.</p> 

<p style="margin: 10px 0 0 0">While working through the merge conflicts in a rebase is an option, an easier approach may be to simply re-build the branch on the current state of the mainline branch it wants to track. This example walks through that process, performing a rebase of branch <code style="font-family: monospace">team/mjordan/trunk-http-stuff-and-things</code> on top of <code style="font-family: monospace">master</code>.</p> 

<ol style="margin: 10px 0 0 0"> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Checkout the subversion team history branch into a temporary local branch:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git checkout -b http-caching-temp -t origin/team/mjordan/trunk-http-stuff-and-things</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<li>Determine the useful commits to pull over. In this case, we're going to skip: 

<ol style="margin: 10px 0 0 0; margin-top: 0"> 

<li>All commits from <code style="font-family: monospace">Automerge script.</code> </li> 

<li>All commits that modify Subversion properties or create Subversion branches.<br /> <img class="confluence-embedded-image" width="500" src="/wiki/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2" title="team-branch-1.png" /><br />In the above screenshot, we want the three commits from <code style="font-family: monospace">Matthew Jordan</code> between the <code style="font-family: monospace">Automerge: script</code> <code style="font-family: monospace">automerge cancel</code> and the <code style="font-family: monospace">Matthew Jordan: Re-enable automerge</code>.</li> 

<li>Record the hashes of the commits you want to carry-over.</li> 

</ol> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Checkout a new branch for your work, tracking whatever canonical mainstream branch is appropriate:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git checkout -b http-caching -t origin/master</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Cherry-pick each commit over, solving merge conflicts as necessary:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git cherry-pick 5037821233a366f4afae83c732eb318e64bdb6f5

$ git cherry-pick 9905eaad7a8c8a13363ae4129d7d483c8559cb7a

$ git cherry-pick 32fe36b0e14f8c072c2bfea9443a946cfe3628d6

$ git cherry-pick a5eb0d4b178eee070047549d635ada8d562c3d73</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">If desired, fix up any history:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git rebase -i</pre> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Remove the temporary branch:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git branch -d </pre> </td> 

</tr> 

</tbody> 

</table> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/tip.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Tip</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">You may get the following warning:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">warning: deleting branch 'http-caching-temp' that has been merged to

         'refs/remotes/origin/team/mjordan/trunk-http-stuff-and-things', but not yet merged to HEAD.

Deleted branch http-caching-temp (was 9c6910d).</pre> </td> 

</tr> 

</tbody> 

</table> <p style="margin: 10px 0 0 0">That's okay. You don't want to merge the whole thing to <code style="font-family: monospace">HEAD</code>, as the <code style="font-family: monospace">Automerge</code> script commits are duplicates of commits already in <code style="font-family: monospace">HEAD</code>.</p> </td> 

</tr> 

</tbody> 

</table> </li> 

<li> <p style="margin: 10px 0 0 0; margin-top: 0">Push the branch up to your team branch location:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git push origin HEAD:refs/heads/team/mjordan/http-caching</pre> </td> 

</tr> 

</tbody> 

</table> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/tip.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Tip</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">In this example, a new team branch is being made - <code style="font-family: monospace">team/mjordan/http-caching</code>. This way, if something is missed in the cherry-picks, I haven't blown away my Subversion branch.</p> </td> 

</tr> 

</tbody> 

</table> </li> 

</ol> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="GerritUsage-Troubleshooting" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Troubleshooting</h1> 

<h2 id="GerritUsage-git-review" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 10px">git-review</h2> 

<h3 id="GerritUsage-Problem:attemptingtorungitreviewresultsinsomethinglikethefollowing:" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0; margin-top: 10px">Problem: attempting to run <code style="font-family: monospace">git review</code> results in something like the following:</h3> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/noformat.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>No Format</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">Traceback (most recent call last):

  File "/usr/local/bin/git-review", line 11, in <module>

    sys.exit(main())

  File "/usr/local/lib/python2.6/dist-packages/git_review/cmd.py", line 1132, in main

    (os.path.split(sys.argv[0])[-1], get_version()))

  File "/usr/local/lib/python2.6/dist-packages/git_review/cmd.py", line 180, in get_version

    provider = pkg_resources.get_provider(requirement)

  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 176, in get_provider

    return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]

  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 648, in require

    needed = self.resolve(parse_requirements(requirements))

  File "/usr/lib/python2.6/dist-packages/pkg_resources.py", line 546, in resolve

    raise DistributionNotFound(req)

pkg_resources.DistributionNotFound: git-review</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">Solution: Run</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/noformat.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>No Format</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ sudo pip install --upgrade setuptools</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">on your command line</p> 

<h3 id="GerritUsage-Problem:attemptingtorungitreviewresultsin"unpackfailed:errorMissingtree":" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">Problem: attempting to run <code style="font-family: monospace">git review</code> results in <span>"unpack failed: error Missing tree":</span> </h3> 

<p style="margin: 10px 0 0 0"> <span>Description:  There is an incompatibility between certain version of git and gerrit that causes this error when the commit to be pushed was amended and only the commit message changed.<br />Solution:  Run git push manually with the --no-thin option:<br /> </span> </p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5639/a252d7f5e75d7a8bf7047b4b2c92f71a56a8f048.48/_/images/icons/macrobrowser/dropdown/noformat.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>No Format</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">$ git push --no-thin asterisk:{repo} HEAD:refs/for/master</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="GerritUsage-Problem:Unabletologintogerrit.asterisk.org" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0"> <span>Problem:  Unable to login to gerrit.asterisk.org</span> </h3> 

<p style="margin: 10px 0 0 0"> <span>Solution: Until your Contributor License Agreement is approved, you will not be able to sign into the project OpenID provider or Gerrit. See the "Creating an Account" section for instructions on how to resolve this.</span> </p> 

<h3 id="GerritUsage-Problem:UnabletounsubscribefromGerritnotifications" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0"> <span>Problem:  Unable to unsubscribe from Gerrit notifications</span> </h3> 

<p style="margin: 10px 0 0 0"> <span>Solution: You may have mistaken the Gerrit notifications on a mailing list for notifications associated with your account. Of course if the notifications are being received via a mailing list then you would need to unsubscribe from the entire mailing list to stop receiving related mailings.</span> </p> 

<p style="margin: 10px 0 0 0"> <span>Other possibilities are that you have multiple accounts or are receiving notifications via forwarding from another E-mail address.<br /> </span> </p> 

</div> </td> 

</tr> 

</tbody>

</table> 

</div> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand action-padding last-row-padding" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff; padding-bottom: 10px; padding-bottom: 10px"> 

<table id="actions-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px"> 

<tbody> 

<tr> 

<td id="actions-pattern-container" valign="middle" style="padding: 0px; border-collapse: collapse; padding: 15px 0 0 24px; vertical-align: middle"> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?src=email" title="View page Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="View page Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aview-page-email-adg-footer-item%3Aicon" alt="View page Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?src=email" title="View page" style="color: #3b73af; text-decoration: none">View page</a></td>

<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td> 

</tr> 

</tbody> 

</table> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Add comment Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aadd-comment-to-content-email-adg-footer-item%3Aicon" alt="Add comment Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/Gerrit+Usage?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment" style="color: #3b73af; text-decoration: none">Add comment</a></td>

<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td> 

</tr> 

</tbody> 

</table> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=32375063&src=email" title="Like Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Like Icon" src="cid:com.atlassian.confluence.plugins.confluence-like%3Aview-email-adg-content-item%3Aicon" alt="Like Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=32375063&src=email" title="Like" style="color: #3b73af; text-decoration: none">Like</a></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-rounded-bottom mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; height: 5px; line-height: 5px; padding: 0 15px 0 16px; background-color: #fff; border-bottom-right-radius: 5px; border-bottom-left-radius: 5px; border-top: 0; border-left: 1px solid #ccc; border-bottom: 1px solid #ccc; border-right: 1px solid #ccc; mso-line-height-rule: exactly"> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td id="footer-pattern" style="padding: 0px; border-collapse: collapse; padding: 12px 20px"> 

<table id="footer-pattern-container" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="footer-pattern-links-container" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<tbody> 

<tr> 

<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST&src=email" title="" style="color: #3b73af; text-decoration: none">Stop watching space</a></td>

<td class="footer-pattern-links-bull" style="padding: 0px; border-collapse: collapse; padding: 0 5px; color: #999">•</td> 

</tr> 

</tbody> 

</table> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<tbody> 

<tr> 

<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action?src=email" title="" style="color: #3b73af; text-decoration: none">Manage notifications</a></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td id="footer-pattern-text" class="mobile-resize-text" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px; display: none">This message was sent by Atlassian Confluence 5.6.6</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

</table> 

<table id="sealed-section" border="0" cellpadding="0" cellspacing="0" width="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; display: none"> 

<tbody> 

<tr> 

<td style="padding: 0px; border-collapse: collapse; border: 0; font-size: 0px; line-height: 0; mso-line-height-rule: exactly"></td> 

</tr> 

</tbody> 

</table>

</body>

</html>