From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Git mirrors Date: Mon, 17 Oct 2011 21:09:59 +0900 Message-ID: <87r52bq0o8.fsf@uwakimon.sk.tsukuba.ac.jp> References: <871uuksdxi.fsf@lifelogs.com> <87lissh32y.fsf@wanadoo.es> <87zkh8e286.fsf@catnip.gol.com> <87d3e4gttq.fsf@wanadoo.es> <87ehyjrhxh.fsf@uwakimon.sk.tsukuba.ac.jp> <87d3e2rfte.fsf@uwakimon.sk.tsukuba.ac.jp> <878voqfiaw.fsf@wanadoo.es> <87zkh4bhho.fsf@wanadoo.es> <87zkh4nrcr.fsf@uwakimon.sk.tsukuba.ac.jp> <87zkh0ozjz.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Trace: dough.gmane.org 1318853437 18754 80.91.229.12 (17 Oct 2011 12:10:37 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 17 Oct 2011 12:10:37 +0000 (UTC) Cc: ofv@wanadoo.es, lekktu@gmail.com, Andreas Schwab , rms@gnu.org, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Oct 17 14:10:30 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RFm1S-0002LS-IH for ged-emacs-devel@m.gmane.org; Mon, 17 Oct 2011 14:10:26 +0200 Original-Received: from localhost ([::1]:44001 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFm1O-0003do-Td for ged-emacs-devel@m.gmane.org; Mon, 17 Oct 2011 08:10:22 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:58304) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFm19-0003CN-BG for emacs-devel@gnu.org; Mon, 17 Oct 2011 08:10:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RFm17-00046b-Vv for emacs-devel@gnu.org; Mon, 17 Oct 2011 08:10:07 -0400 Original-Received: from mgmt1.sk.tsukuba.ac.jp ([130.158.97.223]:59602) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RFm14-00043Q-P6; Mon, 17 Oct 2011 08:10:03 -0400 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mgmt1.sk.tsukuba.ac.jp (Postfix) with ESMTP id 1BBFC3FA072A; Mon, 17 Oct 2011 21:09:59 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id 16D7F1A273D; Mon, 17 Oct 2011 21:09:59 +0900 (JST) In-Reply-To: X-Mailer: VM 8.2.0a1 under 21.5 (beta31) "ginger" 6c76f5b7e2e3 XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 130.158.97.223 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:145250 Archived-At: Eli Zaretskii writes: > Tutorial is not the issue here. (Git does come with an official > tutorial man page.) Actually, it comes with three or so. This is a problem ("quantity before quality"). > The issue here is that every command should be explained in a way > that is suitable both for the first reading by someone > inexperienced, and as reference material for someone experienced > who knows exactly what she is after. I didn't find any git > documentation that fills the former niche (but I admit that I > didn't look too hard). You won't get explanations for newbies for many git commands, because they aren't commands. They are actually internal functions, exposed as commands because git's scripting language is POSIX shell. Many commands do have reasonable introductions somewhere in the tutorials, howtos, or man pages, but the organization of the documentation leaves a lot to be desired. You're absolutely right that there's no rule for finding introductory material, you just have to be lucky (or read everything, which is impractical to say the least).