Update for 315 15 0

[snozawa]

315.15.0へのアップデートです。
idlに変更があるため、315.15.0にminorにしました。

以下自分用めも

1. CHANGELOG.rstをつくる

   git clone https://github.com/fkanehiro/hrpsys-base
   cd hrpsys-base
   catkin_generate_changelog
   

   して、CHANGELOGの中身を編集して、
   git commit -m "update CHANGELOG" -a
2. package.xml, CHANGELOG.rst, CMakeLists.txtを変更
   今回はidlに変更がありminorバージョンを挙げるので

   catkin_prepare_release --no-push --bump minor
   

   これでpackage.xml, CHANGELOG.rstが自動でかわるので、CMakeLists.txtの番号を手動でコミットしてコミットをまとめる
3. PRする

[k-okada]

近日中に#1206
でまたIDLが変わるなら，今のうちにいれておくのがいいのでは？

まだまだかなり検討時間が必要ならよいのですが．．

[snozawa]

まだまだかなり検討時間が必要ならよいのですが．．

そうですね。別途 @ishiguroJSK とtagづけするけどどうしましょう、と話し合って、
#1206 は次回にすることにしました。

[snozawa]

FYI : @ishiguroJSK

あまり文章でかくのもアレですが、CHANGELOGなどをかくときのメモを少し詳しめに書きました。
openhrp3は、おそらく1の工程での編集するファイルが少し多いかも（HYSTORY-en, jaなど）

1. CHANGELOG.rstをつくる

   1. git clone

      git clone https://github.com/fkanehiro/hrpsys-base
      cd hrpsys-base
      

   2. CHANGELOG.rstを自動で生成するコマンド

      catkin_generate_changelog
      

      前回tagづけ時からの変更が一覧になって.rstファイルの先頭から追記される

   3. CHANGELOGの中身を編集する
      ii.のCHANGELOR.rstはPRやコミットがdateで並んでるだけなので見やすくする
      hrpsys-baseの場合、

      • Stable RTCとUnstable RTCを分けて書く
      • 個々のRTC（など）ごとに箇条書きして、簡単にサマリをかく
      • 詳しくは過去のtagづけしているPRを参照(Update for 315 13 0 #1138)

   4. CHANGELOG.rstをコミット

      git commit -m "update CHANGELOG" -a CHANGELOG.rst
      

2. バージョン番号をあげるコミット

   1. package.xml, CHANGELOG.rst

      catkin_prepare_release --no-push --bump major
      # か、もしくは
      catkin_prepare_release --no-push --bump minor
      # か、もしくは
      catkin_prepare_release --no-push --bump patch
      

      これでpackage.xml, CHANGELOG.rstが自動でかわり、バージョン番号が上がる(git commitもされている)。
      patch, minor, majorに関しては後述
   2. CMakeLists.txtを変更
      CMakeLists.txtの番号を手動でコミットしてコミットをまとめる

      set(CPACK_PACKAGE_VERSION_MAJOR 315)
      set(CPACK_PACKAGE_VERSION_MINOR 14)
      set(CPACK_PACKAGE_VERSION_PATCH 0)
      

      などの番号を、package.xml, CHANGELOG.rstに基づき適宜あげ、git commitする
   3. 上記２つのコミットを一個にまとめる (git rebase -i HEAD^^など)

3. PRする

4. travis、確認など諸々通ったら、Mergeをお願いする

5. tagづけをお願いする

   git tag 315.xx.yy && git push --tags # xx, yyは実際の番号
   

   をPRのコメントにつけてお願いする

以下はさらなるメモです

• patch, minor, majorなどに関して（前提：IDLの変更はけっこうでかい変更）

  • 軽微で、かつIDLの変更などもないけどあげたい場合は、patchをあげる
  • idlの変更があったら、minorをあげる（https://github.com/fkanehiro/hrpsys-base/pull/1138#issuecomment-302609640）
  • その他大きい変更があったら、majorをあげる（https://github.com/fkanehiro/hrpsys-base/pull/1109#issuecomment-285051627）

  詳細はPR上などで議論

• tagづけなどのタイミングに関して

  • これまでの例だと概ね１カ月１回くらい？（あまり多いと@fkanehiroさんのお手間になる）
  • idlの変更がいいかんじにたまってきたら、minorバージョンをあげて、tagづけするなど

[snozawa]

@fkanehiro さん

ありがとうございます
お手すきの時で構いませんので

git tag 315.15.0 && git push --tags

をお願いいたします。