Apply suggestions from code review

Dr-XYZ · mattwang44 · web-flow · commit 943d63e93bb3 · 2025-07-22T12:03:44.000+08:00
Co-authored-by: W. H. Wang &lt;mattwang44@gmail.com&gt;
diff --git a/library/pydoc.po b/library/pydoc.po
@@ -46,9 +46,9 @@ msgid ""
 "the source file, or at the top of the module (see :func:`inspect."
 "getcomments`)."
 msgstr ""
-"對於模組、類別、函式和方法，所顯示的文件是衍生自物件的說明字串（也就是物件"
-"的 :attr:`~definition.__doc__` 屬性），以及其可文件化成員的說明字串（遞迴"
-"地）。如果沒有說明字串，:mod:`!pydoc` 會嘗試從原始碼檔案中，類別、函式或方法"
+"對於模組、類別、函式和方法，所顯示的文件是從物件的說明字串（也就是物件"
+"的 :attr:`~definition.__doc__` 屬性）以及遞迴地從其可文件化成員的說明字串所"
+"取得。如果沒有說明字串，:mod:`!pydoc` 會嘗試從原始碼檔案中，類別、函式或方法"
 "定義正上方的註解區塊，或從模組的頂部取得描述（參見 :func:`inspect."
 "getcomments`）。"
 
@@ -82,7 +82,7 @@ msgid ""
 msgstr ""
 "在 shell 提示字元下，將會顯示 :mod:`sys` 模組的文件，其風格類似於 Unix :"
 "program:`man` 命令所顯示的手冊頁面。:program:`pydoc` 的引數可以是函式、模組或"
-"套件的名稱，或是一個指向模組中或套件中模組內的類別、方法或函式的點號參照。如"
+"套件的名稱，或是一個指向模組中或套件中模組內的類別、方法或函式的點號參照 (dotted reference)。如"
 "果 :program:`pydoc` 的引數看起來像一個路徑（也就是說，它包含你作業系統的路徑"
 "分隔符，例如 Unix 中的斜線），並且指向一個已存在的 Python 原始碼檔案，那麼就"
 "會為該檔案產生文件。"
@@ -95,8 +95,8 @@ msgid ""
 "only execute code when a file is invoked as a script and not just imported."
 msgstr ""
 "為了找到物件及其文件，:mod:`!pydoc` 會引入要文件化的模組。因此，任何在模組層"
-"級的程式碼都會在該場合被執行。使用 ``if __name__ == '__main__':`` 的防護措"
-"施，可以確保程式碼只在檔案作為腳本被呼叫時執行，而不是僅被引入時執行。"
+"級的程式碼都會在那個時候被執行。使用 ``if __name__ == '__main__':`` 的防護措"
+"施，可以確保程式碼只在檔案作為腳本被呼叫時執行，而不會在被引入時就執行。"
 
 #: ../../library/pydoc.rst:54
 msgid ""
@@ -105,7 +105,7 @@ msgid ""
 "envvar:`PAGER` environment variable is set, :program:`pydoc` will use its "
 "value as a pagination program. When both are set, :envvar:`MANPAGER` is used."
 msgstr ""
-"當在主控台輸出時，:program:`pydoc` 會嘗試將輸出分頁以便於閱讀。如果 :envvar:"
+"當在主控台印出輸出內容時，:program:`pydoc` 會嘗試將輸出內容做分頁以便於閱讀。如果 :envvar:"
 "`MANPAGER` 或 :envvar:`PAGER` 環境變數其中之一被設定，:program:`pydoc` 將會使"
 "用其值作為分頁程式。當兩者都被設定時，會使用 :envvar:`MANPAGER`。"
 
@@ -125,7 +125,7 @@ msgid ""
 "manner similar to the Unix :program:`man` command.  The synopsis line of a "
 "module is the first line of its documentation string."
 msgstr ""
-"在引數前指定一個 ``-k`` 旗標，將會搜尋所有可用模組的摘要行，尋找作為引數給出"
+"在引數前指定一個 ``-k`` 旗標，將會搜尋所有可用模組的摘要行 (synopsis lines)，尋找作為引數給出"
 "的關鍵字，其方式同樣類似於 Unix 的 :program:`man` 命令。一個模組的摘要行是其"
 "說明字串的第一行。"
 
@@ -141,7 +141,7 @@ msgstr ""
 "你也可以使用 :program:`pydoc` 在本機上啟動一個 HTTP 伺服器，它會向來訪的網頁"
 "瀏覽器提供文件。:program:`python -m pydoc -p 1234` 將會在 1234 埠啟動一個 "
 "HTTP 伺服器，讓你可以用你偏好的網頁瀏覽器在 ``http://localhost:1234/`` 瀏覽文"
-"件。指定 ``0`` 作為埠將會選擇一個任意未使用的埠。"
+"件。指定 ``0`` 作為通訊埠編號將會選擇一個任意未使用的通訊埠。"
 
 #: ../../library/pydoc.rst:74
 msgid ""
