mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH] docs/zh_CN: add usb/ohci translation
@ 2026-08-29 18:48 Jiaming Ouyang
  2026-09-04  9:59 ` Weijie Yuan
  0 siblings, 1 reply; 4+ messages in thread
From: Jiaming Ouyang @ 2026-08-29 18:48 UTC (permalink / raw)
  To: linux-doc; +Cc: corbet, alexs, si.yanteng, dzm91, linux-kernel

From 395948212144549e20cfcdbd053817c4e068da35 Mon Sep 17 00:00:00 2001
From: Jiaming Ouyang <jiamingouyang13@gmail.com>
Date: Sat, 29 Aug 2026 20:35:37 +0200
Subject: [PATCH] docs/zh_CN: add usb/ohci translation

Signed-off-by: Jiaming Ouyang <jiamingouyang13@gmail.com>
---
 .../translations/zh_CN/usb/index.rst          |  2 +-
 Documentation/translations/zh_CN/usb/ohci.rst | 37 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/usb/ohci.rst

diff --git a/Documentation/translations/zh_CN/usb/index.rst
b/Documentation/translations/zh_CN/usb/index.rst
index df99814c6497..c96eacf13e11 100644
--- a/Documentation/translations/zh_CN/usb/index.rst
+++ b/Documentation/translations/zh_CN/usb/index.rst
@@ -32,6 +32,7 @@ USB 支持
     chipidea
     dwc3
     ehci
+    ohci
     usbmon

 待翻译文档:
@@ -49,7 +50,6 @@ USB 支持
 * mass-storage
 * misc_usbsevseg
 * mtouchusb
-* ohci
 * raw-gadget
 * usbip_protocol
 * usb-serial
diff --git a/Documentation/translations/zh_CN/usb/ohci.rst
b/Documentation/translations/zh_CN/usb/ohci.rst
new file mode 100644
index 000000000000..4387bb274071
--- /dev/null
+++ b/Documentation/translations/zh_CN/usb/ohci.rst
@@ -0,0 +1,37 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+:Original: Documentation/usb/ohci.rst
+
+:翻译: 欧阳家铭 Jiaming Ouyang <jiamingouyang13@gmail.com>
+
+========
+OHCI驱动
+========
+
+2026年8月29日
+
+“OHCI-hcd”驱动程序是一个USB主机控制器驱动程序(HCD),它源自2.4内核系列中的“usb-ohci”
+驱动程序。“usb-ohci”代码主要由 Roman Weissgaerber <weissg@vienna.at> 编写,但也获得了
+许多其他人的贡献(请阅读其版权)
+。
+
+它支持“开放主机控制器接口”(OHCI),该接口标准化了用于与USB 1.1主机控制器通信的硬件寄
+存器协议。与英特尔早期的“通用主机控制器接口”(UHCI)相比,它将更多只能功能注入到硬件
+中。除英特尔和威盛之外的其他供应商的USB1.1控制器通常使用OHCI。
+
+自2.4内核以来的更改包括
+
+ - 提高了健壮性; 修复了错误; 减少了开销
+ - 支持更新和简化的usbcore API
+ - 中断传输可以更大,并且可以排队
+ - 通过使用上层“hcd”框架,减少代码量
+ - 支持一些非PCI的OHCI实现
+ - ... 以及更多
+
+“OHCI-hcd”驱动程序处理所有USB 1.1传输类型。所有类型的传输都可以排队。在“usb-ohci”中也
+是如此,但中断传输除外。以前,使用一帧的周期会因为IRQ处理的开销而导致数据丢失的风险。
+当中断传输排队时,可以通过确保硬件在操作系统处理相关IRQ时始终有传输需要处理,来最大限
+度的降低这些风险
+
+- 欧阳家铭 Jiaming Ouyang
+  <jiamingouyang13@gmail.com>
-- 
2.53.0

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] docs/zh_CN: add usb/ohci translation
  2026-08-29 18:48 [PATCH] docs/zh_CN: add usb/ohci translation Jiaming Ouyang
@ 2026-09-04  9:59 ` Weijie Yuan
  2026-09-05 13:29   ` Jiaming Ouyang
  0 siblings, 1 reply; 4+ messages in thread
From: Weijie Yuan @ 2026-09-04  9:59 UTC (permalink / raw)
  To: Jiaming Ouyang; +Cc: linux-doc, corbet, alexs, si.yanteng, dzm91, linux-kernel

Hi,

On Sat, Aug 29, 2026 at 08:48:07PM +0200, Jiaming Ouyang wrote:
> From 395948212144549e20cfcdbd053817c4e068da35 Mon Sep 17 00:00:00 2001
> From: Jiaming Ouyang <jiamingouyang13@gmail.com>
> Date: Sat, 29 Aug 2026 20:35:37 +0200
> Subject: [PATCH] docs/zh_CN: add usb/ohci translation
> 
> Signed-off-by: Jiaming Ouyang <jiamingouyang13@gmail.com>

'git am' complains:

error: git diff header lacks filename information when removing 1
leading pathname component.

So I guess probably you don't need to include these email headers in the
changelog/commit message?  I'm not sure, but you can take a look at
relevant docs for this.

Also, instead, please write some meaningful info in the commit message,
see:

  https://docs.kernel.org/translations/zh_CN/how-to.html#id13

Thanks.

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] docs/zh_CN: add usb/ohci translation
  2026-09-04  9:59 ` Weijie Yuan
