Skip to content

H
hub

github / hub
12 个月 前同步成功

通知 3
Star 22523
Fork 2406
H
hub

体验新版 GitCode，发现更多精彩内容 >>

切换分支/标签
查找文件 普通视图历史永久链接Permalink
hub.1.html 7.7 KB
Newer Older
C
update generated manpage  
Chris Wanstrath 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 
<!DOCTYPE html>
<html>
<head>
  <meta http-equiv='content-type' value='text/html;charset=utf8'>
  <meta name='generator' value='Ron/v0.3'>
  <title>hub(1) -- git + hub = github</title>
  <style type='text/css'>
    body {margin:0}
    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
      font-family:consolas,monospace;
      font-size:16px;
      line-height:1.3;
      color:#343331;
      background:#fff; }
    #man { max-width:89ex; text-align:justify; margin:0 25px 25px 25px }
    #man h1, #man h2, #man h3 { color:#232221;clear:left }
    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
    #man h3 { font-size:16px; margin:0 0 0 4ex; }
    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
    #man pre {
      color:#333231;
      background:#edeceb;
      padding:5px 7px;
      margin:0px 0 20px 0;
      border-left:2ex solid #ddd}
    #man pre + h2, #man pre + h3 {
      margin-top:22px;
    }
    #man h2 + pre, #man h3 + pre {
      margin-top:5px;
    }
    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
    #man dt { margin:0; clear:left }
    #man dt.flush { float:left; width:8ex }
    #man dd { margin:0 0 0 9ex }
    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
    #man pre code { font-weight:normal; color:#232221; background:inherit }
    #man em, var, u {
      font-style:normal; color:#333231; border-bottom:1px solid #999; }
    #man h1.man-title { display:none; }
    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
      float:left; width:33%; list-style-type:none;
      text-transform:uppercase; font-size:18px; color:#999;
      letter-spacing:1px;}
    #man ol.man { width:100%; }
    #man ol.man li.tl { text-align:left }
    #man ol.man li.tc { text-align:center;letter-spacing:4px }
    #man ol.man li.tr { text-align:right }
    #man ol.man a { color:#999 }
    #man ol.man a:hover { color:#333231 }
  </style>
</head>
<body>
<div id='man'>

<h1 class='man-title'>hub(1)</h1>

<ol class='head man'>
  <li class='tl'>hub(1)</li>
  <li class='tc'>Git Manual</li>
  <li class='tr'>hub(1)</li>
</ol>

<h2 id='NAME'>NAME</h2>
<p><code>hub</code> -- git + hub = github</p>
<h2>SYNOPSIS</h2>
C
arg stupid significant trailing whitespace in markdown  
Chris Wanstrath 已提交
69 70 71 
<p><code>hub</code> <var>COMMAND</var> <var>OPTIONS</var> <br>
<code>hub alias</code> [<code>-s</code>] <var>SHELL</var> <br>
</p>
C
update generated manpage  
Chris Wanstrath 已提交
72
C
arg stupid significant trailing whitespace in markdown  
Chris Wanstrath 已提交
73 74 75 
<p><code>git init -g</code> <var>OPTIONS</var> <br>
<code>git clone</code> [<code>-p</code>] <var>OPTIONS</var> [<var>USER</var>/]<var>REPOSITORY</var> <var>DIRECTORY</var> <br>
<code>git remote add</code> [<code>-p</code>] <var>OPTIONS</var> <var>USER</var>[/<var>REPOSITORY</var>] <br>
C
update generated manpages  
Chris Wanstrath 已提交
76 
<code>git browse</code> [<code>-p</code>] [<var>USER</var>/]<var>REPOSITORY</var> <br>
C
arg stupid significant trailing whitespace in markdown  
Chris Wanstrath 已提交
77 
</p>
C
update generated manpage  
Chris Wanstrath 已提交
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 

<h2>DESCRIPTION</h2>

<p><code>hub</code> enhances various <code>git</code> commands with GitHub remote expansion. The
alias command displays information on configuring your environment:</p>

<dl>
<dt>
<code>hub alias</code> [<code>-s</code>] <var>SHELL</var>
</dt>
<dd>Writes shell aliasing code for <var>SHELL</var> (<code>bash</code>, <code>sh</code>, <code>zsh</code>,
<code>csh</code>) to standard output. With the <code>-s</code> option, the output of
this command can be evaluated directly within the shell:
<code>eval $(hub alias -s bash)</code>
</dd>
</dl>


<p>After configuring the alias, the following commands have superpowers:</p>

