xfunc.sgmlの18.0対応 #3574

kiskk · 2025-12-24T03:02:46Z

翻訳メモ

variant 亜種
色々な意味があり難しい… 変種・亜種などがあるが、多そうなのは亜種

and/or AおよびB、またはいずれか一方
英語では明確かつ端的に示せる便利な言葉だが日本語だとややこしい

semantic セマンティック
「意味」という意味、そのまま「セマンティック」としている箇所が多いので「セマンティック」を採用

Semantiv versioning セマンティックバージョニング
そのままでバージョン規則に関するルール名が一般的な模様

family 族
アドレスファミリー、などの使い方を除くと、何々族、という使い方が多い

collation information 照合順序情報

C Type Cの型

extension 拡張機能

guidance 手引

When a change is required
「必要」を強調英文ではisのみを強調する形。存在する場合を強調しているという理解なので日本語ではその後のワードを強調、「変更が必要」という全体を強調したほうが自然？

critical section クリティカルセクション

Cumulative Statistics System 累積統計システム
ドキュメントの既存翻訳のまま

Custom Cumulative Statistics カスタム累積統計
ドキュメントでは「累積統計」ですが、本体日本語エラーメッセージでは「独自集積統計情報」。ドキュメントの方が自然と考えそちらに寄せています

セクションIDのtypo

セクションIDにtypoと思われる箇所あり mninor->minor

<sect4 id="xfunc-guidance-api-mninor-versions">
<sect4 id="xfunc-guidance-abi-mninor-versions">

現状どこからもリンクはされていないので、問題はないです。
細かすぎるのでできればなにかに合わせて本体にフィードバック？

Copilot

Pull request overview

This PR updates the Japanese translation of xfunc.sgml for PostgreSQL version 18.0, replacing machine-generated translations with human-refined translations. The update improves translation quality and establishes consistent terminology choices for technical terms (e.g., "variant" → "亜種", "semantic versioning" → "セマンティックバージョニング", "family" → "族").

Key changes:

Refined translations for API/ABI stability guidance sections with clearer, more natural Japanese
Improved translations for function calling conventions, injection points, and custom cumulative statistics
Corrected awkward machine translation phrases throughout the document

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-24T09:12:11Z

doc/src/sgml/xfunc.sgml

      </para>
     </sect4>

     <sect4 id="xfunc-guidance-api-mninor-versions">


Section ID contains a typo: "mninor" should be "minor". The correct ID should be "xfunc-guidance-api-minor-versions". While this doesn't currently break any links (as noted in the PR description), it should be corrected for consistency and future maintainability.

Suggested change

<sect4 id="xfunc-guidance-api-mninor-versions">

<sect4 id="xfunc-guidance-api-minor-versions">

Copilot · 2025-12-24T09:12:11Z

doc/src/sgml/xfunc.sgml

      </para>
     </sect4>

     <sect4 id="xfunc-guidance-abi-mninor-versions">


Section ID contains a typo: "mninor" should be "minor". The correct ID should be "xfunc-guidance-abi-minor-versions". While this doesn't currently break any links (as noted in the PR description), it should be corrected for consistency and future maintainability.

Suggested change

<sect4 id="xfunc-guidance-abi-mninor-versions">

<sect4 id="xfunc-guidance-abi-minor-versions">

noborus · 2025-12-24T09:58:32Z

doc/src/sgml/xfunc.sgml

+亜種<literal>PG_MODULE_MAGIC_EXT</literal>を使用すると、モジュールに関する追加情報を指定できます。
+現在は、名前およびバージョン文字列、またはいずれか一方を追加できます。（将来、さらに多くのフィールドが許可される可能性があります。）
 次のように記述します。
-


元あった空行が削除されてしまってます。

削除してしまっていた空行を元に戻しました

noborus · 2025-12-24T10:00:36Z

doc/src/sgml/xfunc.sgml

    <title>Custom Cumulative Statistics</title>
-
+-->
+    <title>カスタム累積統計</title>


元あった空行が削除されてしまってます。（日本語訳の後に空行が必要）。

英文タイトル下部の空行を元に戻して、日本語訳もこれにあわせて空行を追加しました

すみません説明不足で。英文タイトル下部の空行は削除でよいです。
日本語訳の下に空行があれば、空行が下に移動した（空行の前に日本語訳が追加された）と解釈されてdiffで余計な+-がでなくなります。

空行を入れない、空行を削除しないを参照してください。

ありがとうございます、理解しました。すみません、確認不足で失礼いたしました…
英文タイトル下部の空行を削除しました。

ありがとうございます。確認しました。

noborus · 2026-01-02T03:19:24Z

doc/src/sgml/xfunc.sgml

       interface used at run time.
 -->
-《機械翻訳》<acronym>ABI</acronym>、またはアプリケーションバイナリインタフェースは、実行時に使用されるインタフェースです。
+<acronym>ABI</acronym>、またはアプリケーション・バイナリ・インタフェースは、実行時に使用されるインタフェースです。


