From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f175.google.com (mail-pl1-f175.google.com [209.85.214.175]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4DFC022422E for ; Wed, 24 Sep 2025 23:51:17 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.175 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758757878; cv=none; b=sCy8hm6I/lU41YAp9HBuLTSLS4/i9p+XvSmDdDk8EtGwfuil38qY5KU0oZ8wFdDCXkFikqe43kPuTvA1tFcl/uNcN4NgZfLVNyl/etKLseB2vBi5ppO+FXqY0qnEn0F2KXbfCqdYh0dH4NKVmvKpeWNcMq4urLgrm96r9HiR0Ek= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758757878; c=relaxed/simple; bh=bywdX0nhtg4X6nDuC8jT0AaJN0Y+9epl5eMqmA1AZnc=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=ZpMsFSMlkjx2gamq6sRNNecIimwookDnI79HCYUdkYcIOxRLxRx/oO89LoW62CYrH/1ZkkD9FZiDtitNfeyQYKne0Je73fjcIREGU/A4G9VdsSRQVDo70UGvwfeVwUTZn8TR+EU0Dy15F0INvXxjjoE4vK2ZhYzXe6KvUB4oI5A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=YD4zubMq; arc=none smtp.client-ip=209.85.214.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="YD4zubMq" Received: by mail-pl1-f175.google.com with SMTP id d9443c01a7336-269ba651d06so709025ad.0 for ; Wed, 24 Sep 2025 16:51:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1758757877; x=1759362677; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=BcrUofB0dKCSsQ7o/jnuwGUrQDlTZKMr766pxf4U7ew=; b=YD4zubMqj4y/2E16KpijgN6eCpK8QBLzKiSZYb1fSsk6qzhncDbT/rbQdAJv+HOm85 0/EEG/xP51Q03P/pirH8g/rLFPU8KsF+CFD2CsSA59vkDNk5wIu+lwgs66KUqVGPtIr7 OsJ+ptI45sdzVdEIP8ZpuZO+AdsHMwhmVOkbIw4EvAR/9ts7YZ0mRepPO+QeZbLz/jVN eXec79exBuyuAAdCFIB0SjUPNK4yS294WiF0AsQvacrIJOttlPT2+xJM+UYK7NO1tgAe dpOY9O7hehsil3PU2C+mZb80OXn2smkB8Z+9nqiZFLOag+5kiSEuoN9juzL8xPDrRXL9 OH2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758757877; x=1759362677; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=BcrUofB0dKCSsQ7o/jnuwGUrQDlTZKMr766pxf4U7ew=; b=ProSuH3abQwyxQvAc3up/bQfTqJoZfqlHEIlhxdHp2qYNheGGRoZDjr1VJZcvRQYrt dwwG5OzreFRjcAtP5cwIRmfH8uv9APzhE/Bm0GJNB685T732ljMGtANOTjq+4/Vf36Pd J4TuYvmE4yqvQ672hAEwMoGxLo1muFRT0JkaxnI8zBxLLcALkgvjjLyfCrwCahjBXo+R Yk8aNbmckXfBUodefzVGFwaq8zygtDZkhpuvbbCOnlHI2bKwEb9b+ISC6yGwTykjHlDB cnDJre2X91aSpzZNmv8unoXtc+Z8YowZWOFox36toFBKz4njgCvkwj3sqY114UFkrNvL e0XQ== X-Forwarded-Encrypted: i=1; AJvYcCUgosLi7Sxkw6givTHMijFcz8C0aKm2JnyV1nxPEAXrxfgBO0LKyAB0IL1vFS5I+a0qgvk6dBmTV1vppIk=@vger.kernel.org X-Gm-Message-State: AOJu0YzmSaZhSz0IxIZ20phLNT9dZ5UZQPCAeuZXcuU4AL3ZeWP0H7KI FZTVX5Z/BE3Nn3065nRqAKr0n5RQgsbsFrQnMM+ITuy+Zqo5StAo91HV X-Gm-Gg: ASbGncsZeefoShB3Ht+YYfgTXE6vXAQpM/3fjkkBc+0EcAI6K/BeKD5+tMw3/00165Y zCJRDkWXWyWmCpwi+jaa/5Nq27sQsGRApvoeVs76uttvw/A2GJGY6JP9HFLuhlMCjiYlVP1JHym eE+iNORQ+JJCnX4h789ypzl1L1zr22xl8Nz5Gy0Pi07hc7vX5hXWXghQQF3LReBSrlYkhiDekKs /Jd8mktTdIKynKaZCKuTEGNUab/fPbQFPQB0wbEsmhm0o7fD6iwYebnDfqUTaRjPGENCZ0duado UrxIqLtz/nNVtjDQ2CfzLTUqZaMigxN7wD/hRwUYgD7qotMb4ah9yr8D+U78hupfzLDPe3JLMfS 0j6uqJ3D6a3cf4r/cuDI= X-Google-Smtp-Source: AGHT+IF5/ZHYCLfHMWUKUiXIO0yoi5GrlItBDfQAqCKn6V4VH3FNSKCX4czQoTpWgFwCnc41W0qgng== X-Received: by 2002:a17:902:e812:b0:266:914a:2e7a with SMTP id d9443c01a7336-27ed4a7e84amr9318595ad.6.1758757876373; Wed, 24 Sep 2025 16:51:16 -0700 (PDT) Received: from localhost ([104.249.174.141]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-27ed69bc273sm4296695ad.124.2025.09.24.16.51.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Sep 2025 16:51:15 -0700 (PDT) From: Ben Guo To: alexs@kernel.org, si.yanteng@linux.dev, dzm91@hust.edu.cn, corbet@lwn.net, ojeda@kernel.org, alex.gaynor@gmail.com, boqun.feng@gmail.com, gary@garyguo.net, bjorn3_gh@protonmail.com, lossin@kernel.org, a.hindborg@kernel.org, aliceryhl@google.com, tmgross@umich.edu, dakr@kernel.org Cc: hust-os-kernel-patches@googlegroups.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, rust-for-linux@vger.kernel.org Subject: [PATCH] docs/zh_CN: Update Rust index translation and add reference label Date: Wed, 24 Sep 2025 23:51:12 +0000 Message-ID: <20250924235114.209967-1-benx.guo@gmail.com> X-Mailer: git-send-email 2.43.0 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: 8bit Update the translated rust/index.rst with new contents, and add a reference label in rust/general-information.rst so that index.rst can link to it properly. Fixes in rust/index.rst: - Fixed broken quick-start.rst cross-reference Update the translation through commit d0b343605f1b ("kernel-docs: Add new section for Rust learning materials") Signed-off-by: Ben Guo --- .../zh_CN/rust/general-information.rst | 1 + .../translations/zh_CN/rust/index.rst | 32 ++++++++++++++++++- 2 files changed, 32 insertions(+), 1 deletion(-) diff --git a/Documentation/translations/zh_CN/rust/general-information.rst b/Documentation/translations/zh_CN/rust/general-information.rst index 251f6ee2bb44..9b5e37e13f38 100644 --- a/Documentation/translations/zh_CN/rust/general-information.rst +++ b/Documentation/translations/zh_CN/rust/general-information.rst @@ -13,6 +13,7 @@ 本文档包含了在内核中使用Rust支持时需要了解的有用信息。 +.. _rust_code_documentation_zh_cn: 代码文档 -------- diff --git a/Documentation/translations/zh_CN/rust/index.rst b/Documentation/translations/zh_CN/rust/index.rst index b01f887e7167..10413b0c17c0 100644 --- a/Documentation/translations/zh_CN/rust/index.rst +++ b/Documentation/translations/zh_CN/rust/index.rst @@ -10,7 +10,35 @@ Rust ==== -与内核中的Rust有关的文档。若要开始在内核中使用Rust,请阅读quick-start.rst指南。 +与内核中的Rust有关的文档。若要开始在内核中使用Rust,请阅读 quick-start.rst 指南。 + +Rust 实验 +--------- +Rust 支持在 v6.1 版本中合并到主线,以帮助确定 Rust 作为一种语言是否适合内核, +即是否值得进行权衡。 + +目前,Rust 支持主要面向对 Rust 支持感兴趣的内核开发人员和维护者, +以便他们可以开始处理抽象和驱动程序,并帮助开发基础设施和工具。 + +如果您是终端用户,请注意,目前没有适合或旨在生产使用的内置驱动程序或模块, +并且 Rust 支持仍处于开发/实验阶段,尤其是对于特定内核配置。 + +代码文档 +-------- + +给定一个内核配置,内核可能会生成 Rust 代码文档,即由 ``rustdoc`` 工具呈现的 HTML。 + +.. only:: rustdoc and html + + 该内核文档使用 `Rust 代码文档 `_ 构建。 + +.. only:: not rustdoc and html + + 该内核文档不使用 Rust 代码文档构建。 + +预生成版本提供在:https://rust.docs.kernel.org。 + +请参阅 :ref:`代码文档 ` 部分以获取更多详细信息。 .. toctree:: :maxdepth: 1 @@ -20,6 +48,8 @@ Rust coding-guidelines arch-support +你还可以在 :doc:`../../../process/kernel-docs` 中找到 Rust 的学习材料。 + .. only:: subproject and html Indices -- 2.43.0