Skip to content

H
hub

github / hub
12 个月 前同步成功

通知 3
Star 22523
Fork 2406
H
hub

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

切换分支/标签
查找文件 普通视图历史永久链接Permalink
hub.1.html 8.0 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
0.3.1  
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
0.3.1  
Chris Wanstrath 已提交
73 74 75 76 77 
<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>
<code>git browse</code> [<code>-p</code>] [<var>USER</var>/]<var>REPOSITORY</var> <br>
</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 

<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
C
Update history & mandocs  
Chris Wanstrath 已提交
117 118 
"git@github.com:<var>USER</var>/<var>REPOSITORY</var>.git". If <var>USER</var> is "origin"
then uses your GitHub login.</p></dd>
C
update docs with new git-push info  
Chris Wanstrath 已提交
119 120 121 122 123 
<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 已提交
124 
<dt>
M
`hub browse` with no repository specified defaults to current repo  
Mislav Marohnić 已提交
125 
<code>git browse</code> [<code>-p</code>] [[<var>USER</var><code>/</code>]<var>REPOSITORY</var>]</dt>
C
update generated manpages  
Chris Wanstrath 已提交
126 127 
<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
M
`hub browse` with no repository specified defaults to current repo  
Mislav Marohnić 已提交
128 129 
page with https. If the repository isn't specified, <code>browse</code> opens
the page of the repository found in the current directory.</p></dd>
C
update generated manpage  
Chris Wanstrath 已提交
130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 
<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 已提交
147 148 149 150 151 152 153 154 
<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 已提交
155
C
add EXAMPLES to man page  
Chris Wanstrath 已提交
156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 
<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
C
Update history & mandocs  
Chris Wanstrath 已提交
180 181 

$ git remote add origin
C
fix typo  
Chris Wanstrath 已提交
182 
&gt; git remote add origin git://github.com/YOUR_USER/CURRENT_REPO.git
C
add EXAMPLES to man page  
Chris Wanstrath 已提交
183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 
</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 已提交
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 
<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 已提交
215 216 217 218 219 220 221 222 
<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 已提交
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 
<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 history & mandocs  
Chris Wanstrath 已提交
239 
  <li class='tc'>February 2010</li>
C
update generated manpage  
Chris Wanstrath 已提交
240 241 242 243 244 245 
  <li class='tr'>hub(1)</li>
</ol>

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