func.sgmlのPostgreSQL 16.0対応です。 #2796

tatsuo-ishii · 2023-12-15T06:56:52Z

No description provided.

koizumistr

確認しました。

koizumistr · 2023-12-28T12:12:28Z

doc/src/sgml/func1.sgml

@@ -1653,7 +1653,7 @@ NULL引数の数を返す。
 <!--
        Error function
 -->
-《機械翻訳》エラー関数
+エラー関数


誤差関数
というのだと思います。
https://ja.wikipedia.org/wiki/%E8%AA%A4%E5%B7%AE%E9%96%A2%E6%95%B0

そうでしたか！修正します。

koizumistr · 2023-12-28T12:13:27Z

doc/src/sgml/func1.sgml

@@ -1674,7 +1674,7 @@ NULL引数の数を返す。
        Complementary error function (<literal>1 - erf(x)</literal>, without
        loss of precision for large inputs)
 -->
-《機械翻訳》補完的なエラー関数(<literal>1-erf(x)</literal>、ラージ入力の精度の損失なし)
+補完的なエラー関数（<literal>1-erf(x)</literal>、大きな入力における精度の損失なし）


上記のWikipediaによれば
相補誤差関数
というようです。

こちらも修正します。

koizumistr · 2023-12-28T12:17:40Z

doc/src/sgml/func3.sgml

+全ての式がNULLと評価された場合に限って結果はNULLになります。
+（これはSQL標準からの逸脱です。
+標準によれば、結果値は、いずれかの引数がNULLの場合はNULLになります。
+他の一部のデータベースでは、このように動作します）。


）。 -> 。）

修正します。

koizumistr · 2023-12-28T13:40:52Z

（補足情報）
release-16.sgmlでも誤差関数、相補誤差関数としています。

koizumistr · 2023-12-29T07:48:45Z

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

KenichiroTanaka

いくつか気づくところがありましたので見ていただけないでしょうか。

KenichiroTanaka · 2024-01-03T02:46:54Z

doc/src/sgml/func.sgml

