github.com/echohead/hub@v2.2.1+incompatible/man/hub.1.html (about) 1 <!DOCTYPE html> 2 <html> 3 <head> 4 <meta http-equiv='content-type' value='text/html;charset=utf8'> 5 <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'> 6 <title>hub(1) - git + hub = github</title> 7 <style type='text/css' media='all'> 8 /* style: man */ 9 body#manpage {margin:0} 10 .mp {max-width:100ex;padding:0 9ex 1ex 4ex} 11 .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0} 12 .mp h2 {margin:10px 0 0 0} 13 .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex} 14 .mp h3 {margin:0 0 0 4ex} 15 .mp dt {margin:0;clear:left} 16 .mp dt.flush {float:left;width:8ex} 17 .mp dd {margin:0 0 0 9ex} 18 .mp h1,.mp h2,.mp h3,.mp h4 {clear:left} 19 .mp pre {margin-bottom:20px} 20 .mp pre+h2,.mp pre+h3 {margin-top:22px} 21 .mp h2+pre,.mp h3+pre {margin-top:5px} 22 .mp img {display:block;margin:auto} 23 .mp h1.man-title {display:none} 24 .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143} 25 .mp h2 {font-size:16px;line-height:1.25} 26 .mp h1 {font-size:20px;line-height:2} 27 .mp {text-align:justify;background:#fff} 28 .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211} 29 .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201} 30 .mp u {text-decoration:underline} 31 .mp code,.mp strong,.mp b {font-weight:bold;color:#131211} 32 .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none} 33 .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff} 34 .mp b.man-ref {font-weight:normal;color:#434241} 35 .mp pre {padding:0 4ex} 36 .mp pre code {font-weight:normal;color:#434241} 37 .mp h2+pre,h3+pre {padding-left:0} 38 ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px} 39 ol.man-decor {width:100%} 40 ol.man-decor li.tl {text-align:left} 41 ol.man-decor li.tc {text-align:center;letter-spacing:4px} 42 ol.man-decor li.tr {text-align:right;float:right} 43 </style> 44 </head> 45 <!-- 46 The following styles are deprecated and will be removed at some point: 47 div#man, div#man ol.man, div#man ol.head, div#man ol.man. 48 49 The .man-page, .man-decor, .man-head, .man-foot, .man-title, and 50 .man-navigation should be used instead. 51 --> 52 <body id='manpage'> 53 <div class='mp' id='man'> 54 55 <div class='man-navigation' style='display:none'> 56 <a href="#NAME">NAME</a> 57 <a href="#SYNOPSIS">SYNOPSIS</a> 58 <a href="#DESCRIPTION">DESCRIPTION</a> 59 <a href="#CONFIGURATION">CONFIGURATION</a> 60 <a href="#EXAMPLES">EXAMPLES</a> 61 <a href="#BUGS">BUGS</a> 62 <a href="#AUTHORS">AUTHORS</a> 63 <a href="#SEE-ALSO">SEE ALSO</a> 64 </div> 65 66 <ol class='man-decor man-head man head'> 67 <li class='tl'>hub(1)</li> 68 <li class='tc'>Hub Manual</li> 69 <li class='tr'>hub(1)</li> 70 </ol> 71 72 <h2 id="NAME">NAME</h2> 73 <p class="man-name"> 74 <code>hub</code> - <span class="man-whatis">git + hub = github</span> 75 </p> 76 77 <h2 id="SYNOPSIS">SYNOPSIS</h2> 78 79 <p><code>hub</code> [<code>--noop</code>] <var>COMMAND</var> <var>OPTIONS</var><br /> 80 <code>hub alias</code> [<code>-s</code>] [<var>SHELL</var>]</p> 81 82 <h3 id="Expanded-git-commands-">Expanded git commands:</h3> 83 84 <p><code>git init -g</code> <var>OPTIONS</var><br /> 85 <code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var><br /> 86 <code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[/<var>REPOSITORY</var>]<br /> 87 <code>git remote set-url</code> [<code>-p</code>] <var>OPTIONS</var> <var>REMOTE-NAME</var> <var>USER</var>[/<var>REPOSITORY</var>]<br /> 88 <code>git fetch</code> <var>USER-1</var>,[<var>USER-2</var>,...]<br /> 89 <code>git checkout</code> <var>PULLREQ-URL</var> [<var>BRANCH</var>]<br /> 90 <code>git merge</code> <var>PULLREQ-URL</var><br /> 91 <code>git cherry-pick</code> <var>GITHUB-REF</var><br /> 92 <code>git am</code> <var>GITHUB-URL</var><br /> 93 <code>git apply</code> <var>GITHUB-URL</var><br /> 94 <code>git push</code> <var>REMOTE-1</var>,<var>REMOTE-2</var>,...,<var>REMOTE-N</var> [<var>REF</var>]<br /> 95 <code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var></p> 96 97 <h3 id="Custom-git-commands-">Custom git commands:</h3> 98 99 <p><code>git create</code> [<var>NAME</var>] [<code>-p</code>] [<code>-d</code> <var>DESCRIPTION</var>] [<code>-h</code> <var>HOMEPAGE</var>]<br /> 100 <code>git browse</code> [<code>-u</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>] [SUBPAGE]<br /> 101 <code>git compare</code> [<code>-u</code>] [<var>USER</var>] [[<var>START</var>...]<var>END</var>]<br /> 102 <code>git fork</code> [<code>--no-remote</code>]<br /> 103 <code>git pull-request</code> [<code>-o</code>|<code>--browse</code>] [<code>-f</code>] [<code>-m</code> <var>MESSAGE</var>|<code>-F</code> <var>FILE</var>|<code>-i</code> <var>ISSUE</var>|<var>ISSUE-URL</var>] [<code>-b</code> <var>BASE</var>] [<code>-h</code> <var>HEAD</var>]<br /> 104 <code>git ci-status</code> [<code>-v</code>] [<var>COMMIT</var>]</p> 105 106 <h2 id="DESCRIPTION">DESCRIPTION</h2> 107 108 <p>hub enhances various git commands to ease most common workflows with GitHub.</p> 109 110 <dl> 111 <dt><code>hub --noop</code> <var>COMMAND</var></dt><dd><p>Shows which command(s) would be run as a result of the current command. 112 Doesn't perform anything.</p></dd> 113 <dt><code>hub alias</code> [<code>-s</code>] [<var>SHELL</var>]</dt><dd><p>Shows shell instructions for wrapping git. If given, <var>SHELL</var> specifies the 114 type of shell; otherwise defaults to the value of SHELL environment 115 variable. With <code>-s</code>, outputs shell script suitable for <code>eval</code>.</p></dd> 116 <dt><code>git init</code> <code>-g</code> <var>OPTIONS</var></dt><dd><p>Create a git repository as with <span class="man-ref">git-init<span class="s">(1)</span></span> and add remote <code>origin</code> at 117 "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub username and 118 <var>REPOSITORY</var> is the current working directory's basename.</p></dd> 119 <dt><code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var><code>/</code>]<var>REPOSITORY</var> <var>DIRECTORY</var></dt><dd><p>Clone repository "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" into 120 <var>DIRECTORY</var> as with <span class="man-ref">git-clone<span class="s">(1)</span></span>. When <var>USER</var>/ is omitted, assumes 121 your GitHub login.</p> 122 123 <p>If the repository is private or the current user has push access to the 124 repository, hub will use the ssh protocol for cloning. Use <code>-p</code> to select 125 the ssh protocol unconditionally. HTTPS protocol can be used instead by 126 setting "hub.protocol" (see <var>CONFIGURATION</var>).</p></dd> 127 <dt><code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[<code>/</code><var>REPOSITORY</var>]</dt><dd><p>Add remote "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" as with 128 <span class="man-ref">git-remote<span class="s">(1)</span></span>. When /<var>REPOSITORY</var> is omitted, the basename of the 129 current working directory is used. With <code>-p</code>, use private remote 130 "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git". If <var>USER</var> is "origin" 131 then uses your GitHub login.</p></dd> 132 <dt><code>git remote set-url</code> [<code>-p</code>] <var>OPTIONS</var> <var>REMOTE-NAME</var> <var>USER</var>[/<var>REPOSITORY</var>]</dt><dd><p>Sets the url of remote <var>REMOTE-NAME</var> using the same rules as 133 <code>git remote add</code>.</p></dd> 134 <dt><code>git fetch</code> <var>USER-1</var>,[<var>USER-2</var>,...]</dt><dd><p>Adds missing remote(s) with <code>git remote add</code> prior to fetching. New 135 remotes are only added if they correspond to valid forks on GitHub.</p></dd> 136 <dt><code>git checkout</code> <var>PULLREQ-URL</var> [<var>BRANCH</var>]</dt><dd><p>Checks out the head of the pull request as a local branch, to allow for 137 reviewing, rebasing and otherwise cleaning up the commits in the pull 138 request before merging. The name of the local branch can explicitly be 139 set with <var>BRANCH</var>.</p></dd> 140 <dt><code>git merge</code> <var>PULLREQ-URL</var></dt><dd><p>Merge the pull request with a commit message that includes the pull request 141 ID and title, similar to the GitHub Merge Button.</p></dd> 142 <dt><code>git cherry-pick</code> <var>GITHUB-REF</var></dt><dd><p>Cherry-pick a commit from a fork using either full URL to the commit 143 or GitHub-flavored Markdown notation, which is <code>user@sha</code>. If the remote 144 doesn't yet exist, it will be added. A <code>git fetch <user></code> is issued 145 prior to the cherry-pick attempt.</p></dd> 146 <dt><code>git [am|apply]</code> <var>GITHUB-URL</var></dt><dd><p>Downloads the patch file for the pull request or commit at the URL and 147 applies that patch from disk with <code>git am</code> or <code>git apply</code>. Similar to 148 <code>cherry-pick</code>, but doesn't add new remotes. <code>git am</code> creates commits while 149 preserving authorship info while <code>apply</code> only applies the patch to the 150 working copy.</p></dd> 151 <dt><code>git push</code> <var>REMOTE-1</var>,<var>REMOTE-2</var>,...,<var>REMOTE-N</var> [<var>REF</var>]</dt><dd><p>Push <var>REF</var> to each of <var>REMOTE-1</var> through <var>REMOTE-N</var> by executing 152 multiple <code>git push</code> commands.</p></dd> 153 <dt><code>git submodule add</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var></dt><dd><p>Submodule repository "git://github.com/<var>USER</var>/<var>REPOSITORY</var>.git" into 154 <var>DIRECTORY</var> as with <span class="man-ref">git-submodule<span class="s">(1)</span></span>. When <var>USER</var>/ is omitted, assumes 155 your GitHub login. With <code>-p</code>, use private remote 156 "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git".</p></dd> 157 <dt><code>git help</code></dt><dd><p>Display enhanced <span class="man-ref">git-help<span class="s">(1)</span></span>.</p></dd> 158 </dl> 159 160 161 <p>hub also adds some custom commands that are otherwise not present in git:</p> 162 163 <dl> 164 <dt><code>git create</code> [<var>NAME</var>] [<code>-p</code>] [<code>-d</code> <var>DESCRIPTION</var>] [<code>-h</code> <var>HOMEPAGE</var>]</dt><dd><p>Create a new public GitHub repository from the current git 165 repository and add remote <code>origin</code> at 166 "git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub 167 username and <var>REPOSITORY</var> is the current working directory name. 168 To explicitly name the new repository, pass in <var>NAME</var>, optionally in 169 <var>ORGANIZATION</var>/<var>NAME</var> form to create under an organization you're a 170 member of. With <code>-p</code>, create a private repository, and with <code>-d</code> and <code>-h</code> 171 set the repository's description and homepage URL, respectively.</p></dd> 172 <dt><code>git browse</code> [<code>-u</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>] [SUBPAGE]</dt><dd><p>Open repository's GitHub page in the system's default web browser using 173 <code>open(1)</code> or the <code>BROWSER</code> env variable. If the repository isn't 174 specified, <code>browse</code> opens the page of the repository found in the current 175 directory. 176 If SUBPAGE is specified, the browser will open on the specified 177 subpage: one of "wiki", "commits", "issues" or other (the default is 178 "tree"). A specific commit in the default repository can be opened with 179 <code>git browse -- commit/<COMMIT></code>. 180 With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd> 181 <dt><code>git compare</code> [<code>-u</code>] [<var>USER</var>] [[<var>START</var>...]<var>END</var>]</dt><dd><p>Open a GitHub compare view page in the system's default web browser. 182 <var>START</var> to <var>END</var> are branch names, tag names, or commit SHA1s specifying 183 the range of history to compare. If a range with two dots (<code>a..b</code>) is given, 184 it will be transformed into one with three dots. If <var>START</var> is omitted, 185 GitHub will compare against the base branch (the default is "master"). 186 If <var>END</var> is omitted, GitHub compare view is opened for the current branch. 187 With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd> 188 <dt><code>git fork</code> [<code>--no-remote</code>]</dt><dd><p>Forks the original project (referenced by "origin" remote) on GitHub and 189 adds a new remote for it under your username.</p></dd> 190 <dt><code>git pull-request</code> [<code>-o</code>|<code>--browse</code>] [<code>-f</code>] [<code>-m</code> <var>MESSAGE</var>|<code>-F</code> <var>FILE</var>|<code>-i</code> <var>ISSUE</var>|<var>ISSUE-URL</var>] [<code>-b</code> <var>BASE</var>] [<code>-h</code> <var>HEAD</var>]</dt><dd><p>Opens a pull request on GitHub for the project that the "origin" remote 191 points to. The default head of the pull request is the current branch. 192 Both base and head of the pull request can be explicitly given in one of 193 the following formats: "branch", "owner:branch", "owner/repo:branch". 194 This command will abort operation if it detects that the current topic 195 branch has local commits that are not yet pushed to its upstream branch 196 on the remote. To skip this check, use <code>-f</code>.</p> 197 198 <p>Without <var>MESSAGE</var> or <var>FILE</var>, a text editor will open in which title and body 199 of the pull request can be entered in the same manner as git commit message. 200 Pull request message can also be passed via stdin with <code>-F -</code>.</p> 201 202 <p>With <code>-o</code> or <code>--browse</code>, the new pull request will open in the web browser.</p> 203 204 <p>Issue to pull request conversion via <code>-i <ISSUE></code> or <var>ISSUE-URL</var> 205 arguments is deprecated and will likely be removed from the future versions 206 of both hub and GitHub API.</p></dd> 207 <dt><code>git ci-status</code> [<code>-v</code>] [<var>COMMIT</var>]</dt><dd><p>Looks up the SHA for <var>COMMIT</var> in GitHub Status API and displays the latest 208 status. Exits with one of:<br /> 209 success (0), error (1), failure (1), pending (2), no status (3)</p> 210 211 <p>If <code>-v</code> is given, additionally print the URL to CI build results.</p></dd> 212 </dl> 213 214 215 <h2 id="CONFIGURATION">CONFIGURATION</h2> 216 217 <h3 id="GitHub-OAuth-authentication">GitHub OAuth authentication</h3> 218 219 <p>Hub will prompt for GitHub username & password the first time it needs to access 220 the API and exchange it for an OAuth token, which it saves in "~/.config/hub".</p> 221 222 <p>To avoid being prompted, use <var>GITHUB_USER</var> and <var>GITHUB_PASSWORD</var> environment 223 variables.</p> 224 225 <h3 id="HTTPS-instead-of-git-protocol">HTTPS instead of git protocol</h3> 226 227 <p>If you prefer the HTTPS protocol for GitHub repositories, you can set 228 "hub.protocol" to "https". This will affect <code>clone</code>, <code>fork</code>, <code>remote add</code> 229 and other operations that expand references to GitHub repositories as full 230 URLs that otherwise use git and ssh protocols.</p> 231 232 <p>"hub.protocol" only applies when the "OWNER/REPO" shorthand is used instead of 233 a full git URL.</p> 234 235 <pre><code># default behavior 236 $ git clone defunkt/repl 237 < git clone > 238 239 # opt into HTTPS: 240 $ git config --global hub.protocol https 241 $ git clone defunkt/repl 242 < https clone > 243 </code></pre> 244 245 <h3 id="GitHub-Enterprise">GitHub Enterprise</h3> 246 247 <p>By default, hub will only work with repositories that have remotes which 248 point to github.com. GitHub Enterprise hosts need to be whitelisted to 249 configure hub to treat such remotes same as github.com:</p> 250 251 <pre><code>$ git config --global --add hub.host my.git.org 252 </code></pre> 253 254 <p>The default host for commands like <code>init</code> and <code>clone</code> is still 255 github.com, but this can be affected with the <code>GITHUB_HOST</code> environment 256 variable:</p> 257 258 <pre><code>$ GITHUB_HOST=my.git.org git clone myproject 259 </code></pre> 260 261 <h2 id="EXAMPLES">EXAMPLES</h2> 262 263 <h3 id="git-clone">git clone</h3> 264 265 <pre><code>$ git clone schacon/ticgit 266 > git clone git://github.com/schacon/ticgit.git 267 268 $ git clone -p schacon/ticgit 269 > git clone git@github.com:schacon/ticgit.git 270 271 $ git clone resque 272 > git clone git@github.com/YOUR_USER/resque.git 273 </code></pre> 274 275 <h3 id="git-remote-add">git remote add</h3> 276 277 <pre><code>$ git remote add rtomayko 278 > git remote add rtomayko git://github.com/rtomayko/CURRENT_REPO.git 279 280 $ git remote add -p rtomayko 281 > git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git 282 283 $ git remote add origin 284 > git remote add origin git://github.com/YOUR_USER/CURRENT_REPO.git 285 </code></pre> 286 287 <h3 id="git-fetch">git fetch</h3> 288 289 <pre><code>$ git fetch mislav 290 > git remote add mislav git://github.com/mislav/REPO.git 291 > git fetch mislav 292 293 $ git fetch mislav,xoebus 294 > git remote add mislav ... 295 > git remote add xoebus ... 296 > git fetch --multiple mislav xoebus 297 </code></pre> 298 299 <h3 id="git-cherry-pick">git cherry-pick</h3> 300 301 <pre><code>$ git cherry-pick http://github.com/mislav/REPO/commit/SHA 302 > git remote add -f mislav git://github.com/mislav/REPO.git 303 > git cherry-pick SHA 304 305 $ git cherry-pick mislav@SHA 306 > git remote add -f mislav git://github.com/mislav/CURRENT_REPO.git 307 > git cherry-pick SHA 308 309 $ git cherry-pick mislav@SHA 310 > git fetch mislav 311 > git cherry-pick SHA 312 </code></pre> 313 314 <h3 id="git-am-git-apply">git am, git apply</h3> 315 316 <pre><code>$ git am https://github.com/defunkt/hub/pull/55 317 [ downloads patch via API ] 318 > git am /tmp/55.patch 319 320 $ git am --ignore-whitespace https://github.com/davidbalbert/hub/commit/fdb9921 321 [ downloads patch via API ] 322 > git am --ignore-whitespace /tmp/fdb9921.patch 323 324 $ git apply https://gist.github.com/8da7fb575debd88c54cf 325 [ downloads patch via API ] 326 > git apply /tmp/gist-8da7fb575debd88c54cf.txt 327 </code></pre> 328 329 <h3 id="git-fork">git fork</h3> 330 331 <pre><code>$ git fork 332 [ repo forked on GitHub ] 333 > git remote add -f YOUR_USER git@github.com:YOUR_USER/CURRENT_REPO.git 334 </code></pre> 335 336 <h3 id="git-pull-request">git pull-request</h3> 337 338 <pre><code># while on a topic branch called "feature": 339 $ git pull-request 340 [ opens text editor to edit title & body for the request ] 341 [ opened pull request on GitHub for "YOUR_USER:feature" ] 342 343 # explicit title, pull base & head: 344 $ git pull-request -m "Implemented feature X" -b defunkt:master -h mislav:feature 345 </code></pre> 346 347 <h3 id="git-checkout">git checkout</h3> 348 349 <pre><code>$ git checkout https://github.com/defunkt/hub/pull/73 350 > git remote add -f -t feature mislav git://github.com/mislav/hub.git 351 > git checkout --track -B mislav-feature mislav/feature 352 353 $ git checkout https://github.com/defunkt/hub/pull/73 custom-branch-name 354 </code></pre> 355 356 <h3 id="git-merge">git merge</h3> 357 358 <pre><code>$ git merge https://github.com/defunkt/hub/pull/73 359 > git fetch git://github.com/mislav/hub.git +refs/heads/feature:refs/remotes/mislav/feature 360 > git merge mislav/feature --no-ff -m 'Merge pull request #73 from mislav/feature...' 361 </code></pre> 362 363 <h3 id="git-create">git create</h3> 364 365 <pre><code>$ git create 366 [ repo created on GitHub ] 367 > git remote add origin git@github.com:YOUR_USER/CURRENT_REPO.git 368 369 # with description: 370 $ git create -d 'It shall be mine, all mine!' 371 372 $ git create recipes 373 [ repo created on GitHub ] 374 > git remote add origin git@github.com:YOUR_USER/recipes.git 375 376 $ git create sinatra/recipes 377 [ repo created in GitHub organization ] 378 > git remote add origin git@github.com:sinatra/recipes.git 379 </code></pre> 380 381 <h3 id="git-init">git init</h3> 382 383 <pre><code>$ git init -g 384 > git init 385 > git remote add origin git@github.com:YOUR_USER/REPO.git 386 </code></pre> 387 388 <h3 id="git-push">git push</h3> 389 390 <pre><code>$ git push origin,staging,qa bert_timeout 391 > git push origin bert_timeout 392 > git push staging bert_timeout 393 > git push qa bert_timeout 394 </code></pre> 395 396 <h3 id="git-browse">git browse</h3> 397 398 <pre><code>$ git browse 399 > open https://github.com/YOUR_USER/CURRENT_REPO 400 401 $ git browse -- commit/SHA 402 > open https://github.com/YOUR_USER/CURRENT_REPO/commit/SHA 403 404 $ git browse -- issues 405 > open https://github.com/YOUR_USER/CURRENT_REPO/issues 406 407 $ git browse -- issues/10 408 > open https://github.com/YOUR_USER/CURRENT_REPO/issues/10 409 410 $ git browse schacon/ticgit 411 > open https://github.com/schacon/ticgit 412 413 $ git browse schacon/ticgit commit/SHA 414 > open https://github.com/schacon/ticgit/commit/SHA 415 416 $ git browse resque 417 > open https://github.com/YOUR_USER/resque 418 419 $ git browse resque network 420 > open https://github.com/YOUR_USER/resque/network 421 </code></pre> 422 423 <h3 id="git-compare">git compare</h3> 424 425 <pre><code>$ git compare refactor 426 > open https://github.com/CURRENT_REPO/compare/refactor 427 428 $ git compare 1.0..1.1 429 > open https://github.com/CURRENT_REPO/compare/1.0...1.1 430 431 $ git compare -u fix 432 > (https://github.com/CURRENT_REPO/compare/fix) 433 434 $ git compare other-user patch 435 > open https://github.com/other-user/REPO/compare/patch 436 </code></pre> 437 438 <h3 id="git-submodule">git submodule</h3> 439 440 <pre><code>$ git submodule add wycats/bundler vendor/bundler 441 > git submodule add git://github.com/wycats/bundler.git vendor/bundler 442 443 $ git submodule add -p wycats/bundler vendor/bundler 444 > git submodule add git@github.com:wycats/bundler.git vendor/bundler 445 446 $ git submodule add -b ryppl --name pip ryppl/pip vendor/pip 447 > git submodule add -b ryppl --name pip git://github.com/ryppl/pip.git vendor/pip 448 </code></pre> 449 450 <h3 id="git-ci-status">git ci-status</h3> 451 452 <pre><code>$ git ci-status [commit] 453 > (prints CI state of commit and exits with appropriate code) 454 > One of: success (0), error (1), failure (1), pending (2), no status (3) 455 </code></pre> 456 457 <h3 id="git-help">git help</h3> 458 459 <pre><code>$ git help 460 > (improved git help) 461 $ git help hub 462 > (hub man page) 463 </code></pre> 464 465 <h2 id="BUGS">BUGS</h2> 466 467 <p><a href="https://github.com/github/hub/issues" data-bare-link="true">https://github.com/github/hub/issues</a></p> 468 469 <h2 id="AUTHORS">AUTHORS</h2> 470 471 <p><a href="https://github.com/github/hub/contributors" data-bare-link="true">https://github.com/github/hub/contributors</a></p> 472 473 <h2 id="SEE-ALSO">SEE ALSO</h2> 474 475 <p><span class="man-ref">git<span class="s">(1)</span></span>, <span class="man-ref">git-clone<span class="s">(1)</span></span>, <span class="man-ref">git-remote<span class="s">(1)</span></span>, <span class="man-ref">git-init<span class="s">(1)</span></span>, 476 <a href="http://github.com" data-bare-link="true">http://github.com</a>, 477 <a href="https://github.com/github/hub" data-bare-link="true">https://github.com/github/hub</a></p> 478 479 480 <ol class='man-decor man-foot man foot'> 481 <li class='tl'>GITHUB</li> 482 <li class='tc'>January 2015</li> 483 <li class='tr'>hub(1)</li> 484 </ol> 485 486 </div> 487 </body> 488 </html>