git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Jiang Xin <worldhello.net@gmail.com>
To: Junio C Hamano <gitster@pobox.com>
Cc: Git List <git@vger.kernel.org>, avarab@gmail.com
Subject: Re: [PATCH] Maintaince script for l10n files and commits
Date: Fri, 9 Mar 2012 08:57:22 +0800	[thread overview]
Message-ID: <CANYiYbGxsTZ1sDVf8e47w9butmN_XUgucJByfCdYfFSpNhzVYA@mail.gmail.com> (raw)
In-Reply-To: <7v399iddw3.fsf@alter.siamese.dyndns.org>

2012/3/9 Junio C Hamano <gitster@pobox.com>:
> That's quite a style deviation from out norm in the commit log
> messages, don't you think (see "git log --no-merges -100", for
> example)?  State the problem you are attempting to solve first, and
> explain the solution to the problem, in separate paragraphs for
> readability, perhaps like this:
>
>        There are routine tasks translators need to perform that can
>        be automated.
>
>        Help them to
>
>         (1) initialize or update the message files;
>         (2) check errors in the message files they edited;
>         (3) check errors in their commits; and
>         (4) review recent updates to the message template file
>             they base their translations on.
>
>        by adding a helper script.

Thank you for provide better commit log, and I learn
a lot from it. Writing in English still a big issue for me,
and also obstacles to many l10n contributors. So your
decision that l10n contributors can write commit logs
in native language is very helpful, yet it has potential
risk about wrong character encodings in commit log.
So I need to write a helper for l10n team leaders,
especially for myself, to detect bad commit log,
because nobody knows all languages and encodings.
Hacks outside of "po/" directory should be checked
regularly also.


>> @@ -0,0 +1,271 @@
>> +#!/bin/bash
>
> Is there any bash-ism in this script?  Otherwise please start this
> with "#!/bin/sh" to allow people who do not use bash to get involved
> in the project.

There are several regex match expressions written in bash style,
which is not dash compatible. I will try to use grep and sed instead.

> Will we later regret that we didn't give a command word for this
> one?  Two common sources of such risks are:
>
>  (1) it turns out XX.po matches the pattern we would want to use as
>     a command; and
>
>  (2) it turns out "init/update" is not the most often used action.
>
> I do not think (1) is likely. I do not think anybody can decide
> about (2) at this point yet.

The style of arguments comes from previous Rakefile implementation.
I will change XX.po as a alias subcommand of init/update.

-- 
Jiang xin

  reply	other threads:[~2012-03-09  0:57 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-03-07 18:47 [PATCH] Maintaince script for l10n files and commits Jiang Xin
2012-03-07 19:17 ` Junio C Hamano
2012-03-08 16:05   ` Jiang Xin
2012-03-08 20:41     ` Junio C Hamano
2012-03-09  0:57       ` Jiang Xin [this message]
2012-03-09  6:08       ` [PATCH v2] " Jiang Xin
2012-03-09  6:20         ` David Aguilar
2012-03-09  6:31           ` Jiang Xin
2012-03-10  0:40         ` Junio C Hamano
2012-03-10  9:17       ` [PATCH v3] " Jiang Xin

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CANYiYbGxsTZ1sDVf8e47w9butmN_XUgucJByfCdYfFSpNhzVYA@mail.gmail.com \
    --to=worldhello.net@gmail.com \
    --cc=avarab@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).