From mboxrd@z Thu Jan 1 00:00:00 1970 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=-11.8 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,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 CFEA6C433B4 for ; Wed, 28 Apr 2021 10:10:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 8DAE261424 for ; Wed, 28 Apr 2021 10:10:19 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238381AbhD1KLD (ORCPT ); Wed, 28 Apr 2021 06:11:03 -0400 Received: from mail.loongson.cn ([114.242.206.163]:42536 "EHLO loongson.cn" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S230246AbhD1KK7 (ORCPT ); Wed, 28 Apr 2021 06:10:59 -0400 Received: from localhost.localdomain (unknown [112.3.197.94]) by mail.loongson.cn (Coremail) with SMTP id AQAAf9Cx2cl6NIlgXPUOAA--.24567S2; Wed, 28 Apr 2021 18:10:05 +0800 (CST) From: Yanteng Si To: corbet@lwn.net Cc: Yanteng Si , alexs@kernel.org, chenhuacai@kernel.org, jiaxun.yang@flygoat.com, linux-doc@vger.kernel.org, realpuyuwang@gmail.com, bobwxc@email.cn, siyanteng01@gmail.com, huangjianghui@uniontech.com Subject: [PATCH v4 0/3] docs/zh_CN add three core api docs Date: Wed, 28 Apr 2021 18:10:46 +0800 Message-Id: X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CM-TRANSID: AQAAf9Cx2cl6NIlgXPUOAA--.24567S2 X-Coremail-Antispam: 1UD129KBjvJXoWxAFyUtry8GFWDuF15CFW7Jwb_yoW5WryUpF y7KrWrt3W3GF1Uuwn7W3y8Zr1UWa4xuws8Kay7Xwn5tan8KrW0yw4UKF9Iqasaqr1vqF1F vF43KF98u3yjyrJanT9S1TB71UUUUUUqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUvK14x267AKxVW8JVW5JwAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWrJVCq3wAFIxvE14AKwVWUJVWUGwA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK02 1l84ACjcxK6xIIjxv20xvE14v26ryj6F1UM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4U JVWxJr1l84ACjcxK6I8E87Iv67AKxVW0oVCq3wA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_Gc CE3s1le2I262IYc4CY6c8Ij28IcVAaY2xG8wAqx4xG64xvF2IEw4CE5I8CrVC2j2WlYx0E 2Ix0cI8IcVAFwI0_JrI_JrylYx0Ex4A2jsIE14v26r1j6r4UMcvjeVCFs4IE7xkEbVWUJV W8JwACjcxG0xvY0x0EwIxGrwACjI8F5VA0II8E6IAqYI8I648v4I1lFIxGxcIEc7CjxVA2 Y2ka0xkIwI1lc2xSY4AK67AK6r4DMxAIw28IcxkI7VAKI48JMxC20s026xCaFVCjc4AY6r 1j6r4UMI8I3I0E5I8CrVAFwI0_Jr0_Jr4lx2IqxVCjr7xvwVAFwI0_JrI_JrWlx4CE17CE b7AF67AKxVWUtVW8ZwCIc40Y0x0EwIxGrwCI42IY6xIIjxv20xvE14v26r1j6r1xMIIF0x vE2Ix0cI8IcVCY1x0267AKxVW8JVWxJwCI42IY6xAIw20EY4v20xvaj40_Zr0_Wr1UMIIF 0xvEx4A2jsIE14v26r1j6r4UMIIF0xvEx4A2jsIEc7CjxVAFwI0_Gr0_Gr1UYxBIdaVFxh VjvjDU0xZFpf9x0JUZYFZUUUUU= X-CM-SenderInfo: pvl1t0pwhqwqxorr0wxvrqhubq/ Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org v1 -> v2: * Some bad translations have been modified as suggested by Xiangcheng.Thank you for your review https://lore.kernel.org/linux-doc/cover.1618836460.git.siyanteng@loongson.cn/T/#t * As Matthew and Xiangcheng suggested: call kernel-doc to generate related docs (0001 and 0002).Thanks! I tested it on other computers (at least three) with no problem, But on my computers it prints 1000+ warnings, I tried to find the cause in the past few days but no clue. So, the two patches may print as follows:(maybe your computer won't print anything) linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:235: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:235. Declaration is '.. c:None:: struct list_head *prev'. linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:235: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:235. Declaration is '.. c:None:: struct list_head *next'. linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:235: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:235. Declaration is '.. c:None:: void (*sync)(void)'. linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:283: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:283. Declaration is '.. c:function:: void list_splice_init_rcu(struct list_head *list, struct list_head *head, void (*sync)(void))'. linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:283: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:283. Declaration is '.. c:None:: struct list_head *list'. ... I'm a little skeptical now that something's wrong with my computer. v2 -> v3: * Pick Xiangcheng Wu's review-by tag for [patch 1-3/3] * fix two original links. [1/3 and 3/3] v3 -> v4: Some bad translations have been modified as suggested by Jiaxun. Thank you for your review. Yanteng Si (3): docs/zh_CN: add core-api kernel-api.rst translation docs/zh_CN: add core-api printk-basics.rst translation docs/zh_CN: add core-api printk-formats.rst translation .../translations/zh_CN/core-api/index.rst | 7 +- .../zh_CN/core-api/kernel-api.rst | 385 ++++++++++++ .../zh_CN/core-api/printk-basics.rst | 111 ++++ .../zh_CN/core-api/printk-formats.rst | 580 ++++++++++++++++++ 4 files changed, 1081 insertions(+), 2 deletions(-) create mode 100644 Documentation/translations/zh_CN/core-api/kernel-api.rst create mode 100644 Documentation/translations/zh_CN/core-api/printk-basics.rst create mode 100644 Documentation/translations/zh_CN/core-api/printk-formats.rst -- 2.27.0