@ 2026-09-05 13:29   ` Jiaming Ouyang
  2026-09-05 15:29     ` Weijie Yuan
  0 siblings, 1 reply; 4+ messages in thread
From: Jiaming Ouyang @ 2026-09-05 13:29 UTC (permalink / raw)
  To: Weijie Yuan; +Cc: linux-doc, corbet, alexs, si.yanteng, dzm91, linux-kernel

[-- Attachment #1: Type: text/plain, Size: 1077 bytes --]

Hi,

I think this .patch in attachment will solve this problem, and the
commit information has been modified according to your feedback.

Thanks.

On Fri, Sep 4, 2026 at 12:00 PM Weijie Yuan <wy@wyuan.org> wrote:
>
> Hi,
>
> On Sat, Aug 29, 2026 at 08:48:07PM +0200, Jiaming Ouyang wrote:
> > From 395948212144549e20cfcdbd053817c4e068da35 Mon Sep 17 00:00:00 2001
> > From: Jiaming Ouyang <jiamingouyang13@gmail.com>
> > Date: Sat, 29 Aug 2026 20:35:37 +0200
> > Subject: [PATCH] docs/zh_CN: add usb/ohci translation
> >
> > Signed-off-by: Jiaming Ouyang <jiamingouyang13@gmail.com>
>
> 'git am' complains:
>
> error: git diff header lacks filename information when removing 1
> leading pathname component.
>
> So I guess probably you don't need to include these email headers in the
> changelog/commit message?  I'm not sure, but you can take a look at
> relevant docs for this.
>
> Also, instead, please write some meaningful info in the commit message,
> see:
>
>   https://docs.kernel.org/translations/zh_CN/how-to.html#id13
>
> Thanks.

[-- Attachment #2: 0001-docs-zh_CN-add-Chinese-translation-for-usb-ohci.rst_v2.patch --]
[-- Type: text/x-patch, Size: 3129 bytes --]

From 26316eeceb3dbe42bd59ced99b8dac02fb856138 Mon Sep 17 00:00:00 2001
From: Jiaming Ouyang <jiamingouyang13@gmail.com>
Date: Sat, 29 Aug 2026 20:35:37 +0200
Subject: [PATCH] docs/zh_CN: add Chinese translation for usb/ohci.rst

Translate Documentation/usb/ohci.rst into Chinese Simplified.

The translation covers OHCI driver overview, hardware protocol
differences (OHCI vs UHCI), improvements since 2.4 kernel,
queueable interrupt transfers, and non-PCI support.

Signed-off-by: Jiaming Ouyang <jiamingouyang13@gmail.com>
---
 .../translations/zh_CN/usb/index.rst          |  2 +-
 Documentation/translations/zh_CN/usb/ohci.rst | 37 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/usb/ohci.rst

diff --git a/Documentation/translations/zh_CN/usb/index.rst b/Documentation/translations/zh_CN/usb/index.rst
index df99814c6497..c96eacf13e11 100644
--- a/Documentation/translations/zh_CN/usb/index.rst
+++ b/Documentation/translations/zh_CN/usb/index.rst
@@ -32,6 +32,7 @@ USB 支持
     chipidea
     dwc3
     ehci
+    ohci
     usbmon
 
 待翻译文档:
@@ -49,7 +50,6 @@ USB 支持
 * mass-storage
 * misc_usbsevseg
 * mtouchusb
-* ohci
 * raw-gadget
 * usbip_protocol
 * usb-serial
diff --git a/Documentation/translations/zh_CN/usb/ohci.rst b/Documentation/translations/zh_CN/usb/ohci.rst
new file mode 100644
index 000000000000..4387bb274071
--- /dev/null
+++ b/Documentation/translations/zh_CN/usb/ohci.rst
@@ -0,0 +1,37 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+:Original: Documentation/usb/ohci.rst
+
+:翻译: 欧阳家铭 Jiaming Ouyang <jiamingouyang13@gmail.com>
+
+========
+OHCI驱动
+========
+
+2026年8月29日
+
+“OHCI-hcd”驱动程序是一个USB主机控制器驱动程序(HCD),它源自2.4内核系列中的“usb-ohci”
+驱动程序。“usb-ohci”代码主要由 Roman Weissgaerber <weissg@vienna.at> 编写,但也获得了
+许多其他人的贡献(请阅读其版权)
+。
+
+它支持“开放主机控制器接口”(OHCI),该接口标准化了用于与USB 1.1主机控制器通信的硬件寄
+存器协议。与英特尔早期的“通用主机控制器接口”(UHCI)相比,它将更多只能功能注入到硬件
+中。除英特尔和威盛之外的其他供应商的USB1.1控制器通常使用OHCI。
+
+自2.4内核以来的更改包括
+
+	- 提高了健壮性; 修复了错误; 减少了开销
+	- 支持更新和简化的usbcore API
+	- 中断传输可以更大,并且可以排队
+	- 通过使用上层“hcd”框架,减少代码量
+	- 支持一些非PCI的OHCI实现
+	- ... 以及更多
+
+“OHCI-hcd”驱动程序处理所有USB 1.1传输类型。所有类型的传输都可以排队。在“usb-ohci”中也
+是如此,但中断传输除外。以前,使用一帧的周期会因为IRQ处理的开销而导致数据丢失的风险。
+当中断传输排队时,可以通过确保硬件在操作系统处理相关IRQ时始终有传输需要处理,来最大限
+度的降低这些风险
+
+- 欧阳家铭 Jiaming Ouyang
+  <jiamingouyang13@gmail.com>
-- 
2.53.0


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] docs/zh_CN: add usb/ohci translation
  2026-09-05 13:29   ` Jiaming Ouyang
@ 2026-09-05 15:29     ` Weijie Yuan
  0 siblings, 0 replies; 4+ messages in thread
From: Weijie Yuan @ 2026-09-05 15:29 UTC (permalink / raw)
  To: Jiaming Ouyang; +Cc: linux-doc, corbet, alexs, si.yanteng, dzm91, linux-kernel

On Sat, Sep 05, 2026 at 03:29:36PM +0200, Jiaming Ouyang wrote:
> I think this .patch in attachment will solve this problem, and the

Thanks for the effort, but sadly, "no attachments" is a better practice.
;-)

See:

https://docs.kernel.org/process/submitting-patches.html#no-mime-no-links-no-compression-no-attachments-just-plain-text

Maybe you can try git-send-email later.

Anyway, I manually saved the patch and git am -3 works while git am does
not.

> commit information has been modified according to your feedback.

Yeah, I think this one looks good, though.

Thanks.

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2026-09-05 15:29 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-08-29 18:48 [PATCH] docs/zh_CN: add usb/ohci translation Jiaming Ouyang
2026-09-04  9:59 ` Weijie Yuan
2026-09-05 13:29   ` Jiaming Ouyang
2026-09-05 15:29     ` Weijie Yuan

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®