<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry 
  PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="release">
<refmeta>
  <refentrytitle role='top_of_page' id='release.top_of_page'>Cutterのリリース方法</refentrytitle>
  <refmiscinfo>CUTTER Library</refmiscinfo>
</refmeta>
<refnamediv>
  <refname>Cutterのリリース方法</refname>
</refnamediv>
<refsect1>
  <title>はじめに</title>
  <para>このセクションではCutterをリリースするときに必要な手順について 説明します。</para>
</refsect1>

<refsect1>
  <title>sourceforge.netアカウントの設定</title>
  <para>
  Cutterは
  <ulink url='http://sourceforge.net/'>&lt;URL:http://sourceforge.net/&gt;</ulink>
  にて
  <ulink url='http://cutter.sourceforge.net'>プロジェクトのウェブサイト</ulink>
  や
  <ulink url='https://sourceforge.net/projects/cutter/files/'>プラットフォームごとのリポジトリなど</ulink>
  をホスティングしています。
</para>
  <para>そのため、リリース作業ではsourceforge.net上のプロジェクト領域へ アクセスできる必要があります。</para>
  <para>Cutterプロジェクトのメンバでない場合にはプロジェクトの 管理者にsourceforge.netのアカウント名を以下のProject Membershipページ から追加してもらう必要があります。</para>
  <para>
  <ulink url='https://sourceforge.net/project/admin/project_membership.php?group_id=208375'>Cutter - Project Membership</ulink>
  
</para>
</refsect1>

<refsect1>
  <title>環境変数の設定</title>
  <para>Cutterのリリースではすでに述べたようにsourceforge.netへの パッケージやドキュメントファイルのアップロードを行います。</para>
  <para>
  もし、リリース作業を行う端末のアカウントと sourceforge.netのアカウントが異なる場合には、 以下のようにしてsourceforge.netのアカウントを使うように 環境変数
  <code>SF_USER</code>
  の設定を行います。
</para>
  <programlisting>% export SF_USER=(ここにsourceforge.netのアカウントを指定)</programlisting>
  <para>永続的に有効にする場合にはシェルの設定ファイルに上記記述を追加します。</para>
</refsect1>

<refsect1>
  <title>ビルド環境の準備</title>
  <para>以下にCutterのリリース作業を行うために事前にインストール しておくべきパッケージを示します。</para>
  <para>なお、ビルド環境としては Debian GNU/Linux (sid)を前提として説明しています。 その他の環境ではパッケージ名等適宜読み替えて下さい。:</para>
  <programlisting>% sudo apt-get install -V debootstrap createrepo rpm ruby-full gnupg2 gtk-doc-tools gnome-doc-utils</programlisting>
  <para>また、rubyでいくつかパッケージが必要なので以下のコマンドによりインストールします。:</para>
  <programlisting>% sudo gem install rdtool fast_gettext mechanize</programlisting>
  <para>なお、特に明記していない限り本リリース手順でのコマンドラインの 操作はzshを前提としています。</para>
</refsect1>

<refsect1>
  <title>パッケージ署名用秘密鍵のインポート</title>
  <para>リリース作業ではパッケージに対する署名を行います。 その際、パッケージ署名用の鍵が必要です。</para>
  <para>Cutterプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化して リポジトリのpackages/ディレクトリ以下へと登録しています。</para>
  <para>リリース担当者はリポジトリに登録された秘密鍵を復号した後に 鍵のインポートを以下のコマンドにて行います。:</para>
  <programlisting>% cd packages
% gpg --decrypt release-key-secret.asc.gpg.(担当者) &gt; (復号した鍵ファイル)
% gpg --import  (復号した鍵ファイル)</programlisting>
  <para>
  鍵のインポートが正常終了すると 
  <code>gpg --list-keys</code>
   でCutterの署名用の鍵を 確認することができます。:
</para>
  <programlisting>pub   1024D/F07C74AC 2012-08-07
uid                  Cutter Key (Cutter Official Signing Key) &lt;cutter-users-en@lists.sourceforge.net&gt;</programlisting>
  <para>鍵をインポートしただけでは使用することができないため、インポートした鍵に対してtrust,signを行う必要があります。</para>
  <para>以下のコマンドを実行して署名を行います。(途中の選択肢は省略):</para>
  <programlisting>% gpg --edit-key cutter-users-en@lists.sourceforge.net
