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

From: Sitaram Chamarty <sitaramc@gmail.com>
Date: Jan 30, 2013, 23:07 UTC
Message-ID: <20130130230709.GA7787@sita-lt.atc.tcs.com>
In-Reply-To: <7vlibalhcv.fsf@alter.siamese.dyndns.org>

On Wed, Jan 30, 2013 at 09:18:24AM -0800, Junio C Hamano wrote:

> Max Horn <max@quendi.de> 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.

Show 35 quoted lines

> > 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.