The Linux Kernel Mailing List
 help / color / mirror / Atom feed
From: Dongliang Mu <dzm91@hust.edu.cn>
To: Ben Guo <ben.guo@openatom.club>, Alex Shi <alexs@kernel.org>,
	Yanteng Si <si.yanteng@linux.dev>,
	Jonathan Corbet <corbet@lwn.net>
Cc: Gary Guo <gary@garyguo.net>,
	linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
	rust-for-linux@vger.kernel.org,
	hust-os-kernel-patches@googlegroups.com
Subject: Re: [PATCH v2 1/4] docs/zh_CN: Update rust/quick-start.rst translation
Date: Mon, 13 Jul 2026 10:33:58 +0800	[thread overview]
Message-ID: <52e01b13-ff71-414f-8b38-e56d9eb3e166@hust.edu.cn> (raw)
In-Reply-To: <78a525ba7344a334bc70664b34327dbb51024e90.1783905132.git.ben.guo@openatom.club>


On 7/13/26 9:46 AM, Ben Guo wrote:
> Update Documentation/rust/quick-start.rst translation.
>
> Update the translation through commit a4392ed1c8b9
> ("docs: rust: quick-start: remove GDB/Binutils mention")
>
> Reviewed-by: Gary Guo <gary@garyguo.net>
Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> Signed-off-by: Ben Guo <ben.guo@openatom.club>
> ---
>   .../translations/zh_CN/rust/quick-start.rst   | 48 ++++++++-----------
>   1 file changed, 19 insertions(+), 29 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/rust/quick-start.rst b/Documentation/translations/zh_CN/rust/quick-start.rst
> index 5f0ece6411f..0396137f3c1 100644
> --- a/Documentation/translations/zh_CN/rust/quick-start.rst
> +++ b/Documentation/translations/zh_CN/rust/quick-start.rst
> @@ -59,7 +59,7 @@ Fedora Linux 提供较新的 Rust 版本,因此通常开箱即用,例如::
>   Gentoo Linux
>   ************
>   
> -Gentoo Linux(尤其是 testing 分支)提供较新的 Rust 版本,因此通常开箱即用,
> +Gentoo Linux 提供较新的 Rust 版本,因此通常开箱即用,
>   例如::
>   
>   	USE='rust-src rustfmt clippy' emerge dev-lang/rust dev-util/bindgen
> @@ -70,7 +70,7 @@ Gentoo Linux(尤其是 testing 分支)提供较新的 Rust 版本,因此
>   Nix
>   ***
>   
> -Nix(unstable 频道)提供较新的 Rust 版本,因此通常开箱即用,例如::
> +Nix 提供较新的 Rust 版本,因此通常开箱即用,例如::
>   
>   	{ pkgs ? import <nixpkgs> {} }:
>   	pkgs.mkShell {
> @@ -85,16 +85,14 @@ openSUSE
>   openSUSE Slowroll 和 openSUSE Tumbleweed 提供较新的 Rust 版本,因此通常开箱
>   即用,例如::
>   
> -	zypper install rust rust1.79-src rust-bindgen clang
> +	zypper install rust rust-src rust-bindgen clang
>   
>   
>   Ubuntu
>   ******
>   
> -25.04
> -~~~~~
> -
> -最新的 Ubuntu 版本提供较新的 Rust 版本,因此通常开箱即用,例如::
> +Ubuntu 25.10 和 26.04 LTS 提供较新的 Rust 版本,因此通常开箱即用,
> +例如::
>   
>   	apt install rustc rust-src bindgen rustfmt rust-clippy
>   
> @@ -111,32 +109,32 @@ Ubuntu
>   虽然 Ubuntu 24.04 LTS 及更早版本仍然提供较新的 Rust 版本,但它们需要一些额外的配
>   置,使用带版本号的软件包,例如::
>   
> -	apt install rustc-1.80 rust-1.80-src bindgen-0.65 rustfmt-1.80 \
> -		rust-1.80-clippy
> -	ln -s /usr/lib/rust-1.80/bin/rustfmt /usr/bin/rustfmt-1.80
> -	ln -s /usr/lib/rust-1.80/bin/clippy-driver /usr/bin/clippy-driver-1.80
> +	apt install rustc-1.85 rust-1.85-src bindgen-0.71 rustfmt-1.85 \
> +		rust-1.85-clippy
> +	ln -s /usr/lib/rust-1.85/bin/rustfmt /usr/bin/rustfmt-1.85
> +	ln -s /usr/lib/rust-1.85/bin/clippy-driver /usr/bin/clippy-driver-1.85
>   
>   这些软件包都不会将其工具设置为默认值;因此应该显式指定它们,例如::
>   
> -	make LLVM=1 RUSTC=rustc-1.80 RUSTDOC=rustdoc-1.80 RUSTFMT=rustfmt-1.80 \
> -		CLIPPY_DRIVER=clippy-driver-1.80 BINDGEN=bindgen-0.65
> +	make LLVM=1 RUSTC=rustc-1.85 RUSTDOC=rustdoc-1.85 RUSTFMT=rustfmt-1.85 \
> +		CLIPPY_DRIVER=clippy-driver-1.85 BINDGEN=bindgen-0.71
>   
> -或者,修改 ``PATH`` 变量将 Rust 1.80 的二进制文件放在前面,并将 ``bindgen`` 设
> +或者,修改 ``PATH`` 变量将 Rust 1.85 的二进制文件放在前面,并将 ``bindgen`` 设
>   置为默认值,例如::
>   
> -	PATH=/usr/lib/rust-1.80/bin:$PATH
> +	PATH=/usr/lib/rust-1.85/bin:$PATH
>   	update-alternatives --install /usr/bin/bindgen bindgen \
> -		/usr/bin/bindgen-0.65 100
> -	update-alternatives --set bindgen /usr/bin/bindgen-0.65
> +		/usr/bin/bindgen-0.71 100
> +	update-alternatives --set bindgen /usr/bin/bindgen-0.71
>   
> -使用带版本号的软件包时需要设置 ``RUST_LIB_SRC``,例如::
> +使用带版本号的软件包时可能需要设置 ``RUST_LIB_SRC``,例如::
>   
> -	RUST_LIB_SRC=/usr/src/rustc-$(rustc-1.80 --version | cut -d' ' -f2)/library
> +	RUST_LIB_SRC=/usr/src/rustc-$(rustc-1.85 --version | cut -d' ' -f2)/library
>   
>   为方便起见,可以将 ``RUST_LIB_SRC`` 导出到全局环境中。
>   
> -此外, ``bindgen-0.65`` 在较新的版本(24.04 LTS 和 24.10)中可用,但在更早的版
> -本(20.04 LTS 和 22.04 LTS)中可能不可用,因此可能需要手动构建 ``bindgen``
> +此外, ``bindgen-0.71`` 在较新的版本(24.04 LTS)中可用,但在更早的版本
> +(20.04 LTS 和 22.04 LTS)中可能不可用,因此可能需要手动构建 ``bindgen``
>   (请参见下文)。
>   
>   
> @@ -325,11 +323,3 @@ Rust支持(CONFIG_RUST)需要在 ``General setup`` 菜单中启用。在其
>   
>   要想深入了解,请看 ``samples/rust/`` 下的样例源代码、 ``rust/`` 下的Rust支持代码和
>   ``Kernel hacking`` 下的 ``Rust hacking`` 菜单。
> -
> -如果使用的是GDB/Binutils,而Rust符号没有被demangled,原因是工具链还不支持Rust的新v0
> -mangling方案。有几个办法可以解决:
> -
> -- 安装一个较新的版本(GDB >= 10.2, Binutils >= 2.36)。
> -
> -- 一些版本的GDB(例如vanilla GDB 10.1)能够使用嵌入在调试信息(``CONFIG_DEBUG_INFO``)
> -  中的pre-demangled的名字。


  reply	other threads:[~2026-07-13  2:35 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-07-13  1:46 [PATCH v2 0/4] docs/zh_CN: update rust documentation translations Ben Guo
2026-07-13  1:46 ` [PATCH v2 1/4] docs/zh_CN: Update rust/quick-start.rst translation Ben Guo
2026-07-13  2:33   ` Dongliang Mu [this message]
2026-07-13  1:46 ` [PATCH v2 2/4] docs/zh_CN: Update rust/general-information.rst translation Ben Guo
2026-07-13  2:37   ` Dongliang Mu
2026-07-14  3:39     ` Ben Guo
2026-07-13  1:46 ` [PATCH v2 3/4] docs/zh_CN: Update rust/arch-support.rst translation Ben Guo
2026-07-13  2:40   ` Dongliang Mu
2026-07-13  1:46 ` [PATCH v2 4/4] docs/zh_CN: Update rust/testing.rst translation Ben Guo
2026-07-13  2:41   ` Dongliang Mu

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

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

  git send-email \
    --in-reply-to=52e01b13-ff71-414f-8b38-e56d9eb3e166@hust.edu.cn \
    --to=dzm91@hust.edu.cn \
    --cc=alexs@kernel.org \
    --cc=ben.guo@openatom.club \
    --cc=corbet@lwn.net \
    --cc=gary@garyguo.net \
    --cc=hust-os-kernel-patches@googlegroups.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=rust-for-linux@vger.kernel.org \
    --cc=si.yanteng@linux.dev \
    /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.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox