From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sitaram Chamarty Subject: Re: Anybody know a website with up-to-date git documentation? Date: Thu, 31 Jan 2013 04:37:09 +0530 Message-ID: <20130130230709.GA7787@sita-lt.atc.tcs.com> References: <20130130115439.GH1342@serenity.lan> <71A3AA8C-DBA2-44F7-9B69-AEDB81BB0906@quendi.de> <6BE76AE4-254E-43DD-A3FF-88B5486029A5@quendi.de> <7vlibalhcv.fsf@alter.siamese.dyndns.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Max Horn , John Keeping , git@vger.kernel.org, Scott Chacon To: Junio C Hamano X-From: git-owner@vger.kernel.org Thu Jan 31 00:07:50 2013 Return-path: Envelope-to: gcvg-git-2@plane.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1U0gkr-0004Zx-08 for gcvg-git-2@plane.gmane.org; Thu, 31 Jan 2013 00:07:45 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756406Ab3A3XHX (ORCPT ); Wed, 30 Jan 2013 18:07:23 -0500 Received: from mail-da0-f51.google.com ([209.85.210.51]:34284 "EHLO mail-da0-f51.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754183Ab3A3XHV (ORCPT ); Wed, 30 Jan 2013 18:07:21 -0500 Received: by mail-da0-f51.google.com with SMTP id i30so984878dad.24 for ; Wed, 30 Jan 2013 15:07:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:date:from:to:cc:subject:message-id:references :mime-version:content-type:content-disposition:in-reply-to :user-agent; bh=pI0sdj864lC/j1aVkhBvrEJT7l5Z/71UsnFBTtWatIk=; b=sCaYFTTmQGLFRZys024o73RvN7+MTRR5cWChyTLsV/iity0wH8opL42j4ZK6oRs43h 4VVbT+mnNDujOGD0XkaNBebggEqBvfPBSWmpA2VI2rouHNKOyAjEyS1C/mHrr0xHP3Gz xc7uyfK8yjvLI1zXQxWxa31scrjqePDK5GOHrScmjEjZdLXFemxO87kG/pF+wsa9KaMA 4PE80Y16L03yWARhFQRMc4UHXNX9KsGxBOpLfNRxkKTxhmZmpXt2U52ZqMNyKn/5iLXq wxuGJW+xX8JtSZF2ywClSXTdpb62lvcG8agtgyCgvkK6e2tGKNhndLTbythAuPeyGfEn YU+g== X-Received: by 10.68.235.1 with SMTP id ui1mr16435051pbc.138.1359587240850; Wed, 30 Jan 2013 15:07:20 -0800 (PST) Received: from sita-lt.atc.tcs.com ([117.195.163.246]) by mx.google.com with ESMTPS id az8sm3383917pab.3.2013.01.30.15.07.17 (version=TLSv1 cipher=RC4-SHA bits=128/128); Wed, 30 Jan 2013 15:07:20 -0800 (PST) Content-Disposition: inline In-Reply-To: <7vlibalhcv.fsf@alter.siamese.dyndns.org> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Wed, Jan 30, 2013 at 09:18:24AM -0800, Junio C Hamano wrote: > Max Horn 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.