Re: [PATCH v2] docs/zh_CN: Add driver-api phy translation

[si.yanteng@linux.dev]

2024年6月25日 13:59, "Dongliang Mu" <mudongliangabcd@gmail.com> 写到:



> 
> On Tue, Jun 25, 2024 at 11:24 AM Yanteng Si <siyanteng@loongson.cn> wrote:
> 
> > 
> > Translate driver-api/phy.rst into Chinese.
> > 
> >  commit d02aa181ee59 ("phy: Add devm_of_phy_optional_get() helper")
> > 
> >  Signed-off-by: Yanteng Si <siyanteng@loongson.cn>
> > 
> >  ---
> > 
> >  v2:
> > 
> >  Modified some sentences in accordance with Dongliang's comments.
> > 
> >  .../translations/zh_CN/driver-api/index.rst | 2 +-
> > 
> >  .../zh_CN/driver-api/phy/index.rst | 20 ++
> > 
> >  .../translations/zh_CN/driver-api/phy/phy.rst | 213 ++++++++++++++++++
> > 
> >  3 files changed, 234 insertions(+), 1 deletion(-)
> > 
> >  create mode 100644 Documentation/translations/zh_CN/driver-api/phy/index.rst
> > 
> >  create mode 100644 Documentation/translations/zh_CN/driver-api/phy/phy.rst
> > 
> >  diff --git a/Documentation/translations/zh_CN/driver-api/index.rst b/Documentation/translations/zh_CN/driver-api/index.rst
> > 
> >  +PHY 驱动程序可以使用上述两个 API 之一，通过传递设备指针和 phy_ops
> > 
> >  +来创建 PHY。
> > 
> >  +
> > 
> >  +phy_ops 是一组用于执行 PHY 操作（例如 init、exit、power_on 和
> > 
> >  +power_off）的函数指针。
> > 
> >  +
> > 
> >  +为了取消引用私有数据（在 phy_ops 中），PHY provider驱动程序可以在创建
> > 
> 
>  The Chinese translation of dereference should be “解引用”, a terminology.
> 
> > 
> > +PHY 后使用 phy_set_drvdata()，并在 phy_ops 中使用 phy_get_drvdata()
> > 
> >  +来取回私有数据。
> > 
> 
> I prefer not to translate "in phy_ops". The delivered content from
> 
> this sentence should be:
> 
> PHY provider驱动程序使用phy_set_drvdata设置私有数据，使用phy_get_drvdata获取私有数据。
> 
> 感觉可以进行意译。
OK.
在 phy_ops 中，PHY provider驱动程序在创建 PHY 后使用 phy_set_drvdata()
设置私有数据，使用 phy_get_drvdata() 获取私有数据。
> 

> > 
> >  +
> > 
> >  +销毁 PHY
> > 
> >  +========
> > 
> >  +
> > 
> >  +卸载创建 PHY 的驱动程序时，它应该使用以下 2 个 API 之一销毁其创建的
> > 
> 
> 当创建 PHY 的驱动程序被卸载时，它应该使用以下 2 个 API 之一销毁其创建的
> 
> 这个“它” 应该指的是驱动程序，所以换成倒装会好一些。
OK.
> 
> Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>


Thanks for your review.


Thanks,
Yanteng