Re: Anybody know a website with up-to-date git documentation?

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Jan 30, 2013 at 09:18:24AM -0800, Junio C Hamano wrote:
> Max Horn <max@xxxxxxxxx> writes:
> 
> [administrivia: please wrap lines to a reasonable width]

Curiously, gmail's web interface appears to have started doing
this only recently.  I've noticed it when trying to respond to
others too.

> > On 30.01.2013, at 16:59, Sitaram Chamarty wrote:
> >
> >> I'm curious... what's wrong with 'git checkout html' from the git repo
> >> and just browsing them using a web browser?
> >
> > Hm, do you mean "make html", perhaps? At least I couldn't figure
> > out what "git checkout html" should do, but out of curiosity gave
> > it a try and got an error...
> 
> Perhaps some information from "A note from the maintainer" (posted
> to this list from time to time) is lacking.  Some excerpts:
> 
>     You can browse the HTML manual pages at:
> 
>             http://git-htmldocs.googlecode.com/git/git.html
> 
>     Preformatted documentation from the tip of the "master" branch can be
>     found in:
> 
>             git://git.kernel.org/pub/scm/git/git-{htmldocs,manpages}.git/
>             git://repo.or.cz/git-{htmldocs,manpages}.git/
>             ...
> 
> 
> Armed with that knowledge, I think Sitaram may have something like
> this:
> 
> 	[remote "htmldocs"]
> 		url = git://git.kernel.org/pub/scm/git/git-htmldocs.git/
> 		fetch = +refs/heads/master:refs/heads/html
> 
> and does
> 
> 	git fetch htmldocs
>         git checkout html

Hmm; I don't recall ever doing that.  But I just realised that
my "html" branch is stuck at 1.7.7:

    $ git branch -v -v | grep html
      html   8fb66e5 [origin/html] Autogenerated HTML docs for v1.7.7-138-g7f41b6

Is it possible that upto that point, the main git.git repo did
carry this branch also?  I have 3 remotes:

    $ git remote -v
    gc	https://code.google.com/p/git-core (fetch)
    gc	https://code.google.com/p/git-core (push)
    ghgit	git://github.com/git/git.git (fetch)
    ghgit	git://github.com/git/git.git (push)
    origin	git://git.kernel.org/pub/scm/git/git.git (fetch)
    origin	git://git.kernel.org/pub/scm/git/git.git (push)

and all 3 of them carry this branch:

    $ git branch -a -v -v | grep html
      html                  8fb66e5 [origin/html] Autogenerated HTML docs for v1.7.7-138-g7f41b6
      remotes/gc/html       8fb66e5 Autogenerated HTML docs for v1.7.7-138-g7f41b6
      remotes/ghgit/html    8fb66e5 Autogenerated HTML docs for v1.7.7-138-g7f41b6
      remotes/origin/html   8fb66e5 Autogenerated HTML docs for v1.7.7-138-g7f41b6

Even if I had, at one point, added a remote specifically for
html, I am sure it could not have created those refs!

So I tried a prune:

    $ git remote update --prune
    Fetching origin
     x [deleted]         (none)     -> origin/html
     x [deleted]         (none)     -> origin/man
    Fetching ghgit
     x [deleted]         (none)     -> ghgit/html
     x [deleted]         (none)     -> ghgit/man
    Fetching gc
     x [deleted]         (none)     -> gc/html
     x [deleted]         (none)     -> gc/man

and now I'm on par with the rest of you ;-)

> You can, too, of course ;-)

You can do even more!  If you don't find a suitable website for
this, it's trivial to host it yourself.  You can host it on your
intranet, if you have one.
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]