From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Tassilo Horn Newsgroups: gmane.emacs.devel Subject: Re: Apologia for bzr Date: Fri, 03 Jan 2014 17:57:19 +0100 Message-ID: <87sit56m1c.fsf@thinkpad.tsdh.org> References: <20140102095347.6834E381D0C@snark.thyrsus.com> <87fvp6bdd9.fsf_-_@ktab.red-bean.com> <83wqiixqbb.fsf@gnu.org> <20140102172804.GB13245@thyrsus.com> <83vby2xo6x.fsf@gnu.org> <20140102183432.GB13506@thyrsus.com> <83sit6xgfg.fsf@gnu.org> <8761q18kni.fsf@thinkpad.tsdh.org> <838uuxxsxu.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1388768253 17397 80.91.229.3 (3 Jan 2014 16:57:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 3 Jan 2014 16:57:33 +0000 (UTC) Cc: esr@thyrsus.com, kfogel@red-bean.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 03 17:57:40 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Vz840-0005bM-Qn for ged-emacs-devel@m.gmane.org; Fri, 03 Jan 2014 17:57:36 +0100 Original-Received: from localhost ([::1]:50689 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vz840-0001Cu-Fx for ged-emacs-devel@m.gmane.org; Fri, 03 Jan 2014 11:57:36 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49052) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vz83s-00016X-UW for emacs-devel@gnu.org; Fri, 03 Jan 2014 11:57:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vz83m-0005gW-VP for emacs-devel@gnu.org; Fri, 03 Jan 2014 11:57:28 -0500 Original-Received: from out3-smtp.messagingengine.com ([66.111.4.27]:39051) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vz83m-0005gK-RA for emacs-devel@gnu.org; Fri, 03 Jan 2014 11:57:22 -0500 Original-Received: from compute2.internal (compute2.nyi.mail.srv.osa [10.202.2.42]) by gateway1.nyi.mail.srv.osa (Postfix) with ESMTP id EC4E520E91 for ; Fri, 3 Jan 2014 11:57:21 -0500 (EST) Original-Received: from frontend1 ([10.202.2.160]) by compute2.internal (MEProxy); Fri, 03 Jan 2014 11:57:21 -0500 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=from:to:cc:subject:references:date :in-reply-to:message-id:mime-version:content-type; s=smtpout; bh=NpROAkZP8YL2cEPdUhRJg2S2Nl8=; b=KnZnTIoTs8lcz5fJmoK8t4r95HQJ 40CES7ks9S/8kyWEOgZwCgQkT5PEbMQm2RSXmpMry0+nMqlOOZhUdr59T6OGvKTA dfkLr6uIwH2YHLStvxUu5ndX+jz7adrNfxKyn2H5cRk4X5lKjxiCZCzHAxjpV2W8 vBmG5ef1BMZkcQM= X-Sasl-enc: wk+ZYEElLbcjRwYCLfCyZrOXZbYqs+l2X93U+XyeTQvP 1388768241 Original-Received: from thinkpad.tsdh.org (unknown [91.67.164.26]) by mail.messagingengine.com (Postfix) with ESMTPA id 1BE1BC00E84; Fri, 3 Jan 2014 11:57:21 -0500 (EST) Mail-Followup-To: Eli Zaretskii , esr@thyrsus.com, kfogel@red-bean.com, emacs-devel@gnu.org In-Reply-To: <838uuxxsxu.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 03 Jan 2014 12:26:05 +0200") User-Agent: Gnus/5.130008 (Ma Gnus v0.8) Emacs/24.3.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 66.111.4.27 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:167187 Archived-At: Eli Zaretskii writes: >> All the terminology that's referred to in the git command man pages is >> defined in one central place, the gitglossary(7) man page. > > First, there are no references to glossary in these places, and, as > you know well, references in man pages are a PITA to use (unlike in > Info). On my Gentoo system, git installed an info manual. But honestly, that's just an index of the man pages but still better to browse than the normal man pages, e.g., you have `l' to jump back to where you were previously etc. > More importantly, the glossary, at least git's glossary, is not going > to help here. Let's take this example I showed earlier: > > --reuse-message= > Take an existing commit object, and reuse the log message and the > authorship information (including the timestamp) when creating the > commit. > > Clearly, what I need to know here, and is never explained, is how do I > _reference_ a commit object. Now, here's what the glossary tells me: > > commit object > An object which contains the information about a particular > revision, such as parents, committer, author, date and the tree > object which corresponds to the top directory of the stored > revision. > > I hope you will agree with me that after reading this, I'm none the > wiser. Yes, true, but the gittutorial(7) does explain that. And searching for "git how to reference a commit" brings me to the git book's Revision Selection chapter which discusses that in utmost details. So the man pages could be better, but there are tons of additional resources you can consult that are easy to find and probably better to grasp. Bye, Tassilo