Merge pull request #759 from blueyed/doc-browse-commit

doc: example for "browse commit"

man/hub.1

 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "HUB" "1" "October 2014" "GITHUB" "Hub Manual"
+.TH "HUB" "1" "January 2015" "GITHUB" "Hub Manual"
 .
 .SH "NAME"
 \fBhub\fR \- git + hub = github
@@ -137,7 +137,7 @@ Create a new public GitHub repository from the current git repository and add re
 .
 .TP
 \fBgit browse\fR [\fB\-u\fR] [[\fIUSER\fR\fB/\fR]\fIREPOSITORY\fR] [SUBPAGE]
-Open repository\'s GitHub page in the system\'s default web browser using \fBopen(1)\fR or the \fBBROWSER\fR env variable\. If the repository isn\'t specified, \fBbrowse\fR opens the page of the repository found in the current directory\. If SUBPAGE is specified, the browser will open on the specified subpage: one of "wiki", "commits", "issues" or other (the default is "tree")\. With \fB\-u\fR, outputs the URL rather than opening the browser\.
+Open repository\'s GitHub page in the system\'s default web browser using \fBopen(1)\fR or the \fBBROWSER\fR env variable\. If the repository isn\'t specified, \fBbrowse\fR opens the page of the repository found in the current directory\. If SUBPAGE is specified, the browser will open on the specified subpage: one of "wiki", "commits", "issues" or other (the default is "tree")\. A specific commit in the default repository can be opened with \fBgit browse \-\- commit/<COMMIT>\fR\. With \fB\-u\fR, outputs the URL rather than opening the browser\.
 .
 .TP
 \fBgit compare\fR [\fB\-u\fR] [\fIUSER\fR] [[\fISTART\fR\.\.\.]\fIEND\fR]
@@ -215,7 +215,7 @@ $ git config \-\-global \-\-add hub\.host my\.git\.org
 .IP "" 0
 .
 .P
-The default host for commands like \fBinit\fR and \fBclone\fR is still github\.com, but this can be affected with the \fIGITHUB_HOST\fR environment variable:
+The default host for commands like \fBinit\fR and \fBclone\fR is still github\.com, but this can be affected with the \fBGITHUB_HOST\fR environment variable:
 .
 .IP "" 4
 .

man/hub.1.html

@@ -172,9 +172,12 @@ set the repository's description and homepage URL, respectively.</p></dd>
 <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
 <code>open(1)</code> or the <code>BROWSER</code> env variable. If the repository isn't
 specified, <code>browse</code> opens the page of the repository found in the current
-directory. If SUBPAGE is specified, the browser will open on the specified
+directory.
+If SUBPAGE is specified, the browser will open on the specified
 subpage: one of "wiki", "commits", "issues" or other (the default is
-"tree"). With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd>
+"tree"). A specific commit in the default repository can be opened with
+<code>git browse -- commit/&lt;COMMIT></code>.
+With <code>-u</code>, outputs the URL rather than opening the browser.</p></dd>
 <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.
 <var>START</var> to <var>END</var> are branch names, tag names, or commit SHA1s specifying
 the range of history to compare. If a range with two dots (<code>a..b</code>) is given,
@@ -249,7 +252,7 @@ configure hub to treat such remotes same as github.com:</p>
 </code></pre>
 
 <p>The default host for commands like <code>init</code> and <code>clone</code> is still
-github.com, but this can be affected with the <var>GITHUB_HOST</var> environment
+github.com, but this can be affected with the <code>GITHUB_HOST</code> environment
 variable:</p>
 
 <pre><code>$ GITHUB_HOST=my.git.org git clone myproject
@@ -476,7 +479,7 @@ $ git help hub
 
   <ol class='man-decor man-foot man foot'>
     <li class='tl'>GITHUB</li>
-    <li class='tc'>October 2014</li>
+    <li class='tc'>January 2015</li>
     <li class='tr'>hub(1)</li>
   </ol>
 

man/hub.1.ronn

@@ -125,9 +125,12 @@ hub also adds some custom commands that are otherwise not present in git:
     Open repository's GitHub page in the system's default web browser using
     `open(1)` or the `BROWSER` env variable. If the repository isn't
     specified, `browse` opens the page of the repository found in the current
-    directory. If SUBPAGE is specified, the browser will open on the specified
+    directory.
+    If SUBPAGE is specified, the browser will open on the specified
     subpage: one of "wiki", "commits", "issues" or other (the default is
-    "tree"). With `-u`, outputs the URL rather than opening the browser.
+    "tree"). A specific commit in the default repository can be opened with
+    `git browse -- commit/<COMMIT>`.
+    With `-u`, outputs the URL rather than opening the browser.
 
   * `git compare` [`-u`] [<USER>] [[<START>...]<END>]:
     Open a GitHub compare view page in the system's default web browser.