Re: [PATCH v7 2/8] docs/zh_CN: Add acm.rst translation

[Kefan Bai <baikefan@leap-io-kernel.com>]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=GB18030, Size: 7529 bytes --]

On Mon, 25 May 2026 10:05:23 +0800
Alex Shi <seakeel@gmail.com> wrote:

> 
> 
> On 2026/5/21 17:55, Kefan Bai wrote:
> > Translate .../usb/acm.rst into Chinese
> > 
> > Update the translation through commit ecefae6db042
> > ("docs: usb: rename files to .rst and add them to drivers-api")
> > 
> > Reviewed-by: Yanteng Si<siyanteng@cqsoftware.com.cn>
> > Signed-off-by: Kefan Bai<baikefan@leap-io-kernel.com>
> > ---
> >   Documentation/translations/zh_CN/usb/acm.rst  | 147
> > ++++++++++++++++++ .../translations/zh_CN/usb/index.rst          |
> >  2 +- 2 files changed, 148 insertions(+), 1 deletion(-)
> >   create mode 100644 Documentation/translations/zh_CN/usb/acm.rst
> > 
> > diff --git a/Documentation/translations/zh_CN/usb/acm.rst
> > b/Documentation/translations/zh_CN/usb/acm.rst new file mode 100644
> > index 000000000000..51d6eb8f5660
> > --- /dev/null
> > +++ b/Documentation/translations/zh_CN/usb/acm.rst
> > @@ -0,0 +1,147 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +.. include:: ../disclaimer-zh_CN.rst
> > +
> > +:Original: Documentation/usb/acm.rst
> > +
> > +:·­Òë:
> > +
> > + °×îÝ·² Kefan Bai<baikefan@leap-io-kernel.com>
> > +
> > +:УÒë:
> > +
> > +
> > +====================
> > +Linux ACM Çý¶¯ v0.16
> > +====================
> > +
> > +°æȨËùÓÐ (c) 1999 Vojtech Pavlik<vojtech@suse.cz>
> > +
> > +ÓÉ SuSE ÔÞÖú
> > +
> > +0. ÃâÔðÉùÃ÷
> > +~~~~~~~~~~~
> > +±¾³ÌÐòÊÇ×ÔÓÉÈí¼þ£»Äã¿ÉÒÔÔÚ×ÔÓÉÈí¼þ»ù½ð»á·¢²¼µÄ
> > +GNU ͨÓù«¹²Ðí¿ÉÖ¤µÚ 2 °æ£¬»òÕߣ¨°´ÄãµÄÑ¡Ôñ£©
> > +ÈκκóÐø°æ±¾µÄÌõ¿îÏÂÖØз¢²¼ºÍ/»òÐÞ¸ÄËü¡£
> > +
> > +·¢²¼±¾³ÌÐòÊÇÏ£ÍûËüÄÜ·¢»Ó×÷Ó㬵«Ëü²»¸½´øÈκε£±££»
> > +ÉõÖÁ²»°üÀ¨¶ÔÊÊÏúÐÔ»òÌض¨ÓÃ;ÊÊÓÃÐÔµÄĬʾµ£±£¡£
> > +ÏêÇé¼û GNU ͨÓù«¹²Ðí¿ÉÖ¤¡£
> 
> Hi Kefan,
> 
> The alignment means we will try use the width for each of lines, not 
> just stop for each of punctuation. Please fix all patches alignment,
> try to expand the whole width for lines unless it's broken a word or
> unreadable.
> 
> Thanks

Hi Alex,

  Sorry for the late reply, and thanks for the review.

  I understand the formatting point now. The translated text should be
  reflowed more evenly, instead of breaking too early around
  punctuation.

  Greg queued this series in usb-testing on May 21, 2026, and then
  moved it into usb-next on May 27, 2026. At this point, would you
  prefer me to leave the current series as-is and follow this rule in
  future translations, or send a small follow-up cleanup patch on top
  of usb-next?

  Thanks,
  Kefan