gpg&gt; trust
gpg&gt; sign
gpg&gt; save
gpg&gt; quit</programlisting>
  <para>鍵のインポート作業は初めてリリースを行うときや、 鍵が更新された場合に行います。</para>
</refsect1>

<refsect1>
  <title>リリース作業用ディレクトリの作成</title>
  <para>Cutterのリリース作業ではリリース専用の環境下(コンパイルフラグ)で ビルドする必要があります。</para>
  <para>リリース時と開発時でディレクトリを分けずに作業することもできますが、 誤ったコンパイルフラグでリリースしてしまう危険があります。</para>
  <para>
  そのため、以降の説明では
  <code>$HOME/work/cutter</code>
  以下のディレクトリに リリース用の作業ディレクトリ(cutter.clean)を作成したものとします。
</para>
  <programlisting>% mkdir -p $HOME/work/cutter</programlisting>
  <para>
  これ以降
  <code>CUTTER_CLEAN_DIR=$HOME/work/cutter/cutter.clean</code>
  として説明します。
</para>
  <para>
  リリース用のクリーンな状態でソースコードを
  <code>$CUTTER_CLEAN_DIR</code>
  ディレクトリに 取得するために以下のコマンドを実行します。:
</para>
  <programlisting>% git clone git@github.com:clear-code/cutter.git cutter.clean</programlisting>
  <para>この作業はリリース作業ごとに行います。</para>
</refsect1>

<refsect1>
  <title>autogen.shによるconfigureスクリプト生成</title>
  <para>ソースコードをcloneした時点ではconfigureスクリプトが含まれておらず そのままmakeコマンドにてビルドすることができません。</para>
  <para>
  Cutterの
  <code>$CUTTER_CLEAN_DIR</code>
  ディレクトリでautogen.shを以下のように実行します。:
</para>
  <programlisting>% sh autogen.sh</programlisting>
  <para>このコマンドの実行により、configureスクリプトが生成されます。</para>
</refsect1>

<refsect1>
  <title>configureによるMakefile生成</title>
  <para>Makefileを生成するためにconfigureスクリプトを実行します。</para>
  <para>リリース用にビルドするためには以下のオプションを指定してconfigureを実行します。:</para>
  <programlisting>% ./configure --enable-gtk-doc</programlisting>
</refsect1>

<refsect1>
  <title>リリース日の更新</title>
  <para>configureを実行し、Makefileを生成した後に リリース日やバージョンの更新を行うためにmake update-latest-releaseを実行します。</para>
  <para>
  <code>make update-latest-release</code>
  コマンドでは
  <code>OLD_RELEASE_DATE</code>
  に前回のリリースの日付を、
  <code>NEW_RELEASE_DATE</code>
  に次回リリー スの日付を指定します。
</para>
  <para>1.2.1のリリースを行った際は以下のコマンドを実行しました。::</para>
  <programlisting>% make update-latest-release OLD_RELEASE=1.2.0 OLD_RELEASE_DATE=2011-12-31 NEW_RELEASE_DATE=2012-08-15</programlisting>
  <para>これにより、Webサイトのトップページのソース (index.html,index.html.ja)や パッケージのspecファイルなどの関連ファイルが更新されます。</para>
</refsect1>

<refsect1>
  <title>変更点まとめ</title>
  <para>前回リリース時からの変更点をNEWSおよびNEWS.jaへとまとめます。 ここでまとめた内容についてはリリースアナウンスにも使用します。</para>
  <para>前回リリースからの変更履歴を参照するには以下のコマンドを実行します。：</para>
  <programlisting>% git log -p --reverse $(git tag | tail -1)..</programlisting>
  <para>ログを^commitで検索しながら、以下の基準を目安として変更点を追記してい きます。</para>
  <para>含めるもの</para>
  <itemizedlist>
  <listitem>
  <para>ユーザへ影響するような変更</para>
</listitem>
  <listitem>
  <para>互換性がなくなるような変更</para>
</listitem>
</itemizedlist>
  <para>含めないもの</para>
  <itemizedlist>
  <listitem>
  <para>内部的な変更(変数名の変更やらリファクタリング)</para>
