# [PATCH] doc: move rev-list option - from git-log.txt to rev-list-options.txt 4 messages from 2012-09-06 to 2012-09-08. Participants: Nguyễn Thái Ngọc Duy, Michael J Gruber, Junio C Hamano, Nguyen Thai Ngoc Duy. Thread: https://gitlist.dev/t/31457 ## Nguyễn Thái Ngọc Duy, 2012-09-06 14:28 Subject: [PATCH] doc: move rev-list option - from git-log.txt to rev-list-options.txt Message-ID: <1346941683-24832-1-git-send-email-pclouds@gmail.com> URL: https://gitlist.dev/e/1346941683-24832-1-git-send-email-pclouds%40gmail.com ``` rev-list-options.txt is included in git-rev-list.txt. This makes sure rev-list man page also shows that, and at one place, together with equivalent options -n and --max-count. Signed-off-by: Nguyễn Thái Ngọc Duy --- Documentation/git-log.txt | 6 ++---- Documentation/rev-list-options.txt | 3 ++- 2 tập tin đã bị thay đổi, 4 được thêm vào(+), 5 bị xóa(-) diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt index 1f90620..585dac4 100644 --- a/Documentation/git-log.txt +++ b/Documentation/git-log.txt @@ -24,10 +24,6 @@ each commit introduces are shown. OPTIONS ------- --:: - Limits the number of commits to show. - Note that this is a commit limiting option, see below. - ..:: Show only commits between the named two commits. When either or is omitted, it defaults to @@ -137,6 +133,8 @@ Examples This makes sense only when following a strict policy of merging all topic branches when staying on a single integration branch. +`git log -3`:: + Limits the number of commits to show to 3. Discussion ---------- diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt index def1340..1b15ea9 100644 --- a/Documentation/rev-list-options.txt +++ b/Documentation/rev-list-options.txt @@ -8,7 +8,8 @@ ordering and formatting options, such as '--reverse'. -- --n 'number':: +-:: +-n :: --max-count=:: Limit the number of commits to output. -- 1.7.12.rc2.18.g61b472e ``` ## Michael J Gruber, 2012-09-07 08:50 Subject: Re: [PATCH] doc: move rev-list option - from git-log.txt to rev-list-options.txt Message-ID: <5049B54F.7020301@drmicha.warpmail.net> URL: https://gitlist.dev/e/5049B54F.7020301%40drmicha.warpmail.net In-Reply-To: <1346941683-24832-1-git-send-email-pclouds@gmail.com> ``` Nguyễn Thái Ngọc Duy venit, vidit, dixit 06.09.2012 16:28: > rev-list-options.txt is included in git-rev-list.txt. This makes sure > rev-list man page also shows that, and at one place, together with > equivalent options -n and --max-count. > > Signed-off-by: Nguyễn Thái Ngọc Duy > --- > Documentation/git-log.txt | 6 ++---- > Documentation/rev-list-options.txt | 3 ++- > 2 tập tin đã bị thay đổi, 4 được thêm vào(+), 5 bị xóa(-) That is one reason why "core.local=C" (repo specific) and "git -c core.locale=C" (can be used in an alias) would be useful ;) > > diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt > index 1f90620..585dac4 100644 > --- a/Documentation/git-log.txt > +++ b/Documentation/git-log.txt > @@ -24,10 +24,6 @@ each commit introduces are shown. > OPTIONS > ------- > > --:: > - Limits the number of commits to show. > - Note that this is a commit limiting option, see below. > - > ..:: > Show only commits between the named two commits. When > either or is omitted, it defaults to > @@ -137,6 +133,8 @@ Examples > This makes sense only when following a strict policy of merging all > topic branches when staying on a single integration branch. > > +`git log -3`:: > + Limits the number of commits to show to 3. > > Discussion > ---------- > diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt > index def1340..1b15ea9 100644 > --- a/Documentation/rev-list-options.txt > +++ b/Documentation/rev-list-options.txt > @@ -8,7 +8,8 @@ ordering and formatting options, such as '--reverse'. > > -- > > --n 'number':: > +-:: > +-n :: > --max-count=:: > > Limit the number of commits to output. > This looks OK. I noticed though that the man pages of git-log and git-rev-list still look more different than they would need to, e.g. regarding the way limitting by paths is explained more prominently with git-log. But that may just be being more user friendly for git-log's man page than for git rev-list's, which is OK. Michael ``` ## Junio C Hamano, 2012-09-07 17:14 Subject: Re: [PATCH] doc: move rev-list option - from git-log.txt to rev-list-options.txt Message-ID: <7vwr05yctv.fsf@alter.siamese.dyndns.org> URL: https://gitlist.dev/e/7vwr05yctv.fsf%40alter.siamese.dyndns.org In-Reply-To: <5049B54F.7020301@drmicha.warpmail.net> ``` Michael J Gruber writes: > Nguyễn Thái Ngọc Duy venit, vidit, dixit 06.09.2012 16:28: >> rev-list-options.txt is included in git-rev-list.txt. This makes sure >> rev-list man page also shows that, and at one place, together with >> equivalent options -n and --max-count. >> >> Signed-off-by: Nguyễn Thái Ngọc Duy >> --- >> Documentation/git-log.txt | 6 ++---- >> Documentation/rev-list-options.txt | 3 ++- >> 2 tập tin đã bị thay đổi, 4 được thêm vào(+), 5 bị xóa(-) > > That is one reason why "core.local=C" (repo specific) and "git -c > core.locale=C" (can be used in an alias) would be useful ;) Or "LC_ALL=C LANG=C git format-patch ...". It does not bother me (even though I do not read Vietnamese), but this has been brought up a few times, and we may want to revert the i18n of the diffstat summary. It does not seem to add much value to the system but annoys people. After all, the "upstream" diffstat does not localizes this string (I just checked diffstat-1.55 with Jan 2012 timestamp). ``` ## Nguyen Thai Ngoc Duy, 2012-09-08 16:11 Subject: Re: [PATCH] doc: move rev-list option - from git-log.txt to rev-list-options.txt Message-ID: URL: https://gitlist.dev/e/CACsJy8CmwvR%2BZN5eoqpn%3Dyj0GdmgWsOGQNpUK2GetktKuZ36iQ%40mail.gmail.com In-Reply-To: <7vwr05yctv.fsf@alter.siamese.dyndns.org> ``` On Sat, Sep 8, 2012 at 12:14 AM, Junio C Hamano wrote: > Michael J Gruber writes: >>> Documentation/git-log.txt | 6 ++---- >>> Documentation/rev-list-options.txt | 3 ++- >>> 2 tập tin đã bị thay đổi, 4 được thêm vào(+), 5 bị xóa(-) >> >> That is one reason why "core.local=C" (repo specific) and "git -c >> core.locale=C" (can be used in an alias) would be useful ;) > > Or "LC_ALL=C LANG=C git format-patch ...". The only problem is I forget to do that from time to time (and doing that bothers me too) > It does not bother me (even though I do not read Vietnamese), but > this has been brought up a few times, and we may want to revert the > i18n of the diffstat summary. It does not seem to add much value to > the system but annoys people. That's one step towards a better interface for non English speaking users. "git log" interface for example still shows Author, Commit, Date in English and these strings are shared with format-patch. Reverting back to English to me is a step back. This brings back to a series I posted about two weeks ago and got no comments http://article.gmane.org/gmane.comp.version-control.git/204285 I think it's a reasonable approach. Use English for machine interface, otherwise a native language if available. > After all, the "upstream" diffstat > does not localizes this string (I just checked diffstat-1.55 with > Jan 2012 timestamp). -- Duy ```