From: Weijie Yuan <wy@wyuan.org>
To: Dongliang Mu <dzm91@hust.edu.cn>
Cc: Siwei Chen <anka@stu.cdut.edu.cn>,
alexs@kernel.org, si.yanteng@linux.dev, corbet@lwn.net,
skhan@linuxfoundation.org, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org, Siwei Chen <businiaoanka@anka1.top>
Subject: Re: [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
Date: Fri, 21 Aug 2026 22:48:11 +0800 [thread overview]
Message-ID: <aohlK3T3_sCK9E1_@wyuan.org> (raw)
In-Reply-To: <7724c093-cb99-490d-b632-1381e16962ff@hust.edu.cn>
On Fri, Aug 21, 2026 at 09:34:59PM +0800, Dongliang Mu wrote:
> > +强烈建议现代网卡专注于实现 ``switchdev`` 模型（参见 :ref:`switchdev`）
>
> The compilation complains this switchdev reference. This documentation has
> no translation in the same directory:
>
> Documentation/translations/zh_CN/networking/sriov.rst:15:
> WARNING: undefined label: 'switchdev' [ref.ref]
[on the tip of alexs/docs-next]
user@debian:~/Projects/linux$ b4 shazam https://lore.kernel.org/linux-doc/20260817021340.17318-1-anka@stu.cdut.edu.cn/
Looking up https://lore.kernel.org/all/20260817021340.17318-1-anka@stu.cdut.edu.cn/
Grabbing thread from lore.kernel.org/all/20260817021340.17318-1-anka@stu.cdut.edu.cn/t.mbox.gz
Checking for newer revisions
Grabbing search results from lore.kernel.org
Analyzing 19 messages in the thread
Looking for additional code-review trailers on lore.kernel.org
Analyzing 22 code-review messages
Checking attestation on all messages, may take a moment...
---
✗ [PATCH v4 1/5] docs/zh_CN: Add networking team documentation Chinese translation
+ Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
+ Reviewed-by: Weijie Yuan <wy@wyuan.org> (✗ DKIM/wyuan.org)
✗ [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
+ Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
+ Reviewed-by: Weijie Yuan <wy@wyuan.org> (✗ DKIM/wyuan.org)
✗ [PATCH v4 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation
+ Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
+ Reviewed-by: Weijie Yuan <wy@wyuan.org> (✗ DKIM/wyuan.org)
✗ [PATCH v4 4/5] docs/zh_CN: Add ipv6 Chinese translation
+ Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
+ Reviewed-by: Weijie Yuan <wy@wyuan.org> (✗ DKIM/wyuan.org)
✗ [PATCH v4 5/5] docs/zh_CN: Add LSM/SeLinux secid Chinese translation
+ Acked-by: Weijie Yuan <wy@wyuan.org> (✗ DKIM/wyuan.org)
---
✗ BADSIG: DKIM/stu.cdut.edu.cn
---
Total patches: 5
---
Applying: docs/zh_CN: Add networking team documentation Chinese translation
Applying: docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
Applying: docs/zh_CN: Add Softnet Driver Issues Chinese translation
Applying: docs/zh_CN: Add ipv6 Chinese translation
Applying: docs/zh_CN: Add LSM/SeLinux secid Chinese translation
user@debian:~/Projects/linux$ . sphinx_latest/bin/activate
(sphinx_latest) user@debian:~/Projects/linux$ make cleandocs
(sphinx_latest) user@debian:~/Projects/linux$ make -j2 htmldocs
Using alabaster theme
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/os_mode is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:364; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:234
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/os_mode_index is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:373; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:243
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/touchpad/enabled is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:636; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:252
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/touchpad/enabled_index is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:645; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:261
Documentation/ABI/testing/sysfs-class-power-bd71828:1: ERROR: Malformed table.
No bottom table border found.
============ ===========================================
1 automatic adjustment of input current limit
0 no adjustment of input current limit. This
helps for more unusual power sources like
solar modules. [docutils]
WARNING: ./security/landlock/ruleset.h:48 Excess struct member 'quiet' description in 'landlock_layer'
WARNING: ./security/landlock/ruleset.h:48 Excess struct member 'quiet' description in 'landlock_layer'
WARNING: ./include/net/page_pool/types.h:105 Excess struct member 'fast' description in 'page_pool_params'
WARNING: ./include/net/page_pool/types.h:105 Excess struct member 'slow' description in 'page_pool_params'
WARNING: ./include/linux/damon.h:909 struct member 'probes' not described in 'damon_ctx'
WARNING: ./include/linux/damon.h:909 struct member 'rnd_state' not described in 'damon_ctx'
WARNING: ./include/linux/damon.h:909 struct member 'probes' not described in 'damon_ctx'
WARNING: ./include/linux/damon.h:909 struct member 'rnd_state' not described in 'damon_ctx'
/home/user/Projects/linux/Documentation/hwmon/ltc4283.rst:261: ERROR: Malformed table.
Text in column margin in table line 3.
======================= ==========================================
power1_failed_fault_log Set to 1 by a power1 fault occurring.
power1_good_input_fault_log Set to 1 by a power1 good input fault occurring at PGIO3.
in11_fet_short_fault_log Set to 1 when a FET-short fault occurs.
in11_fet_bad_fault_log Set to 1 when a FET-BAD fault occurs.
in0_lcrit_fault_log Set to 1 by a VIN undervoltage fault occurring.
in0_crit_fault_log Set to 1 by a VIN overvoltage fault occurring.
curr1_crit_fault_log Set to 1 by an overcurrent fault occurring.
======================= ========================================== [docutils]
WARNING: ./include/linux/netfs.h:764 function parameter 'ictx' not described in 'netfs_resize_file'
WARNING: ./include/linux/netfs.h:764 Excess function parameter 'ctx' description in 'netfs_resize_file'
WARNING: ./include/linux/netfs.h:764 function parameter 'ictx' not described in 'netfs_resize_file'
WARNING: ./include/linux/netfs.h:764 Excess function parameter 'ctx' description in 'netfs_resize_file'
/home/user/Projects/linux/Documentation/firmware-guide/acpi/dsd/motorcomm-yt8xxx-phy.rst:70: ERROR: Unexpected indentation. [docutils]
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'power_module' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'hdmi_frl_status_polling_wq' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'hdmi_frl_status_polling_delay_ms' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'boot_time_crc_info' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 Excess struct member 'dm_boot_time_crc_info' description in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'power_module' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'hdmi_frl_status_polling_wq' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'hdmi_frl_status_polling_delay_ms' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 struct member 'boot_time_crc_info' not described in 'amdgpu_display_manager'
WARNING: ./drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:721 Excess struct member 'dm_boot_time_crc_info' description in 'amdgpu_display_manager'
/home/user/Projects/linux/Documentation/gpu/driver-uapi:31: ./include/uapi/drm/xe_drm.h:2537: ERROR: A level 2 section cannot be used here.
Node Registration
=================
Established title styles: =/= = -
The parent of level 2 sections cannot be reached. The parser is at section level 2 but the current node has only 0 parent section(s).
One reason may be a high level section used in a directive that parses its content into a base node not attached to the document
(up to Docutils 0.21, these sections were silently dropped). [docutils]
/home/user/Projects/linux/Documentation/gpu/driver-uapi:31: ./include/uapi/drm/xe_drm.h:2544: ERROR: A level 2 section cannot be used here.
Error Classification
====================
Established title styles: =/= = -
The parent of level 2 sections cannot be reached. The parser is at section level 2 but the current node has only 0 parent section(s).
One reason may be a high level section used in a directive that parses its content into a base node not attached to the document
(up to Docutils 0.21, these sections were silently dropped). [docutils]
/home/user/Projects/linux/Documentation/gpu/driver-uapi:31: ./include/uapi/drm/xe_drm.h:2551: ERROR: A level 2 section cannot be used here.
User Interface
==============
Established title styles: =/= = -
The parent of level 2 sections cannot be reached. The parser is at section level 2 but the current node has only 0 parent section(s).
One reason may be a high level section used in a directive that parses its content into a base node not attached to the document
(up to Docutils 0.21, these sections were silently dropped). [docutils]
/home/user/Projects/linux/Documentation/gpu/drm-kms:302: ./drivers/gpu/drm/drm_atomic.c:1761: WARNING: Duplicate C declaration, also defined at gpu/drm-kms:405.
Declaration is '.. c:function:: int drm_atomic_commit (struct drm_atomic_commit *state)'. [duplicate_declaration.c]
/home/user/Projects/linux/Documentation/gpu/drm-kms:365: ./drivers/gpu/drm/drm_fourcc.c:408: WARNING: Duplicate C declaration, also defined at gpu/drm-kms:35.
Declaration is '.. c:function:: const struct drm_format_info * drm_format_info (u32 format)'. [duplicate_declaration.c]
/home/user/Projects/linux/Documentation/gpu/drm-kms:496: ./drivers/gpu/drm/drm_modeset_lock.c:377: WARNING: Duplicate C declaration, also defined at gpu/drm-kms:48.
Declaration is '.. c:function:: int drm_modeset_lock (struct drm_modeset_lock *lock, struct drm_modeset_acquire_ctx *ctx)'. [duplicate_declaration.c]
WARNING: ./include/drm/display/drm_dp_helper.h:129 struct member 'coasting_vtotal' not described in 'drm_dp_as_sdp'
WARNING: ./include/drm/display/drm_dp_helper.h:129 struct member 'coasting_vtotal' not described in 'drm_dp_as_sdp'
WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:174 expecting prototype for __drm_gem_shmem_release_sgt_locked(). Prototype was for __drm_gem_shmem_free_sgt_locked() instead
WARNING: ./drivers/gpu/buddy.c:1484 Excess function parameter 'p' description in 'gpu_buddy_print'
WARNING: ./include/drm/drm_exec.h:157 function parameter '_exec' not described in 'drm_exec_retry'
WARNING: ./include/drm/drm_exec.h:157 Excess function parameter 'exec' description in 'drm_exec_retry'
WARNING: ./include/drm/drm_exec.h:157 function parameter '_exec' not described in 'drm_exec_retry'
WARNING: ./include/drm/drm_exec.h:157 Excess function parameter 'exec' description in 'drm_exec_retry'
/home/user/Projects/linux/Documentation/gpu/drm-uapi:613: ./drivers/gpu/drm/drm_ioctl.c:924: WARNING: Duplicate C declaration, also defined at gpu/drm-uapi:69.
Declaration is '.. c:function:: bool drm_ioctl_flags (unsigned int nr, unsigned int *flags)'. [duplicate_declaration.c]
WARNING: ./include/linux/host1x.h:159 struct member 'get' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'put' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'mmap' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'munmap' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'get' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'put' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'mmap' not described in 'host1x_bo_ops'
WARNING: ./include/linux/host1x.h:159 struct member 'munmap' not described in 'host1x_bo_ops'
/home/user/Projects/linux/Documentation/gpu/xe/xe_mm:22: ./drivers/gpu/drm/xe/xe_ggtt.c:125: ERROR: Unexpected indentation. [docutils]
WARNING: ./drivers/usb/dwc3/core.h:803 Excess struct member 'regs' description in 'dwc3_ep'
WARNING: ./drivers/usb/dwc3/core.h:803 Excess struct member 'regs' description in 'dwc3_ep'
WARNING: ./fs/inode.c:1303 Excess function parameter 'isnew' description in 'inode_insert5'
/home/user/Projects/linux/Documentation/driver-api/target:25: ./drivers/target/target_core_user.c:35: ERROR: Unexpected section title.
Userspace I/O
------------- [docutils]
/home/user/Projects/linux/Documentation/driver-api/target:28: ./include/uapi/linux/target_core_user.h:14: ERROR: Unexpected section title.
Ring Design
----------- [docutils]
WARNING: ./include/linux/device.h:117 struct member 'show_const' not described in 'device_attribute'
WARNING: ./include/linux/device.h:117 struct member 'store_const' not described in 'device_attribute'
WARNING: ./include/linux/dma-fence-array.h:47 Excess struct member 'lock' description in 'dma_fence_array'
WARNING: ./include/linux/dma-fence-array.h:47 Excess struct member 'lock' description in 'dma_fence_array'
WARNING: ./include/linux/dma-fence-chain.h:48 Excess struct member 'lock' description in 'dma_fence_chain'
WARNING: ./include/linux/dma-fence-chain.h:48 Excess struct member 'lock' description in 'dma_fence_chain'
WARNING: ./include/linux/device.h:117 struct member 'show_const' not described in 'device_attribute'
WARNING: ./include/linux/device.h:117 struct member 'store_const' not described in 'device_attribute'
WARNING: ./include/media/media-entity.h:1394 function parameter 'args' not described in 'media_entity_call'
WARNING: ./include/media/media-entity.h:1394 function parameter 'args' not described in 'media_entity_call'
/home/user/Projects/linux/Documentation/driver-api/basics:42: ./kernel/time/time.c:370: WARNING: Duplicate C declaration, also defined at driver-api/basics:436.
Declaration is '.. c:function:: unsigned int jiffies_to_msecs (const unsigned long j)'. [duplicate_declaration.c]
/home/user/Projects/linux/Documentation/driver-api/basics:42: ./kernel/time/time.c:393: WARNING: Duplicate C declaration, also defined at driver-api/basics:453.
Declaration is '.. c:function:: unsigned int jiffies_to_usecs (const unsigned long j)'. [duplicate_declaration.c]
WARNING: ./block/blk-map.c:366 Excess function parameter 'op' description in 'bio_copy_kern'
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/os_mode is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:364; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:234
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/os_mode_index is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:373; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:243
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/touchpad/enabled is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:636; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:252
WARNING: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/touchpad/enabled_index is defined 2 times: /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go:645; /home/user/Projects/linux/Documentation/ABI/testing/sysfs-driver-hid-lenovo-go-s:261
Weird, no such error found. Did I do something stupid? Thinking..
next prev parent reply other threads:[~2026-08-21 14:48 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-17 2:13 [PATCH v4 0/5] docs/zh_CN: Add Chinese translations for five networking documents Siwei Chen
2026-08-17 2:13 ` [PATCH v4 1/5] docs/zh_CN: Add networking team documentation Chinese translation Siwei Chen
2026-08-20 6:43 ` Weijie Yuan
2026-08-21 13:10 ` Dongliang Mu
2026-08-17 2:13 ` [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs " Siwei Chen
2026-08-20 6:43 ` Weijie Yuan
2026-08-21 13:10 ` Dongliang Mu
2026-08-21 13:34 ` Dongliang Mu
2026-08-21 14:25 ` Weijie Yuan
2026-08-21 14:48 ` Weijie Yuan [this message]
2026-08-24 4:06 ` 不死鸟Anka
2026-08-17 2:13 ` [PATCH v4 3/5] docs/zh_CN: Add Softnet Driver Issues " Siwei Chen
2026-08-20 6:43 ` Weijie Yuan
2026-08-21 13:11 ` Dongliang Mu
2026-08-17 2:13 ` [PATCH v4 4/5] docs/zh_CN: Add ipv6 " Siwei Chen
2026-08-20 6:43 ` Weijie Yuan
2026-08-21 13:11 ` Dongliang Mu
2026-08-17 2:13 ` [PATCH v4 5/5] docs/zh_CN: Add LSM/SeLinux secid " Siwei Chen
2026-08-20 6:43 ` Weijie Yuan
2026-08-21 13:29 ` Dongliang Mu
2026-08-21 14:07 ` Weijie Yuan
2026-08-24 4:10 ` Siwei Chen
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=aohlK3T3_sCK9E1_@wyuan.org \
--to=wy@wyuan.org \
--cc=alexs@kernel.org \
--cc=anka@stu.cdut.edu.cn \
--cc=businiaoanka@anka1.top \
--cc=corbet@lwn.net \
--cc=dzm91@hust.edu.cn \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=si.yanteng@linux.dev \
--cc=skhan@linuxfoundation.org \
/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