</listitem>
</itemizedlist>
</refsect1>

<refsect1>
  <title>メッセージカタログの更新</title>
  <para>ドキュメントの最新版と各国語版の内容を同期するために、 poファイルの更新を以下のコマンドにて実行します。:</para>
  <programlisting>% make update-po</programlisting>
  <para>make update-poを実行すると、各種poファイルが更新されます。</para>
  <para>その後に更新した各種.poファイルを翻訳します。</para>
  <para>翻訳結果をHTMLで確認するために、以下のコマンドを実行します。:</para>
  <programlisting>% make -C doc</programlisting>
  <para>コマンドの実行により、HTMLは以下の階層に生成されます。</para>
  <itemizedlist>
  <listitem>
  <para>
  <code>$CUTTER_CLEAN_DIR/doc/reference/html</code>
   英語リファレンス
</para>
</listitem>
  <listitem>
  <para>
  <code>$CUTTER_CLEAN_DIR/doc/reference/ja/html</code>
   日本語リファレンス
</para>
</listitem>
</itemizedlist>
  <para>確認が完了したら、翻訳済みpoファイルをコミットします。</para>
</refsect1>

<refsect1>
  <title>リリースタグの設定</title>
  <para>リリース対象のファイルの更新が終了したら以下のコマンドでタグを打ちます。:</para>
  <programlisting>% make tag</programlisting>
</refsect1>

<refsect1>
  <title>リリース用アーカイブファイルの作成</title>
  <para>
  リリース用のソースアーカイブファイルを作成するために 以下のコマンドを
  <code>$CUTTER_CLEAN_DIR</code>
  で実行します。:
</para>
  <programlisting>% make dist
% make dist-zip</programlisting>
  <para>
  これにより
  <code>$CUTTER_CLEAN_DIR/cutter-(バージョン).tar.gz</code>
  と
  <code>$CUTTER_CLEAN_DIR/cutter-(バージョン).zip</code>
  とが作成されます。
</para>
</refsect1>

<refsect1>
  <title>パッケージのビルド</title>
  <para>リリース用のアーカイブファイルができたので、 パッケージ化する作業を行います。</para>
  <para>パッケージ化作業は以下の2種類を対象に行います。</para>
  <itemizedlist>
  <listitem>
  <para>Debian系(.deb)</para>
</listitem>
  <listitem>
  <para>Red Hat系(.rpm)</para>
</listitem>
</itemizedlist>
  <refsect2>
  <title>Debian系パッケージのビルド</title>
  <para>現在サポートされているのは以下の通りです。</para>
  <itemizedlist>
  <listitem>
  <para>squeeze i386/amd64</para>
</listitem>
  <listitem>
  <para>wheezy i386/amd64</para>
</listitem>
  <listitem>
  <para>unstable i386/amd64</para>
</listitem>
  <listitem>
  <para>lucid i386/amd64</para>
</listitem>
  <listitem>
  <para>natty i386/amd64</para>
</listitem>
  <listitem>
  <para>oneiric i386/amd64</para>
</listitem>
  <listitem>
  <para>precise i386/amd64</para>
</listitem>
  <listitem>
  <para>quantal i386/amd64</para>
</listitem>
</itemizedlist>
  <para>
  なお以下のコマンドの実行は
  <code>$CUTTER_CLEAN_DIR/packages/apt</code>
  以下で 行っているものとします。
</para>
  <refsect3>
  <title>ダウンロード</title>
  <para>既存のDebian系リポジトリと同期するために以下のコマンドを実行します。:</para>
  <programlisting>% make download</programlisting>
</refsect3>

  <refsect3>
  <title>パッケージのビルド</title>
  <para>パッケージをビルドするために以下のコマンドを実行します。:</para>
  <programlisting>% make build PALALLEL=yes</programlisting>
  <para>make build PALALLEL=yesコマンドを実行すると、ディストリビューションの リリースとアーキテクチャの組み合わせでビルドを平行して行うことができます。</para>
</refsect3>

  <refsect3>
  <title>パッケージへの署名</title>
  <para>生成したパッケージへの署名を行うには以下のコマンドを実行します。:</para>
  <programlisting>% make sign-packages</programlisting>
