From patchwork Thu Mar 11 12:55:09 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 12131171 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 74947C433E6 for ; Thu, 11 Mar 2021 12:57:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 6D1B464FC3 for ; Thu, 11 Mar 2021 12:57:15 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233199AbhCKM4n (ORCPT ); Thu, 11 Mar 2021 07:56:43 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39408 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231296AbhCKM4S (ORCPT ); Thu, 11 Mar 2021 07:56:18 -0500 Received: from mail-pj1-x1034.google.com (mail-pj1-x1034.google.com [IPv6:2607:f8b0:4864:20::1034]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5B878C061574 for ; Thu, 11 Mar 2021 04:56:18 -0800 (PST) Received: by mail-pj1-x1034.google.com with SMTP id kk2-20020a17090b4a02b02900c777aa746fso9308356pjb.3 for ; Thu, 11 Mar 2021 04:56:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=dNaP624IGfc3du47FxmhKPPKGD1GMjh3akmFU5Coi7E=; b=ZW0tD/RU5sqd489KaPcd+atSG3F/H1MjV2231mKCyRunKr/g4Sihx/Pq/FQBwq/0Q0 viexCOh8QZIyeB1xK3yccloJmoHV/Y6hGpNNV+isc4PPSXQn7vhUA3GPQQpmm00UdUiM 4mlfe92NgZCguOTUQqd2r0u1MkL5yn0qPNSUQHppGDdOWBQD+T82mFnRAk+d1ox7T0h0 QCscGbdClxy+KOt2EcA37Ib9ZcVHVGDiUxe9wT3d646PDwmLzFRCLh/7bTr21G+L9A56 SKzbsJv+Y8jS2za2mrMA9XN1wihZrm+HhBx8djTWEa2lxi0YwqBfNTPOYg9Tk5HjgZs1 Z15w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=dNaP624IGfc3du47FxmhKPPKGD1GMjh3akmFU5Coi7E=; b=qjlCMASEpVFGB2rfftolfcSFRhxcdW/kpe77CoXxRJpr9AFz8IwaAAU4B5NCoAqp9e TFGCL8sKbMdrgtQ3299KDpIfqktgLyMppMA+FnQ4cLUVvLCu497E2TIxP8DsMknP6m0R Y3RRI8gcrp/AW1mXZlfG8KQaomPZUBVunc5Ggdo/3bpRmf6Xuz3MYz93uad+NcuH2q5X NU82JtxnY5820iHGdNt43cD0psbUJVxUuK6EV5MjCLktzEZo273mf6kQP0o/nWCJGesH 9bL/zbrg7D6R6JoEc2Y2yMZ9Zf5mzm0qNx8dbh5dWS0FG/qSIJ6QK7S1fld0mIoTm6// DscQ== X-Gm-Message-State: AOAM530P+PL9N4Xz/YBA0Ae0FZ0iWFjwuaDlZlqIfqh1JEwgSEC73diu afaNB33o952AP6LNLbAa7gnouHelpvfpWQ== X-Google-Smtp-Source: ABdhPJy92YlsvUKjOt4Kt9kSeTWMe5s2YXAH2BJaE19y080qXWSXqdYa71A9E7ta8whrHO32qJNUTg== X-Received: by 2002:a17:90a:c797:: with SMTP id gn23mr8985474pjb.180.1615467377824; Thu, 11 Mar 2021 04:56:17 -0800 (PST) Received: from ubuntu.mate (subs03-180-214-233-84.three.co.id. [180.214.233.84]) by smtp.gmail.com with ESMTPSA id o1sm2389418pjp.4.2021.03.11.04.56.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Mar 2021 04:56:17 -0800 (PST) From: Bagas Sanjaya To: git@vger.kernel.org Cc: worldhello.net@gmail.com, Bagas Sanjaya Subject: [PATCH 1/3] po/README: document PO helper Date: Thu, 11 Mar 2021 19:55:09 +0700 Message-Id: <20210311125511.51152-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210311125511.51152-1-bagasdotme@gmail.com> References: <20210311125511.51152-1-bagasdotme@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Document about PO helper script (po-helper.sh). It covers about installing the script and short usage examples. Signed-off-by: Bagas Sanjaya --- po/README | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/po/README b/po/README index efd5baaf1d..9beffc2954 100644 --- a/po/README +++ b/po/README @@ -286,3 +286,25 @@ Testing marked strings Git's tests are run under LANG=C LC_ALL=C. So the tests do not need be changed to account for translations as they're added. + + +PO Helper +--------- + +To make maintaining XX.po file easier, the l10n coordinator created +po-helper.sh script. It is wrapper to gettext suite, specifically +written for the purpose of Git l10n workflow. + +To install the script, checkout "po-helper" branch, then copy +utils/po-helper.sh to somewhere on $PATH, and mark it executable. + +Below are the usage examples: + + - To start new language translation: + po-helper.sh init XX.po + - To update PO file: + po-helper.sh update XX.po + - To syntax check: + po-helper.sh check XX.po + +Run po-helper.sh without arguments for usage help. From patchwork Thu Mar 11 12:55:10 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 12131173 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 78432C433E9 for ; Thu, 11 Mar 2021 12:57:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 40C6264FE5 for ; Thu, 11 Mar 2021 12:57:15 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233226AbhCKM4o (ORCPT ); Thu, 11 Mar 2021 07:56:44 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39430 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233155AbhCKM4Y (ORCPT ); Thu, 11 Mar 2021 07:56:24 -0500 Received: from mail-pj1-x102f.google.com (mail-pj1-x102f.google.com [IPv6:2607:f8b0:4864:20::102f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 80ED7C061574 for ; Thu, 11 Mar 2021 04:56:24 -0800 (PST) Received: by mail-pj1-x102f.google.com with SMTP id lr1-20020a17090b4b81b02900ea0a3f38c1so1647942pjb.0 for ; Thu, 11 Mar 2021 04:56:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=8N+8nZMF2soe49MeGxn+dSEYpeQRZwONIpRJcK/L/vo=; b=mVsnRFcALh2Vx62eh3/Jp5vW8u+d63ew7psFA7ekb275vcHKEMCWnKka6Z006CojbI 6Bo4oQ/MlCFlXj1hoWWGkjM5QulwlLGHwIdsKwhattjKlCoOOOaYUmvHM/Xb4Rv7Mubt ziP+W5edMCCivWGzuZq4OCeRXHjtnh5xnjt5ZU9BPiVgjXo3RlBUMey29gG9LXKGWwyy APjlaNbwyz/DoZQuZQHUrZ4iTuuubiML2qKrbV5g21O5U/nyFqic6LFxBCmhvfLTUQ1s 5UHrHjrc1DH7mBKwBeVd/zj4LioVZodr0EUEuqqbpASCooXbbESPnHn1YHCg0Ws0qpER YEbQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=8N+8nZMF2soe49MeGxn+dSEYpeQRZwONIpRJcK/L/vo=; b=LiMd33v5E9WoqI7PA+Kj1KWS5OB7p9DfXdLt12p6p5pTrhxW/rqbEv83L34tkGntxe TUWG5vEoA7prAFwPYJ9kW/8rlXD9XQOUx27a29tABJVVplakqWkr4rMp1n8qgMlU0yiO uUICqJx5EaHgx5sBpj6JaDSVAU6O9YiLmnjA27+NPV7f+UqEU5LgDpZ2jyBpcq5SKPIz RBo4PKMybCXhh042NjpgZcFLv98432TvZ3hqGW+JFlDoJLUglqZ2XQQk2R946A9TXssr 1mUiG/9g3kq7TLnfjRaaG7iyi2PHdH/E/BC54RA0tYOspyUbGnHzCZpMbenb8+LUd6OZ hvWA== X-Gm-Message-State: AOAM533N+NBy5Bkjfkn+E9SrX/ABAQRiU1iTCv8IbvKa7qUABdLyXdB0 xAsQ9U6k07DmNEQtgiO4gxzgoObuDj04Tg== X-Google-Smtp-Source: ABdhPJxkYumjBqsWVTF6sHBTFhI6ewrT5a5uRLRZuSTQx95EDDwE5loZjGskSENTXk4OBCXT/TZayg== X-Received: by 2002:a17:90b:1987:: with SMTP id mv7mr8524108pjb.152.1615467383955; Thu, 11 Mar 2021 04:56:23 -0800 (PST) Received: from ubuntu.mate (subs03-180-214-233-84.three.co.id. [180.214.233.84]) by smtp.gmail.com with ESMTPSA id o1sm2389418pjp.4.2021.03.11.04.56.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Mar 2021 04:56:23 -0800 (PST) From: Bagas Sanjaya To: git@vger.kernel.org Cc: worldhello.net@gmail.com, Bagas Sanjaya Subject: [PATCH 2/3] po/README: document "core translation" Date: Thu, 11 Mar 2021 19:55:10 +0700 Message-Id: <20210311125511.51152-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210311125511.51152-1-bagasdotme@gmail.com> References: <20210311125511.51152-1-bagasdotme@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org We now expect new language translations to have core subset of 5000+ messages translated for these to be merged. If it hasn't been done yet, do so by first generate core PO, then do translation work there, merge it back to main PO (XX.po), and fix any "fuzzy" errors. Signed-off-by: Bagas Sanjaya --- po/README | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/po/README b/po/README index 9beffc2954..eda7edf4e6 100644 --- a/po/README +++ b/po/README @@ -39,6 +39,42 @@ coordinate among yourselves and nominate the team leader for your language, so that the l10n coordinator only needs to interact with one person per language. +Because there are now over 5000 messages that needs to be translated, +we expect to complete translation for core subset of messages before +a new language translation can be merged. See "Core translation" +below. + + +Core translation +---------------- +The core translation file, core-XX.po, covers some of commonly used +commands: + + - wt-status.c + - builtin/clone.c + - builtin/checkout.c + - builtin/index-pack.c + - builtin/push.c + - builtin/reset.c + +To generate core-XX.po, install the helper script (see "PO Helper") +and check the main PO file: + + cd po/ + po-helper.sh check id.po + +This will generate po/core-XX.po and corresponding po/core-XX.pot +template. Now complete the translation in po/core-XX.po. + +When it is completed, merge core translation back to main PO file: + + msgcat core-XX.po XX.po -s -o /tmp/XX.po + mv /tmp/XX.po XX.po + msgmerge --add-location --backup=off -U XX.po git.pot + +Fix any "fuzzy" errors that occurs, such as misplaced translated +messages and duplicate messages. + Translation Process Flow ------------------------ From patchwork Thu Mar 11 12:55:11 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 12131169 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.7 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 800E9C43381 for ; Thu, 11 Mar 2021 12:57:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id C6C8864FE7 for ; Thu, 11 Mar 2021 12:57:15 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233233AbhCKM4o (ORCPT ); Thu, 11 Mar 2021 07:56:44 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39446 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233157AbhCKM42 (ORCPT ); Thu, 11 Mar 2021 07:56:28 -0500 Received: from mail-pg1-x52a.google.com (mail-pg1-x52a.google.com [IPv6:2607:f8b0:4864:20::52a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9B01DC061574 for ; Thu, 11 Mar 2021 04:56:28 -0800 (PST) Received: by mail-pg1-x52a.google.com with SMTP id t26so13623794pgv.3 for ; Thu, 11 Mar 2021 04:56:28 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=y6dmFzxP10iUwxXZQtLOu1ATFPmHRCSgNY15RaoJUKY=; b=HTi2kc8E2lX34OzyYzXHndIJbULiueybAeqsUx+kpJnueXPgskHWBOZQt8PrjXZaxR lDMgtaL+GyJSlmPKkaWmyAj6/AUdheYFCebax6obu6hhBY37kyDd0kygv+3IcSSCwYiD ADA8sFXhBTYzme5TUonYeBtYVhJziqKwr4UlRgZN664j1UNObNLWaKm2JIoc1cN88RB9 dD871x/P9A6I03oOuyj4pKQaiatha4NgZ8FVP2IWzCb7RqCszjyU+MxC7H7PpFao/Nri w6hJWyak3hi6PwOJ6DLzOtqsbfZQ+wlsQZna/F5JMSnaxy0pXDVAkZwalXyPxPn7L8ix Xl2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=y6dmFzxP10iUwxXZQtLOu1ATFPmHRCSgNY15RaoJUKY=; b=LfUG/6+8qh83yhJosSD9zwzkhXdDjWqHUp/L/3KNSHWyfCdJorcsZd8CQHlEckjxFz jCiMk2yn3dDyzUdtfSmfK0TwBQdtvpi0Gf3qfzwpMqISEf5dC2mKQG7aBzAuuESqARGl cfpXP735NEx75ip/SFL6QxRUjIjiHzhEfLwCSY96bmiMjRLoanPcG5aLx42B3O2Hfm/7 LhfLjY9Nl0INXJTDTYpTO8QjMlXROXa4mA1dNKDafpAoKD8B+ey30v8RXPN/RiKNCWEO 0HxXacjyOtu8rT+wpzyAgrIK8W6SFHuigtdLVwjHZek8R0uje89FH1ZfgOjMBD7vHKOT mqag== X-Gm-Message-State: AOAM530ExshGKmqDxpNAompV5FcvqdWM9M9CsP/K7cdTUCgdB6wf8FhS DVHTqr0jggbfetZPs3s99Yv6b+8rVfhNtw== X-Google-Smtp-Source: ABdhPJz9Yi/VAaEUz8Z72ora3/ar5pLM8GyxQDQAlPzjbMI9ZNaZTZNvj73vgGEs2zRl/vIj3vD6Mw== X-Received: by 2002:a63:fd0a:: with SMTP id d10mr6930667pgh.405.1615467387807; Thu, 11 Mar 2021 04:56:27 -0800 (PST) Received: from ubuntu.mate (subs03-180-214-233-84.three.co.id. [180.214.233.84]) by smtp.gmail.com with ESMTPSA id o1sm2389418pjp.4.2021.03.11.04.56.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Mar 2021 04:56:27 -0800 (PST) From: Bagas Sanjaya To: git@vger.kernel.org Cc: worldhello.net@gmail.com, Bagas Sanjaya Subject: [PATCH 3/3] po/README: document l10n conventions Date: Thu, 11 Mar 2021 19:55:11 +0700 Message-Id: <20210311125511.51152-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210311125511.51152-1-bagasdotme@gmail.com> References: <20210311125511.51152-1-bagasdotme@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Document things that l10n contributors must folow. Signed-off-by: Bagas Sanjaya --- po/README | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/po/README b/po/README index eda7edf4e6..e1a0494b17 100644 --- a/po/README +++ b/po/README @@ -344,3 +344,24 @@ Below are the usage examples: po-helper.sh check XX.po Run po-helper.sh without arguments for usage help. + + +Conventions +----------- + +There are some conventions that l10n contributors must follow: + + 1. The subject of each commit should be prefixed with `l10n: `. + 2. The length of commit log title (subject) should be less than 50 + characters, and the length of other lines (commit log body) + should be no more than 72 characters. + 3. Add "Signed-off-by" trailer to your commit log, like other + commits in Git. You can automatically add the trailer by + committing with `git commit -s`. + 4. Check syntax with `msgfmt` or `po-helper.sh check` before + committing. + 5. Squash trivial commits to make history clear. + 6. Do NOT edit files outside po/ directory. + 7. Other subsystems ("git-gui", "gitk", and Git itself) have their + own workflow. See Documentation/SubmittingPatches if you want + to make contributions to these subsystems.