> > +
> > +ÄãÓ¦¸ÃÒѾ­Ëæ±¾³ÌÐòÊÕµ½ÁË GNU ͨÓù«¹²Ðí¿ÉÖ¤µÄ¸±±¾£»
> > +Èç¹ûûÓУ¬ÇëÖÂÐÅ£ºFree Software Foundation, Inc., 59
> > +Temple Place, Suite 330, Boston, MA 02111-1307 USA¡£
> > +
> > +ÈçÐèÁªÏµ×÷Õߣ¬¿É·¢Ë͵ç×ÓÓʼþÖÁvojtech@suse.cz£¬
> > +»òÓʼÄÖÁ£º
> > +Vojtech Pavlik, Ucitelska 1576, Prague 8,
> > +182 00, Czech Republic¡£
> > +
> > +Ϊ·½±ãÆð¼û£¬Èí¼þ°üÖÐÒѸ½´ø GNU ͨÓù«¹²Ðí¿ÉÖ¤
> > +µÚ 2 °æ£º¼û COPYING Îļþ¡£
> > +
> > +1. ʹÓ÷½·¨
> > +~~~~~~~~~~~
> > +``drivers/usb/class/cdc-acm.c`` Çý¶¯¿ÉÓÃÓÚ·ûºÏ USB
> > +ͨÐÅÉ豸Àà³éÏó¿ØÖÆÄ£ÐÍ£¨USB CDC ACM£©¹æ·¶µÄ
> > +USB µ÷Öƽâµ÷Æ÷ºÍ USB ISDN ÖÕ¶ËÊÊÅäÆ÷¡£
> > +
> > +Ðí¶àµ÷Öƽâµ÷Æ÷Ö§³Ö´ËÇý¶¯£¬ÒÔÏÂÊÇÎÒËùÖªµÀµÄһЩÐͺţº
> > +
> > +	- 3Com OfficeConnect 56k
> > +	- 3Com Voice FaxModem Pro
> > +	- 3Com Sportster
> > +	- MultiTech MultiModem 56k
> > +	- Zoom 2986L FaxModem
> > +	- Compaq 56k FaxModem
> > +	- ELSA Microlink 56k
> > +
> > +ÎÒÖªµÀÓÐÒ»¿î ISDN ÖÕ¶ËÊÊÅäÆ÷¿ÉÒÔÓë ACM Çý¶¯Ò»ÆðʹÓãº
> > +
> > +	- 3Com USR ISDN Pro TA
> > +
> > +һЩÊÖ»úÒ²¿ÉÒÔͨ¹ý USB Á¬½Ó¡£
> > +ÎÒÖªµÀÒÔÏ»úÐÍ¿ÉÒÔÕý³£¹¤×÷£º
> > +
> > +	- SonyEricsson K800i
> > +
> > +Òź¶µÄÊÇ£¬Ðí¶àµ÷Öƽâµ÷Æ÷ºÍ´ó¶àÊý ISDN TA
> > +¶¼Ê¹ÓÃרÓнӿڣ¬Òò´ËÎÞ·¨Óë´ËÇý¶¯ÅäºÏ¹¤×÷¡£
> > +¹ºÂòÇ°ÇëÏÈÈ·ÈÏÉ豸ÊÇ·ñ·ûºÏ ACM ¹æ·¶¡£
> > +
> > +ҪʹÓÃÕâЩµ÷Öƽâµ÷Æ÷£¬ÐèÒª¼ÓÔØÒÔÏÂÄ£¿é::
> > +
> > +	usbcore.ko
> > +	uhci-hcd.ko ohci-hcd.ko or ehci-hcd.ko
> > +	cdc-acm.ko
> > +
> > +Ö®ºó¾ÍÓ¦¸Ã¿ÉÒÔ·ÃÎÊÕâЩµ÷Öƽâµ÷Æ÷ÁË¡£
> > +Ó¦µ±¿ÉÒÔʹÓà ``minicom``¡¢``ppp`` ºÍ ``mgetty``
> > +ÓëËüÃÇͨÐÅ¡£
> > +
> > +2. ÑéÖ¤Çý¶¯ÊÇ·ñÕý³£¹¤×÷
> > +~~~~~~~~~~~~~~~~~~~~~~~
> > +
> > +µÚÒ»²½ÊǼì²é ``/sys/kernel/debug/usb/devices``£¬
> > +ÆäÄÚÈÝÓ¦¸ÃÀàËÆÈçÏÂ::
> > +
> > +  T:  Bus=01 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#=  1 Spd=12  MxCh= 2
> > +  B:  Alloc=  0/900 us ( 0%), #Int=  0, #Iso=  0
> > +  D:  Ver= 1.00 Cls=09(hub  ) Sub=00 Prot=00 MxPS= 8 #Cfgs=  1
> > +  P:  Vendor=0000 ProdID=0000 Rev= 0.00
> > +  S:  Product=USB UHCI Root Hub
> > +  S:  SerialNumber=6800
> > +C:* #Ifs= 1 Cfg#= 1 Atr=40 MxPwr=  0mA
> > +  I:  If#= 0 Alt= 0 #EPs= 1 Cls=09(hub  ) Sub=00 Prot=00 Driver=hub
> > +  E:  Ad=81(I) Atr=03(Int.) MxPS=   8 Ivl=255ms
> > +  T:  Bus=01 Lev=01 Prnt=01 Port=01 Cnt=01 Dev#=  2 Spd=12  MxCh= 0
> > +  D:  Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs=  2
> > +  P:  Vendor=04c1 ProdID=008f Rev= 2.07
> > +  S:  Manufacturer=3Com Inc.
> > +  S:  Product=3Com U.S. Robotics Pro ISDN TA
> > +  S:  SerialNumber=UFT53A49BVT7
> > +  C:  #Ifs= 1 Cfg#= 1 Atr=60 MxPwr=  0mA
> > +  I:  If#= 0 Alt= 0 #EPs= 3 Cls=ff(vend.) Sub=ff Prot=ff Driver=acm
> > +  E:  Ad=85(I) Atr=02(Bulk) MxPS=  64 Ivl=  0ms
> > +  E:  Ad=04(O) Atr=02(Bulk) MxPS=  64 Ivl=  0ms
> > +  E:  Ad=81(I) Atr=03(Int.) MxPS=  16 Ivl=128ms
> > +C:* #Ifs= 2 Cfg#= 2 Atr=60 MxPwr=  0mA
> > +  I:  If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
> > +  E:  Ad=81(I) Atr=03(Int.) MxPS=  16 Ivl=128ms
> > +  I:  If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
> > +  E:  Ad=85(I) Atr=02(Bulk) MxPS=  64 Ivl=  0ms
> > +  E:  Ad=04(O) Atr=02(Bulk) MxPS=  64 Ivl=  0ms
> > +
> > +ÕâÈýÐеĴæÔںܹؼü£¨ÒÔ¼° ``Cls=`` ×Ö¶ÎÀï³öÏÖµÄ
> > +``comm`` ºÍ ``data`` Àࣩ£»Ëü˵Ã÷ÕâÊÇÒ»¸ö ACM
> > +É豸¡£``Driver=acm`` ±íʾ¸ÃÉ豸ÕýÔÚʹÓà acm Çý¶¯¡£
> > +Èç¹ûÖ»¿´µ½ ``Cls=ff(vend.)``£¬ÄǾÍÎÞÄÜΪÁ¦ÁË£º
> > +Õâ˵Ã÷ÄãÊÖÉϵÄÉ豸ʹÓõÄÊdz§ÉÌרÓнӿÚ::
> > +
> > +    D:  Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs=  2
> > +    I:  If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01
> > Driver=acm
> > +    I:  If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00
> > Driver=acm +
> > +ÔÚϵͳÈÕÖ¾ÖÐÓ¦¸Ã¿ÉÒÔ¿´µ½::
> > +
> > +  usb.c: USB new device connect, assigned device number 2
> > +  usb.c: kmalloc IF c7691fa0, numif 1
> > +  usb.c: kmalloc IF c7b5f3e0, numif 2
> > +  usb.c: skipped 4 class/vendor specific interface descriptors
> > +  usb.c: new device strings: Mfr=1, Product=2, SerialNumber=3
> > +  usb.c: USB device number 2 default language ID 0x409
> > +  Manufacturer: 3Com Inc.
> > +  Product: 3Com U.S. Robotics Pro ISDN TA
> > +  SerialNumber: UFT53A49BVT7
> > +  acm.c: probing config 1
> > +  acm.c: probing config 2
> > +  ttyACM0: USB ACM device
> > +  acm.c: acm_control_msg: rq: 0x22 val: 0x0 len: 0x0 result: 0
> > +  acm.c: acm_control_msg: rq: 0x20 val: 0x0 len: 0x7 result: 7
> > +  usb.c: acm driver claimed interface c7b5f3e0
> > +  usb.c: acm driver claimed interface c7b5f3f8
> > +  usb.c: acm driver claimed interface c7691fa0
> > +
> > +Èç¹ûÒÔÉ϶¼Õý³££¬ÇëÆô¶¯ ``minicom``£¬
> > +°ÑËüÅäÖÃΪÁ¬½Ó ``ttyACM`` É豸£¬È»ºó
> > +³¢ÊÔÊäÈë ``at``¡£Èç¹û·µ»Ø ``OK``£¬ËµÃ÷Ò»Çй¤×÷Õý³£¡£
> > diff --git a/Documentation/translations/zh_CN/usb/index.rst
> > b/Documentation/translations/zh_CN/usb/index.rst index
> > b4cb0ccaa39b..686e5b0a9384 100644 ---
> > a/Documentation/translations/zh_CN/usb/index.rst +++
> > b/Documentation/translations/zh_CN/usb/index.rst @@ -17,10 +17,10
> > @@ USB Ö§³Ö .. toctree::
> >       :maxdepth: 1
> > 
> > +    acm
> > 
> >   Todolist:
> > 
> > -* acm
> >   * authorization
> >   * chipidea
> >   * dwc3
> > --
> > 2.54.0
> > 
> 
> 
>