「Apache Subveriosn 1.14リリースノート」

遅ればせながら、Apache Apache Subvesrion 1.14のリリースノートの日本語翻訳を掲載します。冗長な表現などは意訳しています。なお、ご利用にあたって弊社は一切の責任を負いませんので、ご利用者の責任の下にお使いください。
（翻訳：たにやん）
Version1.6からの変遷と今後のリリースサイクルの変更も掲載しています。また、チャンネルもあります、合わせてどうぞ。

・Python3.xのサポート
・Python2.7のフェードアウト
・ビルド時の依存関係：py3c
・数多くの改善とバグ修正
・本リリースでの既知の問題

Apache Subversion1.14は以前のすべてのSubversionリリースのスーパーセットであり、現在の「ベスト」と見なされるリリースです。 1.0.x〜1.13.xの機能やバグフィックスも1.14に含まれています。また1.14には以前のリリースにはない機能やバグフィックスが含まれています。
1.14は1.10の次のLTSであるため、1.11-1.13での変更を含む1.10からの主要な変更を記載します。
このページでは、大きな変更点についてのみ説明します。変更の完全なリストについては、CHANGESファイルの1.14セクションを参照してください。

古いクライアントとサーバーは、1.14サーバーとクライアントと透過的に相互に情報通信が可能です。ただし、クライアントとサーバーの両方が最新バージョンでないと、新しい1.14機能の一部が使用できない場合があります。クライアントが新しくサーバが古い場合は新しい動作は効率的に動作しないことがあります。

リポジトリをdump,reloadする必要はありません。 Subversion 1.14サーバーは、以前のバージョンで作成されたリポジトリに読み書きできます。既存のサーバーをアップグレードするには、最新のライブラリとバイナリを古いものに上書きして下さい。

Subversion 1.14は、新しい機能を追加するだけで、古い機能を削除することなく、以前のリリースとのAPI / ABIの互換性を維持します。以前の1.x APIに対して書かれたプログラムは、1.14のライブラリを使用してコンパイルおよび実行できます。しかし、1.14用に書かれたプログラムは、古いライブラリに対してコンパイルあるいは実行できるとは限りません。

古いAPIの動作が以前のリリースから若干でも変更されたケースは限定されています。これらの機能がバグであるとみなされ、したがって改善または削除されたケースです。これらのAPIの内容と、これらの変更がもたらす影響についての詳細は、API erretaを参照してください。

新機能のコンパチビリティ(互換性)テーブル

作業コピーのアップグレード

Subversion 1.14は、Subversion 1.8~1.13と同じ作業コピーフォーマットを使用します。
既存のSubversion 1.7かそれ以前の作業コピーでSubversion 1.14を使用する前に、作業コピーのメタデータを新しい形式にアップグレードするため、svn upgradeコマンドを実行する必要があります。このコマンドは、場合によってはしばらく時間がかかる場合があり、ユーザーによっては、新しい作業コピーを単にチェックアウトするほうが実用的かもしれません。

注意： 1.6でsvnクリーンアップを事前に行わなかった為にアップグレードできなかった作業コピーを、Subversion1.14ではアップグレードすることはできません。つまり、1.8以上にアップグレードする前に、1.6以前の古いクライアントを使用して、クリーンアップが必要なすべての1.6以前の作業コピーに対してsvn cleanupを実行する必要があります。同様に、Subversion 1.14は破損した作業コピーをアップグレードすることはできません。 .svnディレクトリ内のメタデータがないか破損しているため、修正不可能な問題が発生する可能性があります。このような作業コピーへのダメージは永続的であり、アップグレード前にsvnクリーンアップを実行しても修正できません。
作業コピーが正常にアップグレードされない場合は、新しいものをチェックアウトしてください。

実験的「延期」機能の変更

1.10以来、Subversionは実験的なShelving(延期)機能を課題＃3625に対してアドレスするために提供した。実験的な機能は互換性が保証されません。
1.14における延期機のは1.10で提供されているののとは大きく異なっており、互換性がありません。本書に後述されます。1.10の延期を既存の作業コピーでどうリカバリするかについても後述します。

