From: Clifford Caoile Date: Sat, 19 Apr 2008 07:35:49 GMT Subject: Re: [PATCH] Docs gitk: Explicitly mention -d, --date-order option Message-ID: <1f748ec60804190035x194a9bc2qfd2287daaa4e1860@mail.gmail.com> In-Reply-To: <7v1w52ib5d.fsf@gitster.siamese.dyndns.org> Junio C Hamano: On Sat, Apr 19, 2008 at 3:58 PM, Junio C Hamano wrote: > "Clifford Caoile" writes: > > Git Mailing List, Git Maintainer: > Heh, my name is not "Git Maintainer" ;-) Sorry about that. Just adding another layer of indirection. >:-] > > Regarding the documentation patch "[PATCH] Docs gitk: Explicitly > > mention -d, --date-order option" [1] (2008-04-12), it has not been > > accepted. Is there problem with this patch? > > > > References: > > [1] http://marc.info/?l=git&m=120799377618677&w=2 > > There isn't anything _wrong_ with the patch per se, but the current > documentation refers you to rev-list page and limits itself to the most > often used options. > > I was waiting to see that many people jumping up and down saying that the > omission of --date-order from the "most often used" set was a grave bug > before applying it. It hasn't happened. The whole motivation for adding this documentation is to show that gitk has the same sorting function as git-browser. I only learned of this capability through the irc channel. As a git newbie, it wasn't obvious to me that "--date-order" was an available option. It has become my usual parameter when launching gitk on branch/merge heavy repos. Besides, and more importantly, the equivalent "-d" is a gitk only parameter that should probably be documented as well. I had to read the gitk tcl source for that one. ;-) Best regards, Clifford Caoile