Python3.12環境でサンプルRTCを実行すると出るSyntaxWarning対応

[n-kawauchi]

Identify the Bug

Link to #319

• 指摘されたPortBase.pyの2464行目コード部分は以下の通り

2463         def __init__(self, id_):
2464             """ 
2465              \param id_(string)
2466             """ 
2467             self._id = id_

• これはDoxygen用に \param と記述している部分で、
  • Python の文字列 → \p を無効なエスケープと解釈する
  • Doxygen の構文 → \param を必要としている

Description of the Change

• 二重バックスラッシュに変更する

"""
\\param id_ (string)
"""

• Python では \ が1つ表示されるので、Doxygen には \param として正しく認識される
• 修正は複数のDoxygenキーワードを一括置換するスクリプトを使用した。詳細は下記参照。
  https://openrtm.org/redmine/projects/openrtm-aist-python/wiki/Python312環境で出るSyntaxWarning対応#複数のDoxygenキーワードを一括置換するスクリプト
• このスクリプトの実行結果は下記参照
  https://openrtm.org/redmine/projects/openrtm-aist-python/wiki/Python312環境で出るSyntaxWarning対応#一括置換結果

Verification

• 修正ソースからdebパッケージを生成し、これでインストールした環境でサンプルRTCを実行し、SyntaxWarningが出ないことを確認した（Ubuntu24.04）
• 修正ソースからクラスリファレンスを生成し、index.htmlを実行してブラウザ上で確認したところ問題なく表示されることを確認した
• Did you succeed the build?
• No warnings for the build?
• Have you passed the unit tests?