‘svnadmin rev-size’ コマンド

本機能は1.13にて追加されました。
‘svnadmin rev-size’コマンドを追加し、バイトで、rev-propsを含むリビジョンのディスクサイズを表示できるようにしました（ただしFSFSインデックスを除く)。例：
　$svnadmin rev-size /path/to/repo -r1
1337 bytes in revision 1
(r1857624を参照)

‘svnadmin build-repcache’コマンド

レプレゼンテーションシェアリング(rep-sharing)はデータストレージの非複製機能でSubversion1.6にて導入されました。同一のデータを重複せずに一つだけ保存することでディスクスペースを節約するものです。(課題#2286)

このオプショナルな機能はデフォルトで有効になっています。これは複製状態のファイルを特定するためSubversionが自動的にリポジトリに保持しているrep-cacheデータベースに依存してます。
使用しているうちに、管理者が本機能を無効化したり再度有効化することがありますが、無効化した場合にはその間に行われたコミットについてはrep-cacheの管理からは除外されます。
Subversion1.14は’svnadmin build-repcache’サブコマンドを新しく追加し、管理者がrep-cacheデータベースに存在しないエントリーを指定して（あるいは全て）取り込めるようにしました(r1875921)。
例：
$ svnadmin build-repcache /path/to/repo -r20:25
*Processed revision 20.
*Processed revision 21.
*Processed revision 22.
*Processed revision 23.
*Processed revision 24.
*Processed revision 25.
リビジョンを一つだけ与えた場合はそのリビジョンだけ処理します。
$ svnadmin build-repcache /path/to/repo -r20
*Processed revision 20.
リビジョンを与えない場合には、全てのリビジョンが対象になります。

コマンドライン・クライアントの改善（クライアント）

svn log の改善
svn log --quiet と--diff
svn log --quiet と --diffオプションは、相互に排他的ではなくなりました。これによ特定レンジのリビジョン間の違いのみをより簡単に表示できるようになりました。(r1871916)

svn info の改善
svn info --show-item に新しいchangelist アーギュメントを追加しました(r1869481)

ユーザ定義エディターへのパス名アーギュメントのエスケープ・クオート
ユーザ定義(user-defined)のエディタを呼び出す場合、例えば対話でコンフリクト（競合）の解消をする場合、Subversionは編集されるファイルのパス名に含まれる全てのスペシャルキャラクターをエスケープします。これはスペースや他の特殊文字を（ファイル名含む）パス名に含むファイルの編集を行った際に発生していた問題を修正します。(r1874057, r1874093, r1875230)
なお、エスケープを行うのはパス名アーギュメントのみです。以前の通り、エディター自身はシェルから呼び出され、それを起動するユーザはコマンドラインを適切にクオート・エスケープしなければなりません。これは意図的なもので、これによりユーザがコマンドライン・アーギュメントを含むシェルコマンドを構成することが可能になります。エディターのパスのスペースやコマンドラインオプションについてはFAQをご参照ください。(https://subversion.apache.org/faq.html#svn-editor)

ユーザ定義エディターは、次の優先順位で定義できます。

• --editor-cmd コマンドライン・オプション
• $SVN_EDITOR 環境変数
• editor-cmd ラインタイム・コンフィギュレーション・オプション
• $VISUAL 環境変数
• $EDITOR 環境変数

サーバ・サイドの改善

svnadmin dumpはsvn:dateを変換しない#4767
1.11にて追加。
svnadmin dumpは出力でsvn:date リビジョン・プロパティを変換しようとしないこととしました。dumpの出力はリポジトリ内に記録されている値そのままを出力します。

authzルールでの空のグループ定義
1.12にて追加。
SubversionはAuthzによるパスベースの認可において、空のグループ定義を無視することとしました。svnauthzコマンドが空のグループを検知すると警告を出力します。

mod_dav_svnの設定ミスに対してヒントを提供
1.13にて追加。
mod_dav_svnの設定ミスにヒントを追加。重複する設定を見つけた場合で、同じURLに対して２つの設定があった場合、問題が同じ設定を２つ行っている事を示唆します。r1866738

クライアントとサーバの改善

ディスク上の平文のパスワードをデフォルトで無効に
1.12にて追加。
Unixライクなシステムにおいて、クライアント側ディスク上の平文パスワード・ストレージはコンパイル時に無効になっています。代わりにGnome keyring, Kwallet, GPG-Agentといったものをベースにしたパスワード・キャッシュ機構が推奨されています。この変更WindowsやMacOSプラットフォーム（既に暗号化されて格納されている）には影響しません。

リポジトリ・ソースから作業コピーターゲットへのコピーの改善
1.12にて追加。
リポジトリ・ソースから作業コピー・ターゲットへのコピーの動作を改善。
・既にある親ディレクトリを正しくハンドルします。
・ペグ・オペラティブ・リビジョンを正しくハンドルします。(#4785)

svn list の改善
1.12にて追加。
svn listコマンドは動的なカラム割り当てを行う事で長いAuthor名のトランケートを無効にしました。
svn list コマンドは、--human-readable (-H) オプションをサポートし、人が読みやすいサイズを出力します（バイト、キロバイト、メガバイト、ギガバイト、テラバイト、およびペタバイト）。

svn infoの改善
1.12にて追加。
svn infoコマンドはリポジトリの中のファイルサイズを表示できます。ファイルサイズはターゲットのURLである場合だけ表示できます。

svn cleanupの改善
1.12にて追加。
svn cleanupコマンドはバージョン化されていない、または無視されたアイテムを削除する際、ディレクトリを削除します、もしそれが書き込み禁止でも。

APIの変更、改善、言語バインディング（クライアントとサーバ）

Python3.xのサポート
Subversionのいくつかのオプション機能はPython言語を利用しています。SubversionのSwig PythonバインディングとSubversionのテスト・スイートはSubversion3.x（またはそれ以上）をサポートしました。
もちろん、プロジェクトの他の需要に応えるためSubversion Pythonサポートを拡張して他のバージョンを含めるような貢献を歓迎します。後述「Enthusiastic Contributors Welcome」の項目を見てください。

Python 2.7のサポートは徐々に廃止します。

Pythonはオプションです。
2020年1月1日をもって、Python2.7はEOL(End of Life)となりました。すべてのユーザはPython3にPython3への移行が強く推奨されます。
Subversion1.14はLTS(ロング・タイム・サポート)リリースで、2024年までサポートを行いますから、Python2.7のEOLを優に超えます。この期間、コアのSubversion開発者はPython2.7でのテストやサポートやPython2.7でしか起こらないバグなどの修正をコミットできません。

これは、Subversion1.14は技術的にはPython2.7でも動作はする、ということですが、サポートし続ける事が困難と判断されれば1.14のメンテナンス・リリースからは落とします。
もし、どうしてもPython2.7を使い続ける必要があるなら、2022年までサポートされるSubversion1.10を使用してください。Subversion1.10ではPython2.7は外しません。
もちろん、コントリビュータがPython2.7サポートを拡張してくれるのは歓迎します。「Enthusiastic Contributors Welcome」の項目を見てください。

Pythonはオプション
Subversionの基本操作をするのにPythonは必要ありません。Pythonを必要とするのは、Subversionをビルドしたり、SubversionのSWIGバインディングを使うときだけです。どちらも行わないなら、この変更はあなたに影響ありません。

Pythonバインディングは次のような場合に使用されます
　・ViewVCのようなサードパーティプログラム
　・toolsサブディレクトリ下でSubversionと一緒に配布されるスクリプト
　・その他自作のスクリプトなど

もう少し詳細に言うと、次のような事をする場合です。
　・SWIG Pythonバインディングを使用する場合
　・ctypes Pythonバインディングを使用する場合
　・Windows上でSubversionをビルドする場合
　・Unixライクなシステム上でtarballからSubversionをビルドし、
　　Subversionのテスト・スイートを実行する場合
　・Subverison（ApacheのSubversionプロジェクト）自身のリポジトリから
チェックアウトした作業コピーからSubversionをビルドする場合
　・SWIG Pythonバインディングをビルドする場合
　・ctypes Pythonバインディングをビルドする場合

Pythonは次の場合には不要です。
　・svn, svnadmin, svnsyncなどのコアなコマンドライン・バイナリを使う
　　場合
　・SubversionのC言語ライブラリを使用する場合
　・Subversionの他の言語のバインディングを使用する場合
　・Unixライクなシステム上でtarballからSubversionをビルドするが、
　　Subversionのテスト・スイートを使用しない場合

ビルド時の依存関係：py3c
SubversionのPython3.x SWIGバインディングのサポートは、C言語拡張へのPython3互換性レイヤ(py3c)に依存します。
SWIG Pythonバインディングをビルドするには、Pythonのバージョンに関わらずpy3cが必要です。py3cはヘッダのみのライブラリなので、ビルドする際には必要ですが使用する場合には必要ありません。
Subversionの最小限のビルド時の依存モジュールをダウンロードするコンバージェンス（集約）スクリプトであるget-deps.shは、py3cをダウンロードするようにアップデートされました。このスクリプトはソース配布のルート・ディレクトリにあります。Subversionの依存のフル・リストは同じディレクトリにあるインストールファイルを見てください。

Python3上でSWIG4でのビルドをサポート
本セクションは、Subversionを作業コピーからビルドする場合のみ影響します。tarballやZipファイルからビルドされる方はスキップしてください。

SubversionのSWIG PythonバインデイングはPython3上でSWIG4とビルドできます。このバインディングはPython3上でSWIG3.xともビルドできます。(SWIGに-modern argumentが自動的に使われます) (r1869853)

JavaHLアップデート
1.11にて追加。
JavaHLバインディングは、Java10と互換性を持つようにアップデートされました。ビルドの変更により、JavaHLはJava8以上が必要となります。

Subversion1.14はいくつかの「実験的な」機能を含んでいます。これらはテスト、フィードバック、そしてさらなる開発にユーザが貢献してもらえるよう誘導するため未熟な状態でリリースされています。
警告：「実験的」な機能やAPIは1.14以降のリリースについて大きく変更され互換性がなくなる可能性があります。互換性を保持することは約束されません。それが「実験的」である間、ポイント・リリースレベルでも、です。

シェルビング（延期）とチェックポイント（実験的）

Viewspec出力コマンド（実験的）(#4753)

1.11にて追加されました。
これは実験的なコマンドで、現在の作業コピーの様子を出力(view spec)します。
View specは各サブツリーが限られた深さを持ち、除外され、異なるURLにスイッチされているか、異なるリビジョン番号にアップロードされていないかを親ディレクトリと比較して出力します。この情報は時に、シェイプ、や作業コピーのレイアウトと呼ばれます。

‘svn info --x-viewspec=classic’は古いスクリプトtools/client-side/svn-viewspec.pyのフォーマットで出力します。

‘svn info --x-viewspec=svn11’は、svnコマンドラインのシリーズを出力します。このコマンドを実行する事で、同じレイアウトの新しい作業コピーを作る事ができます。

Subversion1.14にはいくつかの既知の課題があります。1.14.xのリリースで解消される可能性があります。

Python3のサポートは不完全

Subversionのディストリビューションに含まれるPythonスクリプトの中にはPython3をサポートしていないものがあります。Pythonスクリプトに関する詳細なリストはこちらです。
Python3に対応したもの(ステータスはこちら)は、将来のリリースに入っていく可能性があります。

ビルドシステムはPython3よりもPython2を優先
SubversionのビルドではPythonは必ずしも必要ありませんが、テストスイートを実行する際には必要です。したがって、Unixライクなシステムでは、SubversionのビルドシステムはPythonの実行ファイルを探します。
ビルドシステムは、$PYTHON, $PYTHON2, $PYTHON3環境変数をこの順番でチェックし、続いてコマンド名をpython, python2, phthon3（＄PATH中）をこの順でチェックします。これらのうち、最初に見つけたPython2.7以上の実行ファイルが使用されます。
Python2.7は徐々に廃止のため、我々は1.14のパッチリリースでPython2.7よりPython3を優先するよう変更する積りです。その場合、CHANGEファイルで言及し、リリースノートのこのセクションを更新します。
これは、tarballからのビルド(configureを使う)と作業コピービルド（autogen.sh）の両方に影響します。リリースのローリング・スクリプトにも影響します。
ワークアラウンドとして、configureかautogen.shを実行する前に、環境変数PYTHONにPython3の実行モジュールのフルパスをセットできます。

Rubyバインディングはswig3.0.9が必要に

1.11にて変更されました。
このセクションは、作業コピーからSubversionをビルドする場合にのみ影響があります。Tarballやzipからビルドする場合はスキップしてください。
RubyバインディングはSwigの課題#602の不具合のため(308に特有の問題)ビルドされないことがわかっています。Swig3.0.9かそれ以降を使用すしてください。
PerlとPythonのバインディングは影響されません。

Subversion 1.14.xはロング・ターム・サポート(LTS)版

1.14はロング・ターム・サポート(LTS)リリースです。
https://subversion.apache.org/docs/release-notes/#supported-versions
https://subversion.apache.org/roadmap.html#release-planning
(日本語参考)https://ossplaza.com/oss_column/svn_release_cycle_chg_2018.html

Subversion1.13はEnd of Life(EOL)となります

Subversion 1.13はEnd of Life(EOL)となります。これはインストール済みの1.13が動作しなくなる、という事ではありません。1.13を特に問題なく使用して満足している場合は、そのまま使用できます。”End of Life”は1.13に対するバグレポートの受付を終了し、1.13の開発・保守を終了することです。

Subversion 1.10は安定版となります

Subversion1.10.xは（古い）安定版となります。これはセキュリティ関係とバグ修正をまだ受け入れることを意味します。バグのレポートは重要度を鑑みて評価しますが、重要度が低い場合には、1.14にしか対応しない場合があります。特に、内部の深い部分の問題や不安定になる可能性がある場合、あるいはバックポートに大きな投資が必要となる場合です。
したがって、安定版で何か問題があって最新版では修正されている場合、私たちは問題を解決するためにはバージョンアップをお勧めするかもしれません。

Subversion1.9はEnd of Life(EOL)となります

Subversion 1.9はEnd of Life(EOL)となります。これはインストール済みの1.9が動作しなくなる、という事ではありません。1.9を特に問題なく使用して満足している場合は、そのまま使用できます。”End of Life”は1.9に対するバグレポートの受付を終了し、1.9の開発・保守を終了することです。

あなたもSubversionに貢献できます。
Subversionはオープンソース・プロジェクトでボランティアによって開発やサポートが行われています。コミュニティでは熱心に活動していただける参加者を募集しています。
Pythonのサポートバージョンの追加やシェルフ・チェックポインティングの仕上げ、その他新しい大きな機能に興味があるかもしれません。その努力を投資してくださるなら、Subversionはあなたの思うものなんでもありです。

e-mailで会話に参加する：メーリングリストを参照
https://subversion.apache.org/mailing-lists.html

IRCでは、irc.freenode.netL
#svn channel: User chat and help using Subversion
#svn-dev channel: Get involved in development!
ソースを取得する場合(SubversionまたはGit)
　$ svn checkout https://svn.apache.org/repos/asf/subversion/trunk/
$ git clone https://github.com/apache/subversion.git

最新版のTarballは、
https://subversion.apache.org/download.cgi

ぜひご参加を。