このorは「すなわち」「つまり」の方ではないでしょうか。

あと他の方にご意見伺いたいですが、中点なくても良いかもhttps://ja.wikipedia.org/wiki/%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%90%E3%82%A4%E3%83%8A%E3%83%AA%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%95%E3%82%A7%E3%83%BC%E3%82%B9

確認ありがとうございます！
コメントのとおりで、ここでのorは「ABI、すなわち〜」ですね。
中点もなくて良いと思いました。

APIの箇所も含め修正するならば以下のとおりになる認識です。

<acronym>API</acronym>、すなわちアプリケーションプログラミングインタフェースは、コンパイル時に使用されるインタフェースです。
<acronym>ABI</acronym>、すなわちアプリケーションバイナリインタフェースは、実行時に使用されるインタフェースです。

orはすなわちで良いと思います。また中点も無しで良いと思います。
ということで、修正案に賛成です。

ありがとうございます、案のとおり修正しました。

KenichiroTanaka

1点細かいですが気づくところがあったので見ていただいてもいいでしょうか。
中点・orのABI翻訳部分についてはいただいた修正案で賛成です。

KenichiroTanaka · 2026-01-10T15:08:08Z

doc/src/sgml/xfunc.sgml

+これらの便利な関数および類似の関数は、<filename>fmgr.h</filename>にあります。
+<function>DirectFunctionCall<replaceable>n</replaceable></function>族はC関数の名前を最初の引数として想定しています。
+また、対象関数のOIDを受け取る<function>OidFunctionCall<replaceable>n</replaceable></function>や、その他の亜種もあります。
+これらはすべて、関数の引数が<type>Datum</type>sとして提供されることを想定しており、同様に<type>Datum</type>として返します。


関数の引数が<type>Datum</type>sとしてのsは意図して残したものでしょうか？
複数形のsであれば翻訳側には不要かなと思いました。

複数形のsである認識で、そのまま残していました。翻訳した場合はたしかに不要な記述なので取り除きました。

KenichiroTanaka · 2026-01-10T15:31:13Z

doc/src/sgml/xfunc.sgml

       interface used at run time.
 -->
-《機械翻訳》<acronym>ABI</acronym>、またはアプリケーションバイナリインタフェースは、実行時に使用されるインタフェースです。
+<acronym>ABI</acronym>、またはアプリケーション・バイナリ・インタフェースは、実行時に使用されるインタフェースです。


orはすなわちで良いと思います。また中点も無しで良いと思います。
ということで、修正案に賛成です。

KenichiroTanaka

対応ありがとうございます。確認しました。

noborus

確認済みなのでマージします。

Translate xfunc.sgml for v18.0

db1257b

github-actions bot added the レビュー待ち label Dec 24, 2025

Fix ngword

956903b

noborus requested a review from Copilot December 24, 2025 09:08

Copilot started reviewing on behalf of noborus December 24, 2025 09:09 View session

Copilot AI reviewed Dec 24, 2025

View reviewed changes

noborus reviewed Dec 24, 2025

View reviewed changes

noborus added 指摘事項あり and removed レビュー待ち labels Dec 24, 2025

Fix removed line breaks

298e862

github-actions bot added 再レビュー待ち and removed 指摘事項あり labels Dec 25, 2025

noborus added 指摘事項あり and removed 再レビュー待ち labels Dec 29, 2025

Fix removed line breaks

00b00a6

github-actions bot added 再レビュー待ち and removed 指摘事項あり labels Dec 31, 2025

noborus reviewed Jan 2, 2026

View reviewed changes

noborus added 指摘事項あり and removed 再レビュー待ち labels Jan 2, 2026

KenichiroTanaka reviewed Jan 10, 2026

View reviewed changes

Fix based on review

407c7ed

github-actions bot added 再レビュー待ち and removed 指摘事項あり labels Jan 13, 2026

KenichiroTanaka approved these changes Jan 13, 2026

View reviewed changes

noborus approved these changes Jan 16, 2026

View reviewed changes

noborus merged commit 20d888e into pgsql-jp:doc_ja_18 Jan 16, 2026
2 checks passed

	<sect4 id="xfunc-guidance-api-mninor-versions">
	<sect4 id="xfunc-guidance-api-minor-versions">

	<sect4 id="xfunc-guidance-abi-mninor-versions">
	<sect4 id="xfunc-guidance-abi-minor-versions">

xfunc.sgmlの18.0対応 #3574

xfunc.sgmlの18.0対応 #3574

Conversation

kiskk commented Dec 24, 2025

翻訳メモ

セクションIDのtypo

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Dec 24, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 24, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

KenichiroTanaka left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

KenichiroTanaka left a comment

Choose a reason for hiding this comment

Uh oh!

noborus left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants