これまでバージョンアップ時にPostgreSQL本家の更新と日本語マニュアルの更新をマージしていました。

例:

元の原文

<para>
原文１.
原文２.
</para>

日本語訳を追加

<para>
<!--
原文１.
原文２.
-->
日本語１。
日本語２。
</para>

バージョンアップで「原文３」が追加されるとマージした時にコンフリクトが発生。 原文３と-->日本語１。日本語２が同じ箇所で追加されていることになる。 これをバージョンアップ側で優先してマージする（原文３は必要なため）と以下のようになります。

<para>
<!--
原文１.
原文２.
原文３.
</para>

原文３が追加されたため日本語訳は一旦削除されるのは問題ないですが、「コメントの開始」が残ったままになってしまいます。 マージ後はこれを削除又は「コメントの終了」を入れ直して解消する必要がありました。

gitのマージでは限界がありました。

そのため、コンフリクトが発生する場合はgitのマージは使用せずに方式を変更しました。

<para>
<!--
原文１.
原文２.
-->
日本語１。
日本語２。
</para>

の文章から「原文１.原文２.」と「日本語１。日本語２。」の英日ペアのリストを作って抽出します。

そして、「原文１.原文２.」と一致する箇所が現れたらコメントアウトして「日本語１。日本語２。」を追加する（書き換える）方式にしました。

その場合だと「原文３.」が追加されたような場合に「原文１.原文２.」と「原文１.原文２.原文３.」で一致しないことで 余分なコメント開始タグが残らないようになります。

<para>
原文１.
原文２.
原文３.
</para>

ただ、「原文３.」のみが別の行で追加されただけの場合は、「原文１.原文２.」と一致してしまうので

<para>
<!--
原文１.
原文２.
-->
日本語１。
日本語２。
原文３.
</para>

のように書き換えされる場合があります。これ自体はビルドは通るので手動で修正することになります。

これにより、ビルドが通らなくなる不具合は減りますが、軽微な修正が入ると日本語訳がどんどん一旦削除されることになります。 そのため書き換え後のファイルに対して日本語訳（コメント）がない<para></para>と似た文がないかリストから探し出して、 ある程度似ている文があったら《マッチ度:90.00000》のような文と共に書き換えています。 この場合加わった箇所を書き足して修正すればよいことになります。

<para>
<!--
原文１.
原文２. 原文３.
-->
《マッチ度:90.00000》日本語１。
日本語２。
</para>

↓修正

<para>
<!--
原文１.
原文２. 原文３.
-->
日本語１。
日本語２。日本語３。
</para>

類似とは言えないほど書き変わった文や新しく追加された節はそのまま残りますが、下訳として機械翻訳した文を追加することにしました。 追加されるのは<para></para>で日本語訳（コメント）がなく、類似文もなかった場合で、 さらに<para></para>内に<programlisting>等のブロックタグが入らない場合に《機械翻訳》を頭に付けて書き換えます。

<para>
<!--
原文１.
-->
《機械翻訳》日本語１。
</para>

<programlisting>があるとどこまでが英語の原文となるかが、また変わるのでまだ対応していません。