From nobody Fri Dec 26 09:16:36 2025 Received: from mout01.posteo.de (mout01.posteo.de [185.67.36.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E1DC954736 for ; Mon, 8 Jan 2024 16:16:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.net header.i=@posteo.net header.b="CAaevBH3" Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 41B6A240028 for ; Mon, 8 Jan 2024 17:16:52 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1704730612; bh=FSKcWsQ5mtlwkCpoTpXGMOT6OsAb8LvcvEc/sUGr2VU=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version: Content-Transfer-Encoding:From; b=CAaevBH3V6YyG0d8ShmWsQfffeLzQeCzOuqDjG3fTJ5UP16tN/extBLKsb1kyHN8E RWjsOvPT1fIHR5kRDbF8LwgpoZXSyH0yCVjlfDEVr4Co83FsQ/evQqMbhEQBvSqpz3 wK5/PxtRlDUdYby8ytb0+7CR1KUYzyIXXspo6EQbTNjzl2/nXjGqQGm0hSnNHG8Sae WykSkkO1Cv967G7diIZ4d9/KD8JzlbZkIAmPl4UlRGyTUlboTVY1SuWQLZzFSNVlJJ KV5NuCegkufYWrRfbz+Gm0qDekkpjx1QTTBw3rqC1kc/PUKNuro/Ta0Eg/FgGWWD8K 9+Uddbnyj3enw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4T7zhx4HD5z9rxF; Mon, 8 Jan 2024 17:16:49 +0100 (CET) From: Yueh-Shun Li To: Alex Shi , Yanteng Si Cc: Yueh-Shun Li , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/4] doc/zh_CN: coding-style: update content of section 18 Date: Mon, 8 Jan 2024 16:03:25 +0000 Message-ID: <20240108160746.177421-5-shamrocklee@posteo.net> In-Reply-To: <20240108160746.177421-1-shamrocklee@posteo.net> References: <107b6b5e-ca14-4b2b-ba2e-38ecd74c0ad3@infradead.org> <20240108160746.177421-1-shamrocklee@posteo.net> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Update the content of the zh_CN translation of "Linux kernel coding style" section 18, following the change proposed in the first 2 patches in these patch series. As a zh_TW speaker, I tried my best to compare and proofread the content generated with OpenCC[1] with tw2s and tw2sp configurations, and existing translation in the same file. Please kindly point out anything I should fix. [1]: https://github.com/BYVoid/OpenCC Signed-off-by: Yueh-Shun Li --- .../zh_CN/process/coding-style.rst | 39 +++++++++++++++---- 1 file changed, 31 insertions(+), 8 deletions(-) diff --git a/Documentation/translations/zh_CN/process/coding-style.rst b/Do= cumentation/translations/zh_CN/process/coding-style.rst index fa28ef0a7fee..14ff3cdc2d0d 100644 --- a/Documentation/translations/zh_CN/process/coding-style.rst +++ b/Documentation/translations/zh_CN/process/coding-style.rst @@ -919,25 +919,48 @@ Linux=E5=86=85=E6=A0=B8=E5=B8=83=E5=B0=94=EF=BC=88boo= l=EF=BC=89=E7=B1=BB=E5=9E=8B=E6=98=AFC99 _Bool=E7=B1=BB=E5=9E=8B=E7=9A=84= =E5=88=AB=E5=90=8D=E3=80=82=E5=B8=83=E5=B0=94=E5=80=BC=E5=8F=AA=E8=83=BD =20 =E6=80=BB=E4=B9=8B=EF=BC=8C=E5=9C=A8=E7=BB=93=E6=9E=84=E4=BD=93=E5=92=8C= =E5=8F=82=E6=95=B0=E4=B8=AD=E6=9C=89=E9=99=90=E5=9C=B0=E4=BD=BF=E7=94=A8=E5= =B8=83=E5=B0=94=E5=8F=AF=E4=BB=A5=E6=8F=90=E9=AB=98=E5=8F=AF=E8=AF=BB=E6=80= =A7=E3=80=82 =20 + 18) =E4=B8=8D=E8=A6=81=E9=87=8D=E6=96=B0=E5=8F=91=E6=98=8E=E5=86=85=E6=A0= =B8=E5=AE=8F ---------------------- =20 -=E5=A4=B4=E6=96=87=E4=BB=B6 include/linux/kernel.h =E5=8C=85=E5=90=AB=E4= =BA=86=E4=B8=80=E4=BA=9B=E5=AE=8F=EF=BC=8C=E4=BD=A0=E5=BA=94=E8=AF=A5=E4=BD= =BF=E7=94=A8=E5=AE=83=E4=BB=AC=EF=BC=8C=E8=80=8C=E4=B8=8D=E8=A6=81=E8=87=AA= =E5=B7=B1=E5=86=99=E4=B8=80=E4=BA=9B -=E5=AE=83=E4=BB=AC=E7=9A=84=E5=8F=98=E7=A7=8D=E3=80=82=E6=AF=94=E5=A6=82= =EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E9=9C=80=E8=A6=81=E8=AE=A1=E7=AE=97=E4= =B8=80=E4=B8=AA=E6=95=B0=E7=BB=84=E7=9A=84=E9=95=BF=E5=BA=A6=EF=BC=8C=E4=BD= =BF=E7=94=A8=E8=BF=99=E4=B8=AA=E5=AE=8F +``include/linux`` =E7=9B=AE=E5=BD=95=E4=B8=8B=E7=9A=84=E5=A4=B4=E6=96=87= =E4=BB=B6=E6=8F=90=E4=BE=9B=E4=BA=86=E4=B8=80=E4=BA=9B=E5=AE=8F=EF=BC=8C=E4= =BD=A0=E5=BA=94=E8=AF=A5=E4=BD=BF=E7=94=A8=E5=AE=83=E4=BB=AC=EF=BC=8C=E8=80= =8C=E4=B8=8D=E8=A6=81=E8=87=AA=E5=B7=B1=E5=86=99 +=E4=B8=80=E4=BA=9B=E5=AE=83=E4=BB=AC=E7=9A=84=E5=8F=98=E7=A7=8D=E3=80=82= =E6=AF=94=E5=A6=82=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E9=9C=80=E8=A6=81=E8= =AE=A1=E7=AE=97=E4=B8=80=E4=B8=AA=E6=95=B0=E7=BB=84=E7=9A=84=E9=95=BF=E5=BA= =A6=EF=BC=8C=E4=BD=BF=E7=94=A8 +``include/linux/array_size.h`` =E6=8F=90=E4=BE=9B=E7=9A=84 ``ARRAY_SIZE()`= ` =E5=AE=8F =20 .. code-block:: c =20 - #define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0])) + #include + ARRAY_SIZE(x) // The size of array x + +=E7=B1=BB=E4=BC=BC=E7=9A=84=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E8=A6=81= =E8=AE=A1=E7=AE=97=E6=9F=90=E7=BB=93=E6=9E=84=E4=BD=93=E6=88=90=E5=91=98=E7= =9A=84=E5=A4=A7=E5=B0=8F=EF=BC=8C=E4=BD=BF=E7=94=A8 ``include/linux/stddef.= h`` =E5=BD=93 +=E4=B8=AD=E7=9A=84 ``sizeof_field()`` =E5=AE=8F=E3=80=82 + +=E8=BF=98=E6=9C=89 ``include/linux/minmax.h`` =E6=8F=90=E4=BE=9B=E8=83=BD= =E5=81=9A=E4=B8=A5=E6=A0=BC=E7=9A=84=E7=B1=BB=E5=9E=8B=E6=A3=80=E6=9F=A5=E7= =9A=84 ``min()`` =E5=92=8C +``max()`` =E5=AE=8F=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E9=9C=80=E8=A6=81= =E5=8F=AF=E4=BB=A5=E4=BD=BF=E7=94=A8=E5=AE=83=E4=BB=AC=E3=80=82 =20 -=E7=B1=BB=E4=BC=BC=E7=9A=84=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E8=A6=81= =E8=AE=A1=E7=AE=97=E6=9F=90=E7=BB=93=E6=9E=84=E4=BD=93=E6=88=90=E5=91=98=E7= =9A=84=E5=A4=A7=E5=B0=8F=EF=BC=8C=E4=BD=BF=E7=94=A8 +=E4=BD=BF=E7=94=A8=E5=85=B1=E7=94=A8=E5=A4=B4=E6=96=87=E4=BB=B6=E6=89=80= =E6=8F=90=E4=BE=9B=E7=9A=84=E5=AE=8F=E4=B9=9F=E8=83=BD=E9=81=BF=E5=85=8D=E5= =91=BD=E5=90=8D=E5=86=B2=E7=AA=81=E3=80=82=E6=AF=94=E5=A6=82=E8=AF=B4=EF=BC= =8C=E5=A6=82=E6=9E=9C=E6=9C=89=E4=B8=AA=E5=BC=80=E5=8F=91=E8=80=85=E5=9C=A8= =E5=A4=B4=E6=96=87=E4=BB=B6 +``foo.h`` =E4=B8=AD=E5=AE=9A=E4=B9=89=E4=BA=86 =20 .. code-block:: c =20 - #define sizeof_field(t, f) (sizeof(((t*)0)->f)) + #define __stringify(x) __stringify_1(x) + #define __stringify_1(x) #x + +=E4=BD=86=E5=8F=A6=E4=B8=80=E4=B8=AA=E5=BC=80=E5=8F=91=E8=80=85=E5=9C=A8= =E5=A4=B4=E6=96=87=E4=BB=B6 ``bar.h`` =E4=B8=AD=E5=AE=9A=E4=B9=89=E4=BA=86 + +.. code-block:: c + + #define stringify(x) __stringify(x) + #define __stringify(x) #x + +=E5=BD=93=E4=B8=A4=E4=B8=AA=E5=A4=B4=E6=96=87=E4=BB=B6=E9=83=BD=E8=A2=AB `= `#include`` =E8=BF=9B=E5=90=8C=E4=B8=80=E4=BB=BD=E6=96=87=E4=BB=B6=EF=BC=8C= ``foo.h`` =E6=8F=90=E4=BE=9B=E7=9A=84=E5=B7=A5=E5=85=B7=E5=8F=AF=E8=83=BD= =E4=BC=9A=E8=A2=AB +``bar.h`` =E7=A0=B4=E5=9D=8F=E3=80=82 + +=E5=A6=82=E6=9E=9C=E4=B8=A4=E4=B8=AA=E5=A4=B4=E6=96=87=E4=BB=B6=E9=83=BD= =E4=BD=BF=E7=94=A8 ``include/linux/stringify.h`` =E6=8F=90=E4=BE=9B=E7=9A= =84 ``__stringify()`` +=E5=AE=8F=EF=BC=8C=E5=B0=B1=E4=B8=8D=E4=BC=9A=E4=BA=92=E7=9B=B8=E5=B9=B2= =E6=89=B0=E4=BA=86=E3=80=82 =20 -=E8=BF=98=E6=9C=89=E5=8F=AF=E4=BB=A5=E5=81=9A=E4=B8=A5=E6=A0=BC=E7=9A=84= =E7=B1=BB=E5=9E=8B=E6=A3=80=E6=9F=A5=E7=9A=84 min() =E5=92=8C max() =E5=AE= =8F=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E9=9C=80=E8=A6=81=E5=8F=AF=E4=BB=A5= =E4=BD=BF=E7=94=A8=E5=AE=83=E4=BB=AC=E3=80=82=E4=BD=A0=E5=8F=AF=E4=BB=A5 -=E8=87=AA=E5=B7=B1=E7=9C=8B=E7=9C=8B=E9=82=A3=E4=B8=AA=E5=A4=B4=E6=96=87= =E4=BB=B6=E9=87=8C=E8=BF=98=E5=AE=9A=E4=B9=89=E4=BA=86=E4=BB=80=E4=B9=88=E4= =BD=A0=E5=8F=AF=E4=BB=A5=E6=8B=BF=E6=9D=A5=E7=94=A8=E7=9A=84=E4=B8=9C=E8=A5= =BF=EF=BC=8C=E5=A6=82=E6=9E=9C=E6=9C=89=E5=AE=9A=E4=B9=89=E7=9A=84=E8=AF=9D= =EF=BC=8C=E4=BD=A0=E5=B0=B1=E4=B8=8D=E5=BA=94 -=E5=9C=A8=E4=BD=A0=E7=9A=84=E4=BB=A3=E7=A0=81=E9=87=8C=E8=87=AA=E5=B7=B1= =E9=87=8D=E6=96=B0=E5=AE=9A=E4=B9=89=E3=80=82 +=E4=BD=A0=E5=8F=AF=E4=BB=A5=E8=87=AA=E5=B7=B1=E6=90=9C=E7=B4=A2=E3=80=81= =E7=9C=8B=E7=9C=8B=E9=82=A3=E4=BA=9B=E5=A4=B4=E6=96=87=E4=BB=B6=E9=87=8C=E8= =BF=98=E5=AE=9A=E4=B9=89=E4=BA=86=E4=BB=80=E4=B9=88=E4=BD=A0=E5=8F=AF=E4=BB= =A5=E6=8B=BF=E6=9D=A5=E7=94=A8=E7=9A=84=E4=B8=9C=E8=A5=BF=EF=BC=8C=E5=A6=82= =E6=9E=9C=E6=9C=89=E5=AE=9A=E4=B9=89=E7=9A=84 +=E8=AF=9D=EF=BC=8C=E4=BD=A0=E5=B0=B1=E4=B8=8D=E5=BA=94=E5=9C=A8=E4=BD=A0= =E7=9A=84=E4=BB=A3=E7=A0=81=E9=87=8C=E8=87=AA=E5=B7=B1=E9=87=8D=E6=96=B0=E5= =AE=9A=E4=B9=89=E3=80=82 =20 =20 19) =E7=BC=96=E8=BE=91=E5=99=A8=E6=A8=A1=E5=BC=8F=E8=A1=8C=E5=92=8C=E5=85= =B6=E4=BB=96=E9=9C=80=E8=A6=81=E7=BD=97=E5=97=A6=E7=9A=84=E4=BA=8B=E6=83=85 --=20 2.42.0