-《機械翻訳》分割されたテーブルのパーティションキーの定義を、フォームでは<command>CREATEテーブル</command>の<literal>パーティションBY</literal>句に再構成します。
-(これは逆コンパイルされた再構成であり、コマンドのオリジナル文書ではありません。
+パーティション化テーブルのパーティションキーの定義を、<command>CREATE TABLE</command>の<literal>PARTITION BY</literal>句の形式で再構成します。
+(これは逆コンパイルされた再構成であり、コマンドのオリジナルテキストではありません。


最後の改行は不要かと思います。

修正します。

KenichiroTanaka · 2024-01-03T02:52:17Z

doc/src/sgml/func.sgml

        Only top-level transaction IDs are included in the snapshot;
        subtransaction IDs are not shown;  see <xref linkend="subxacts"/>
        for details.
+-->
+どのトランザクションIDがin-progressなのかを表示するデータ構造である現在の<firstterm>snapshot</firstterm>を返します。
+スナップショットにはトップレベルの尾トランザクションIDだけが含まれます。


「尾トランザクション」→「トランザクション」でしょうか

おっと、修正します。

KenichiroTanaka · 2024-01-03T02:53:45Z

doc/src/sgml/func.sgml

@@ -33478,9 +33450,8 @@ OIDとそれを含むシステム型で指定されるデータベース共有
        a subtransaction ID (subxid);  see <xref linkend="subxacts"/> for
        details.
 -->
-《マッチ度[69.892473]》このスナップショットによると与えられたトランザクションIDが<firstterm>可視</firstterm>か（すなわちスナップショットが取得される前に完了していたか）？
+このスナップショットによると与えられたトランザクションIDが<firstterm>可視</firstterm>か（すなわちスナップショットが取得される前に完了していたか）？
 この関数は副トランザクションIDに対しては正しい答えを返さないことに注意してください。


a subtransaction ID (subxid)の後の(subxid)が訳出されていません。

修正します。"subxid"は翻訳の必要はないと思うので、そのままにしておきます。

KenichiroTanaka · 2024-01-03T02:59:52Z

doc/src/sgml/func.sgml

@@ -33575,7 +33539,7 @@ OIDとそれを含むシステム型で指定されるデータベース共有
        commit status.  This list does not include the transaction IDs of
        subtransactions (subxids).
 -->
-《マッチ度[]》スナップショット時の実行中のトランザクションです。
+スナップショット時の実行中のトランザクションです。
 <literal>xmin &lt;= <replaceable>X</replaceable> &lt;xmax</literal>で、このリストにないトランザクションIDはスナップショット時点ですでに完了しており、コミット状態によって可視あるいはデッドのどちらかです。
 リストには副トランザクションのトランザクションIDは含まれません。


ここも (subxids)を記載した方が良いかと思います。

了解です。

noborus · 2024-01-17T12:25:17Z

doc/src/sgml/func1.sgml

@@ -5191,7 +5190,7 @@ SELECT format('Testing %3$s, %2$s, %s', 'one', 'two', 'three');
        <parameter>bytesremoved</parameter> from the start and end of
        <parameter>bytes</parameter>.
 -->
-<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長のバイトを<parameter>bytes</parameter>の最初と最後から取り除きます。
+<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を<parameter>bytes</parameter>の最初と最後から取り除きます。


Removes the longest string containing only 〜

で始まるtrim系の説明が日本語訳だと統一されていないようなので、これを機に統一するのが良いと思います。

[元]から[対象文字]から取り除きます。
[対象文字]を[元]から取り除きます。

の順番と、

先頭/最初、末尾/最後、取り除きます/削除します、空白一文字がデフォルトです/デフォルトは空白文字
が統一されていた方が良いと思います。
どちらかに統一されていれば良いと思いますが、個人的には

「string/bytes」の先頭、末尾からcharactersに現れる文字のみを有する最長の文字列を取り除きます。

の書き方がわかりやすいと思いました。

個人的には、「有する」より「現れる」の方がわかりやすいと思いました。また、「元」と「対象文字列」の順ですが、必ずしも統一しない方が良いケースがあるように思います。つまり、「元」が長い場合、それを文頭に持ってくると、頭の中でパースするのに負担がかかります。以上を踏まえ、修正前と修正後を示します。いかがでしょう？

---修正前--- btrim <parameter>characters</parameter>（空白一文字がデフォルトです）に現れる文字のみを含む最長の文字列を<parameter>string</parameter>の最初と最後から取り除きます。 ltrim <parameter>string</parameter>の最初から、<parameter>characters</parameter>（デフォルトは空白文字）で指定された文字だけを有する最長の文字列を削除します。 rtrim <parameter>string</parameter>の末尾から、<parameter>characters</parameter>（デフォルトは空白文字）で指定された文字のみを有する最長の文字列を削除します。 trim <parameter>characters</parameter>（空白一文字がデフォルトです）に現れる文字のみを含む最長の文字列を<parameter>string</parameter>の最初、最後、あるいは両方（<literal>BOTH</literal>がデフォルトです）から取り除きます。 ---修正後--- btrim <parameter>characters</parameter>（空白一文字がデフォルトです）に現れる文字のみを含む最長の文字列を<parameter>string</parameter>の最初と最後から取り除きます。 ltrim <parameter>string</parameter>の最初から、<parameter>characters</parameter>（空白一文字がデフォルトです）で指定された文字のみを含む最長の文字列を取り除きます。 rtrim <parameter>string</parameter>の末尾から、<parameter>characters</parameter>（空白一文字がデフォルトです）で指定された文字のみを含む最長の文字列を取り除きます。 trim <parameter>characters</parameter>（空白一文字がデフォルトです）に現れる文字のみを含む最長の文字列を<parameter>string</parameter>の最初、最後、あるいは両方（<literal>BOTH</literal>がデフォルトです）から取り除きます。

btrim,ltrim,rtrimは同じ順で良いと思いました。trimだけ書式が違うので変えても良いかなと思います。
考え直してみましたが、なるべく引数順が理解しやすいかと思いました。

最初 -> 先頭、最後 -> 末尾に統一。

（）の文からつながるように（空白一文字がデフォルトです）→（空白一文字がデフォルト）

string

btrim(string, characters)
<parameter>string</parameter>から<parameter>characters</parameter>（空白一文字がデフォルト）に現れる文字のみを含む最長の文字列を先頭と末尾から取り除きます。
ltrim(string, characters)
<parameter>string</parameter>から<parameter>characters</parameter>（空白一文字がデフォルト）に現れる文字のみを含む最長の文字列を先頭から取り除きます。
rtrim(string, characters)
<parameter>string</parameter>から<parameter>characters</parameter>（空白一文字がデフォルト）に現れる文字のみを含む最長の文字列を末尾から取り除きます。

trim([ LEADING | TRAILING | BOTH ] characters from string)

<parameter>string</parameter>から<parameter>characters</parameter>（空白一文字がデフォルト）に現れる文字のみを含む最長の文字列を先頭、末尾、あるいはその両方（BOTHがデフォルト）から取り除きます。

or

<parameter>characters</parameter>（空白一文字がデフォルト）に現れる文字のみを含む最長の文字列を<parameter>string</parameter>の先頭、末尾、あるいはその両方（BOTHがデフォルト）から取り除きます。

bytes

btrim(bytes, bytesremoved)
<parameter>bytes</parameter>から<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を先頭と末尾から取り除きます。
ltrim(bytes, bytesremoved)
<parameter>bytes</parameter>から<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を先頭から取り除きます。
rtrim(bytes, bytesremoved)
<parameter>bytes</parameter>から<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を末尾から取り除きます。

trim([ LEADING | TRAILING | BOTH ] bytesremoved from bytes)

<parameter>bytes</parameter>から<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を先頭、末尾、あるいはその両方（BOTHがデフォルト）から取り除きます。

or

<parameter>bytesremoved</parameter>に現れるバイトのみを含む最長の文字列を<parameter>bytes</parameter>の先頭、末尾、あるいはその両方（BOTHがデフォルト）から取り除きます。

どうでしょうか？

他の方いかがですか？あまり私はこだわり無いので、反対の方がいなければ斉藤さん案で修正します。

特に反対はないです。

では斉藤さん案で進めます。

田中さんの指摘は、分割したファイルではなくて、func.sgml本体に指摘がされており、この後の斎藤さんの指摘が分割ファイルの方になっているので、一旦田中さんの指摘の分だけコミットします。確認をお願いします。

KenichiroTanaka

ご対応ありがとうございます。

noborus · 2024-02-13T08:26:05Z

doc/src/sgml/func3.sgml

@@ -67,9 +67,9 @@ SQL/JSONパス言語
   data model in the JSON specification
   <ulink url="https://tools.ietf.org/html/rfc7159">RFC 7159</ulink>.
 -->
-《機械翻訳》SQL環境内のJSONデータタイプにネイティブサポートを提供するには、<productname>PostgreSQL</productname><firstterm>SQL/JSONデータモデル</firstterm>を実装します。


この上のindextermでマージのときに間違って「関数と演算子」が2回入ってしまっていました。
関数と式に修正お願いできますでしょうか。

<indexterm zone="functions-json"> <primary>SQL/JSON</primary> <secondary>functions and expressions</secondary> </indexterm> <indexterm zone="functions-json"> <primary>SQL/JSON</primary> <secondary>関数と式</secondary> </indexterm>

了解です。

noborus · 2024-02-18T12:17:27Z

確認しました。対応ありがとうございます。
他はレビュー済みなのでマージします。

func.sgmlのPostgreSQL 16.0対応です。

0d811eb

github-actions bot added the レビュー待ち label Dec 15, 2023

koizumistr reviewed Dec 28, 2023

View reviewed changes

koizumistr added 指摘事項あり and removed レビュー待ち labels Dec 28, 2023

小泉さんの指摘に対応しました。

d355340

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

tatsuo-ishii removed the レビュー待ち label Dec 29, 2023

koizumistr added 他にも誰か見て（レビュー済み） and removed 再レビュー待ち labels Dec 29, 2023

KenichiroTanaka requested changes Jan 3, 2024

View reviewed changes

noborus reviewed Jan 17, 2024

View reviewed changes

github-actions bot added the レビュー待ち label Jan 25, 2024

KenichiroTanaka approved these changes Jan 25, 2024

View reviewed changes

noborus reviewed Feb 13, 2024

View reviewed changes

斎藤さんの指摘(trim etc.とSQL/JSONのindex)に対応しました。

45c310b

noborus merged commit 63965db into pgsql-jp:doc_ja_16 Feb 18, 2024
2 checks passed

tatsuo-ishii deleted the func160 branch August 28, 2024 06:31

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

func.sgmlのPostgreSQL 16.0対応です。 #2796

func.sgmlのPostgreSQL 16.0対応です。 #2796

tatsuo-ishii commented Dec 15, 2023

koizumistr left a comment

koizumistr Dec 28, 2023

tatsuo-ishii Dec 29, 2023

koizumistr Dec 28, 2023

tatsuo-ishii Dec 29, 2023

koizumistr Dec 28, 2023

tatsuo-ishii Dec 29, 2023

koizumistr commented Dec 28, 2023

koizumistr commented Dec 29, 2023

KenichiroTanaka left a comment

KenichiroTanaka Jan 3, 2024

tatsuo-ishii Jan 25, 2024

KenichiroTanaka Jan 3, 2024

tatsuo-ishii Jan 25, 2024

KenichiroTanaka Jan 3, 2024

tatsuo-ishii Jan 25, 2024

KenichiroTanaka Jan 3, 2024

tatsuo-ishii Jan 25, 2024

noborus Jan 17, 2024

tatsuo-ishii Feb 9, 2024

noborus Feb 10, 2024

tatsuo-ishii Feb 17, 2024

koizumistr Feb 17, 2024

tatsuo-ishii Feb 18, 2024

KenichiroTanaka left a comment

noborus Feb 13, 2024

tatsuo-ishii Feb 18, 2024

noborus commented Feb 18, 2024

func.sgmlのPostgreSQL 16.0対応です。 #2796

func.sgmlのPostgreSQL 16.0対応です。 #2796

Conversation

tatsuo-ishii commented Dec 15, 2023

koizumistr left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

koizumistr commented Dec 28, 2023

koizumistr commented Dec 29, 2023

KenichiroTanaka left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

string

bytes

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

KenichiroTanaka left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

noborus commented Feb 18, 2024