Re: [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation
Weijie Yuan <[email protected]>
| Newsgroups | org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
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/[email protected]/ Looking up https://lore.kernel.org/all/[email protected]/ Grabbing thread from lore.kernel.org/all/[email protected]/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 <[email protected]> + Reviewed-by: Weijie Yuan <[email protected]> (✗ DKIM/wyuan.org) ✗ [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation + Reviewed-by: Dongliang Mu <[email protected]> + Reviewed-by: Weijie Yuan <[email protected]> (✗ DKIM/wyuan.org) ✗ [PATCH v4 3/5] docs/zh_CN: Add Softnet Driver Issues Chinese translation + Reviewed-by: Dongliang Mu <[email protected]> + Reviewed-by: Weijie Yuan <[email protected]> (✗ DKIM/wyuan.org) ✗ [PATCH v4 4/5] docs/zh_CN: Add ipv6 Chinese translation + Reviewed-by: Dongliang Mu <[email protected]> + Reviewed-by: Weijie Yuan <[email protected]> (✗ DKIM/wyuan.org) ✗ [PATCH v4 5/5] docs/zh_CN: Add LSM/SeLinux secid Chinese translation + Acked-by: Weijie Yuan <[email protected]> (✗ 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..