</refsect3>

  <refsect3>
  <title>リポジトリの更新</title>
  <para>リリース対象のファイルをリポジトリに反映するには以下のコマンドを実行します。:</para>
  <programlisting>% make update-repository</programlisting>
</refsect3>

  <refsect3>
  <title>リポジトリへの署名</title>
  <para>リポジトリにGnuPGで署名を行うために以下のコマンドを実行します。:</para>
  <programlisting>% make sign-repository</programlisting>
</refsect3>

</refsect2>

  <refsect2>
  <title>Red Hat系パッケージのビルド</title>
  <para>現在サポートされているのは以下の通りです。</para>
  <itemizedlist>
  <listitem>
  <para>centos-5 i386/x86_64</para>
</listitem>
  <listitem>
  <para>centos-6 i386/x86_64</para>
</listitem>
  <listitem>
  <para>fedora-17 i386/x86_64</para>
</listitem>
</itemizedlist>
</refsect2>

  <refsect3>
  <title>ダウンロード</title>
  <para>既存のRed Hat系リポジトリと同期するために以下のコマンドを実行します。:</para>
  <programlisting>% make download</programlisting>
</refsect3>

  <refsect3>
  <title>パッケージのビルド</title>
  <para>パッケージを作成するには以下のコマンドを実行します。:</para>
  <programlisting>% make build PALALLEL=yes</programlisting>
  <para>make build PALALLEL=yesコマンドを実行すると、ディストリビューションの リリースとアーキテクチャの組み合わせでビルドを平行して行うことができます。</para>
</refsect3>

  <refsect3>
  <title>パッケージへの署名</title>
  <para>リリース対象のRPMに署名を行うには以下のコマンドを実行します。:</para>
  <programlisting>% make sign-packages</programlisting>
</refsect3>

  <refsect3>
  <title>リポジトリの更新</title>
  <para>リリース対象のファイルをリポジトリに反映するには以下のコマンドを実行します。:</para>
  <programlisting>% make update-repository</programlisting>
</refsect3>

</refsect1>

<refsect1>
  <title>パッケージのインストール確認</title>
  <para>ビルドしたパッケージに対しリリース前の動作確認を行います。</para>
  <para>Debian系もしくはRed Hat系の場合には本番環境へとアップロードする前に ローカルのaptないしyumのリポジトリを参照して正常に更新できることを確認します。</para>
  <para>そのためには、リポジトリをwebサーバ経由で参照できるようにすることが 必要です。</para>
  <para>また、sourceforge.netとディレクトリ階層を揃える必要があります。</para>
  <para>
  sourceforge.netとディレクトリ階層を合わせるために
  <code>$CUTTER_CLEAN_DIR/packages</code>
  ディレクトリで以下のコマンドを実行します。
</para>
  <programlisting>% ./check-utility.sh --setup-temp-repository</programlisting>
  <para>コマンドを実行するとtemp_repositories/project/cutterディレクトリを作成し、 apt/repositoriesやyum/repositoriesのディストリビューションの ディレクトリへとシンボリックリンクを張ります。</para>
  <programlisting>% ls -la temp_repositories/project/cutter
total 24
drwxrwxr-x 2 khayashi khayashi 4096 Aug  9 17:21 .
drwxrwxr-x 3 khayashi khayashi 4096 Aug  9 17:14 ..
lrwxrwxrwx 1 khayashi khayashi   72 Aug  9 17:21 centos -&gt; /home/khayashi/work/cutter/cutter.clean/packages/yum/repositories/centos
lrwxrwxrwx 1 khayashi khayashi   72 Aug  9 17:21 debian -&gt; /home/khayashi/work/cutter/cutter.clean/packages/apt/repositories/debian
lrwxrwxrwx 1 khayashi khayashi   72 Aug  9 17:21 fedora -&gt; /home/khayashi/work/cutter/cutter.clean/packages/yum/repositories/fedora
lrwxrwxrwx 1 khayashi khayashi   72 Aug  9 17:21 ubuntu -&gt; /home/khayashi/work/cutter/cutter.clean/packages/apt/repositories/ubuntu</programlisting>
  <para>次にrubyを利用してリポジトリをwebサーバ経由で参照できるようにします。:</para>
  <programlisting>% sudo ruby1.9.1 -run -e httpd -- temp_repositories</programlisting>
  <para>これでchroot環境においてhostsファイルを書き換えて downloads.sourceforge.netがローカルホストを参照するようにすれば、 ローカルに構築したリポジトリの確認を行えます。</para>
