「パラメータ」「引数」訳し分けルールの改定

[KentarouTakeda]

「用語集」に定義されていた「parameter: パラメータ」「argument: 引数」の訳し分けルールの改定を提案するPRです:

• AsIs: 「parameter: パラメータ」「argument: 引数」と訳す
• ToBe: 原則として「引数」に統一する
• 備考: 既訳の一括修正は見送り
  • 対象が1000箇所以上に及ぶ
  • <title> や <hN> も対象となりクローラーに混乱を与える可能性

理由は次のとおりです:

• 正確を期すのであれば「仮引数」「実引数」
  • 参考: https://developer.mozilla.org/ja/docs/Glossary/Parameter
  • 参考: https://developer.mozilla.org/ja/docs/Glossary/Argument
  • 参考: https://doc.rust-jp.rs/book-ja/ch03-03-how-functions-work.html#%E5%BC%95%E6%95%B0
• 原文の時点で基準なく揺れている（正確な訳し分けはその揺れを引き継いでしまう）
  1. functions.xml Eliminate confusion in fn's parameters and arguments doc-en#4062
     functions.xml を parameter / argument で書き分けるよう整理。レビューでは「区別が重要なのは主に曖昧なときで、多くの場合どちらの語でも意味は通る」とコメントされている。
  2. Closures created from magic functions handle named params (closes #4193) doc-en#4194
     4日後、同じ functions.xml に呼び出し側の意味で "can accept named parameters" と混用が再混入
  3. Clarify forward_static_call docs doc-en#5784
     forward_static_call_array の概要を "pass the arguments as array" から "Call a callback with an array of parameters" に書き換え。同じページの本文は "with arguments passed as an array" のまま（前述の経緯を踏まえると、PRスコープを理由に拒否される可能性が高い）
• 訳す時点で意味から判断しようとしても、一意に決まらないケースがある

  • https://www.php.net/manual/ja/migration83.deprecated.php#migration83.deprecated.reflection

    To set static properties, pass null as the first parameter.

    static プロパティを設定するには、最初の引数に null を渡します。

    呼び出す側から見て「null を最初の実引数として渡す」、受け取る側から見て「最初の仮引数に null が渡される」、どちらも正しい

  • https://www.php.net/manual/ja/function.iconv-strlen.php#refsect1-function.iconv-strlen-parameters

    If encoding parameter is omitted or null, string is assumed to be encoded in iconv.internal_encoding.

    encoding パラメータが指定されなかった場合、もしくは null の場合、 string のエンコードは iconv.internal_encoding であると判断されます。

    能動態で「実引数を省略するか null を渡した場合」とも、受動態で「仮引数が指定されなかったか null の場合」とも読める

• 日本国内の多くの文章で「引数」と明確に述べている
  • MDN 日本語版: https://developer.mozilla.org/ja/docs/Glossary/Argument

    日本語では、実引数 (argunment) と仮引数 (parameter) をまとめて引数と呼ぶのが一般的です。MDN の翻訳記事では、区別が必要な場面を除いて「引数」の用語を使用しています。

  • Rust Book 日本語版: https://doc.rust-jp.rs/book-ja/ch03-03-how-functions-work.html

    日本語では、特別区別する意図がない限り、どちらも単に引数と呼ぶことが多いでしょう。

• 「引数」として定着した慣用の複合名詞が存在する
  • 「可変長引数」
  • 「名前付き引数」