Linux Documentation
 help / color / mirror / Atom feed
From: Alex Shi <seakeel@gmail.com>
To: Jiaming Ouyang <jiamingouyang13@gmail.com>
Cc: linux-doc@vger.kernel.org, "corbet@lwn.net" <corbet@lwn.net>,
	alexs@kernel.org, si.yanteng@linux.dev, dzm91@hust.edu.cn,
	linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs/zh_CN: add usb/ohci translation
Date: Mon, 7 Sep 2026 17:04:41 +0800	[thread overview]
Message-ID: <eb05f56b-5443-4554-9296-cc3fb07b096a@gmail.com> (raw)
In-Reply-To: <CAMnqnYxarwJ1MaW-HX-bJmPvok+xugn7V0-u2cGp+FeXPz69rA@mail.gmail.com>

It's better to resend as a new version. And please check again
1, your alignment for each of lines.
2, rebase on the latest Chinese-doc tree.

Thanks!

On 2026/9/7 16:50, Jiaming Ouyang wrote:
> 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>
> ---
> I have modified according to your feedback.
> 
>   .../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..1fc06f01d7e8
> --- /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时始终有传输需要处理,来最大限
> +度的降低这些风险
> +
> +- David Brownell
> +<dbrownell@users.sourceforge.net>
> -- 2.53.0 On Mon, Sep 7, 2026 at 4:37 AM Alex Shi <seakeel@gmail.com> 
> wrote:
>>
>>
>> On 2026/8/30 02:48, 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>
>>> ---
>>>    .../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>
>> This signature might mislead people into thinking you are the author.
>>
>> Please keep the original autor:
>> - David Brownell
>>     <dbrownell@users.sourceforge.net>
>>    > -- 2.53.0


  reply	other threads:[~2026-09-07  9:04 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
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
2026-09-06 13:59       ` Jiaming Ouyang
2026-09-07  2:37 ` Alex Shi
2026-09-07  8:50   ` Jiaming Ouyang
2026-09-07  9:04     ` Alex Shi [this message]
2026-09-07 10:42       ` Jiaming Ouyang

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=eb05f56b-5443-4554-9296-cc3fb07b096a@gmail.com \
    --to=seakeel@gmail.com \
    --cc=alexs@kernel.org \
    --cc=corbet@lwn.net \
    --cc=dzm91@hust.edu.cn \
    --cc=jiamingouyang13@gmail.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@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