</refsect1>

<refsect1>
  <title>リリースアナウンスの作成</title>
  <para>リリースの際にはリリースアナウンスをメーリングリストへと流します。</para>
  <para>NEWS,NEWS.jaにまとめておいた変更点を元にリリースアナウンスを作成します。</para>
  <para>リリースアナウンスには以下を含めます。</para>
  <itemizedlist>
  <listitem>
  <para>インストール方法へのリンク</para>
</listitem>
  <listitem>
  <para>リリースのトピック紹介</para>
</listitem>
  <listitem>
  <para>リリース変更点へのリンク</para>
</listitem>
  <listitem>
  <para>リリース変更点(NEWS,NEWS.jaの内容)</para>
</listitem>
</itemizedlist>
  <para>リリースのトピック紹介では、これからCutterを使う人へアピールする点や 既存のバージョンを利用している人がアップグレードする際に必要な情報を提供します。</para>
  <para>非互換な変更が含まれるのであれば、回避方法等の案内を載せることも重要です。</para>
</refsect1>

<refsect1>
  <title>アップロード作業</title>
  <para>パッケージのインストール確認が完了したら、 アップロード作業を行います。</para>
  <refsect2>
  <title>ドキュメントのアップロード</title>
  <para>
  <code>$CUTTER_CLEAN_DIR</code>
  ディレクトリで以下のコマンドを実行します。:
</para>
  <programlisting>% make upload</programlisting>
</refsect2>

  <refsect2>
  <title>パッケージのアップロード</title>
  <para>
  <code>$CUTTER_CLEAN_DIR/packages/apt</code>
  ディレクトリで以下のコマンドを実行します。:
</para>
  <programlisting>% make upload</programlisting>
  <para>
  <code>$CUTTER_CLEAN_DIR/packages/yum</code>
  ディレクトリで以下のコマンドを実行します。:
</para>
  <programlisting>% make upload</programlisting>
</refsect2>

  <refsect2>
  <title>ソースパッケージのアップロード</title>
  <para>
  <code>$CUTTER_CLEAN_DIR</code>
  ディレクトリで以下のコマンドを実行します。:
</para>
  <programlisting>% make release-official
% make release-debian</programlisting>
  <para>SF.netにtar.gzをアップロードしたあとに、最新版へのリンクを更新するには、 次のようにする。例: 1.2.3の場合</para>
  <para>https://sourceforge.net/projects/cutter/files/cutter/1.2.3/にアクセス し、(i)マークのView detailsリンクをクリックしファイルプロパティを表示する。 Default download forという項目があるので、zipはwindows、tar.gzはその他 というようにチェックを入れると最新版へのリンクが更新される。</para>
</refsect2>

</refsect1>

<refsect1>
  <title>リリースアナウンス</title>
  <para>Cutterにはユーザー向けに提供されているメーリングリストが2つあります。</para>
  <para>あらかじめ用意しておいた、リリースアナウンス原稿を [ANN] Cutter (バージョン)という件名で投稿します。</para>
  <itemizedlist>
  <listitem>
  <para>cutter-users-en@sourceforge.net 英語</para>
</listitem>
  <listitem>
  <para>cutter-users-ja@sourceforge.net 日本語</para>
</listitem>
</itemizedlist>
</refsect1>

<refsect1>
  <title>リリース後にやること</title>
  <para>リリースアナウンスまで終わるとリリース作業はひとまず終了し、 次期バージョンの開発が始まります。</para>
  <para>そこで、次期リリースバージョンを更新します。</para>
  <para>configure.acの以下の箇所を必要に応じて更新します。:</para>
  <programlisting>m4_define([cutter_version_major], [1])
m4_define([cutter_version_minor], [2])
m4_define([cutter_version_micro], [2])
m4_define([cutter_version],
          [cutter_version_major.cutter_version_minor.cutter_version_micro])</programlisting>
</refsect1>
</refentry>