<dl>
<dt>
<code>git init</code> <code>-g</code> <var>OPTIONS</var>
</dt>
<dd><p>Create a git repository as with git-init(1) and add remote <code>origin</code> at
"git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git"; <var>USER</var> is your GitHub username and
<var>REPOSITORY</var> is the current working directory's basename.</p></dd>
<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
<var>DIRECTORY</var> as with git-clone(1). When <var>USER</var>/ is omitted, assumes
your GitHub login. With <code>-p</code>, use private remote
"git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git".</p></dd>
<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
git-remote(1). When /<var>REPOSITORY</var> is omitted, the basename of the
current working directory is used. With <code>-p</code>, use private remote
"git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git".</p></dd>
C
update docs with new git-push info  
Chris Wanstrath 已提交
118 119 120 121 122 
<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
multiple <code>git push</code> commands.</p></dd>
C
update generated manpages  
Chris Wanstrath 已提交
123 124 125 126 127 128 
<dt>
<code>git browse</code> [<code>-p</code>] [<var>USER</var><code>/</code>]<var>REPOSITORY</var>
</dt>
<dd><p>Open repository's GitHub page in the system's default web browser
using <code>open(1)</code> or the <code>BROWSER</code> env variable. Use <code>-p</code> to open a
page with https.</p></dd>
C
update generated manpage  
Chris Wanstrath 已提交
129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 
<dt><code>git help</code></dt>
<dd><p>Display enhanced git-help(1).</p></dd>
</dl>


<h2>CONFIGURATION</h2>

<p>Use git-config(1) to display the currently configured GitHub username:</p>

<pre><code>$ git config --global github.user
</code></pre>

<p>Or, set the GitHub username with:</p>

<pre><code>$ git config --global github.user &lt;username&gt;
</code></pre>
C
update man pages  
Chris Wanstrath 已提交
146 147 148 149 150 151 152 153 
<p>See <a href="http://github.com/guides/local-github-config">http://github.com/guides/local-github-config</a> for more
information.</p>

<p>You can also tell <code>hub</code> to use <code>http://</code> rather than <code>git://</code> when
cloning:</p>

<pre><code>$ git config --global --add hub.http-clone yes
</code></pre>
C
update generated manpage  
Chris Wanstrath 已提交
154
C
add EXAMPLES to man page  
Chris Wanstrath 已提交
155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 
<h2>EXAMPLES</h2>

<h3>git clone</h3>

<pre><code>$ git clone schacon/ticgit
&gt; git clone git://github.com/schacon/ticgit.git

$ git clone -p schacon/ticgit
&gt; git clone git@github.com:schacon/ticgit.git

$ git clone resque
&gt; git clone git://github.com/YOUR_USER/resque.git

$ git clone -p resque
&gt; git clone git@github.com:YOUR_USER/resque.git
</code></pre>

<h3>git remote add</h3>

<pre><code>$ git remote add rtomayko
&gt; git remote add rtomayko git://github.com/rtomayko/CURRENT_REPO.git

$ git remote add -p rtomayko
&gt; git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git
</code></pre>

<h3>git init</h3>

<pre><code>$ git init -g
&gt; git init
&gt; git remote add origin git@github.com:YOUR_USER/REPO.git
</code></pre>

<h3>git push</h3>

<pre><code>$ git push origin,staging,qa bert_timeout
&gt; git push origin bert_timeout
&gt; git push staging bert_timeout
&gt; git push qa bert_timeout
</code></pre>
C
update generated manpages  
Chris Wanstrath 已提交
196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 
<h3>git browse</h3>

<pre><code>$ git browse schacon/ticgit
&gt; open http://github.com/schacon/ticgit

$ git browse -p schacon/ticgit
&gt; open http://github.com/schacon/ticgit

$ git browse resque
&gt; open http://github.com/YOUR_USER/resque

$ git browse -p resque
&gt; open https://github.com:YOUR_USER/resque
</code></pre>
C
add EXAMPLES to man page  
Chris Wanstrath 已提交
211 212 213 214 215 216 217 218 
<h3>git help</h3>

<pre><code>$ git help
&gt; (improved git help)
$ git help hub
&gt; (hub man page)
</code></pre>
C
update generated manpage  
Chris Wanstrath 已提交
219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 
<h2>BUGS</h2>

<p><a href="http://github.com/defunkt/hub/issues">http://github.com/defunkt/hub/issues</a></p>

<h2>AUTHOR</h2>

<p>Chris Wanstrath :: chris@ozmm.org :: @defunkt</p>

<h2>SEE ALSO</h2>

<p>git(1), git-clone(1), git-remote(1), git-init(1),
<a href="http://github.com">http://github.com</a>,
<a href="http://github.com/defunkt/hub">http://github.com/defunkt/hub</a></p>

<ol class='foot man'>
  <li class='tl'>DEFUNKT</li>
C
update generated manpages  
Chris Wanstrath 已提交
235 
  <li class='tc'>January 2010</li>
C
update generated manpage  
Chris Wanstrath 已提交
236 237 238 239 240 241 
  <li class='tr'>hub(1)</li>
</ol>

</div>
</body>
</html>