packnga 0.9.2 → 0.9.3

data/Rakefile

@@ -76,4 +76,5 @@ end
 
 Packnga::ReleaseTask.new(spec) do |task|
   task.index_html_dir = "../rroonga/doc/html"
+  task.changes = File.read("doc/text/news.textile").split(/^h2\.\s(.*)$/)[2]
 end

data/doc/text/news.textile

@@ -1,5 +1,21 @@
 h1. NEWS
 
+h2. 0.9.3: 2011-09-22
+
+h3. Improvements
+
+* Printed newline after getting password.
+* Added task "release:rubyforge:news:post" to post news to RubyForge.
+
+h3. Changes
+
+* Changed name of tasks for update po file for each languages.
+(For example, "translate:po:ja:update" was changed to "translate:po:update:ja".)
+
+h3. Fixes
+
+* Applied version number to tag message instead of "version".
+
 h2. 0.9.2: 2011-08-29
 
 h3. Improvements

data/doc/text/release.textile

@@ -0,0 +1,295 @@
+h1. リリース手順
+
+h2. news.textileに前回リリースからの変更点のまとめ
+
+前回のリリース時から現在までの変更点をnews.textileにまとめるため、下記コマンドを実行してgitのコミットログを表示する。
+
+<pre>
+$ git log -p --reverse （前回のリリースバージョン)..
+</pre>
+
+ログを"Author:"で検索しながら、ユーザにとって知る必要があるもの（ユーザに見える情報）のコミットログのみを抜き出す。
+その動詞を過去形にし、頭文字を大文字にする。
+それらログをそれぞれを次のようにまとめる。
+機能などに新しく追加されたものに関してはImprovement,
+動作の変更などはChanges,
+バグの修正など前バージョンまでにあった問題を修正したものはFixesに記述する。
+また、コミットログの行末に[人名]がある場合はその人名をThanks以下に書く。
+この作業をリリース予定日よりも前に行った場合は、目に見えるところにコミットIDをメモしておく。
+news.textileだと次のrake reference:po:updateで翻訳対象になってしまいノイズになってしまうので注意すること。
+
+h3. news.textileの1リリース分のテンプレート
+
+<pre>
+h2. （リリースするバージョン）: リリース日（yyyy-mm-dd）
+
+h3. Improvements
+
+* 
+
+h3. Changes
+
+* 
+
+h3. Fixes
+
+* 
+
+h3. Thanks
+</pre>
+
+h2. 日本語訳の作成
+
+下記コマンドを実行してja.poを更新する。
+
+<pre>
+$ rake reference:po:update
+</pre>
+
+その後、ja.poを開いて、各msgid（コミットログ）に対応するmsgstrにコミットログの和訳を作成する。
+fuzzyを検索して見つかったらC-iで消す。
+
+h2. リファレンスの確認
+
+下記コマンドを実行して、リファレンスの翻訳を行う。
+
+<pre>
+$ rake reference:translate
+</pre>
+
+doc/reference/ja/file.news.htmlなどのja.poを編集した箇所を確認する。
+
+h2. バージョンとリリース日の更新
+
+下記コマンドを入力して、プロジェクトページ（html/index.html、html/index.html.ja）のrroongaの項にある最新バージョンとリリース日をそれぞれ今回のリリースに合わせたものに更新する。
+
+<pre>
+$ rake release:info:update OLD_VERSION=（前回リリース時のバージョン） OLD_RELEASE_DATE=（前回リリース日） RELEASE_DATE=（今回のリリース日）
+</pre>
+
+TODO:別パッケージで同じ日付があった場合にそちらも更新されてしまうので、バージョンと日付どちらも当てはまる部分のみ更新するようにしたほうがいい。
+
+h2. gemパッケージの作成
+
+下記コマンドを打ってアップロード用のgemパッケージをビルドする。
+
+<pre>
+$ make clean
+$ ruby1.8 -S rake build
+</pre>
+
+rroongaの場合、ruby1.9.1ではパースできないオブジェクトがあるためruby1.8で作成する。
+TODO: YAMLの設定ファイルを直して1.9.1でやる
+
+h2. gemパッケージの動作確認
+
+そのgemパッケージの動作を確認するため、下記コマンドを打ってローカル環境にインストールする。
+
+<pre>
+$ gem1.9.1 install pkg/（パッケージ名）-（今回リリースバージョン番号）.gem --user-install
+</pre>
+
+インストールが成功すると/home/(ユーザ名)/.gem/ruby/1.9.1/gems/（パッケージ名）-（今回リリースバージョン番号）/にインストールされる。
+このディレクトリに移動して、テストを実行し動作を確認する。
+
+<pre>
+$ NO_MAKE=yes ruby1.9.1 test/run-test.rb
+</pre>
+
+h2. news.textileの再まとめ
+
+news.textileの行頭にコミットIDが残っている場合、
+下記コマンドを実行してログを表示する。
+
+<pre>
+git log --reverse -p （前回のリリース時のバージョン）..（残っていたコミットID）
+</pre>
+
+上記ログを"Author:"で検索しながら、ユーザにとって知る必要があるもの（ユーザに見える情報）のコミットログのみを抜き出す。
+その動詞を過去形にし、頭文字を大文字にする。
+それらログをそれぞれを次のようにまとめる。
+機能などに新しく追加されたものに関してはImprovement,
+動作の変更などはChanges,
+バグの修正など前バージョンまでにあった問題を修正したものはFixesに記述する。
+また、コミットログの行末に[人名]がある場合はその人名をThanks以下に書く。
+
+その後、下記コマンドを実行してja.poを更新する。
+
+<pre>
+$ rake reference:po:update
+</pre>
+
+その後、ja.poを開いて、各msgid（追加したコミットログ）に対応するmsgstrにコミットログの和訳を作成する。
+fuzzyを検索して見つかったらC-iで消す。
+
+h2. これまでの変更をpush
+
+ここまでに行った変更をcommitしてgit pushする。
+h2. リリースバージョンのタグを作成
+
+下記コマンドを入力して、今回リリースするバージョンのタグを打ってgit pushする。
+
+<pre>
+$ rake release:tag
+$ git push --tag
+</pre>
+
+h2. rubygems.orgにパッケージをアップロード
+
+下記コマンドを実行してパッケージをアップロードする。
+
+<pre>
+$ ruby1.8 -S rake gemcutter:release
+</pre>
+
+h2. rubyforgeにパッケージをアップロード
+
+下記コマンドを実行してアップロードする。
+
+<pre>
+$ ruby1.8 -S rake release:rubyforge:upload
+$ ruby1.8 -S rake release:reference:publish
+$ ruby1.8 -S rake release:html:publish
+</pre>
+
+rroonga以外の場合、index.html関連はrake release:html:publishでアップロードされないので、rroonga側からアップロードする。
+
+h2. メーリングリストにリリースの周知
+
+メーリングリストにリリースした旨を書いたメールを流す。
+日本語の他、英語のメーリングリストにもリリースした旨を英語で書いたメールを流す。
+
+h3.日本語でのメールの具体例
+
+吉原です。
+
+（最新バージョンをリリースしたことを書く）
+groongaのRubyバインディングrroonga1.2.3をリリースしました。
+（rroongaのインデックスページのURL）
+  http://groonga.rubyforge.org/index.html.ja#about-rroonga
+
+（ソフトウェアの概略）
+rroongaはRubyらしい書き方でgroongaを操作できることを重視しています。
+同時に、groongaの速度をそのまま生かすことも大事にしています。
+
+（前回リリースから今回リリースまでに変更された点のうち、ユーザにとって重要なものを書く）
+1.2.1からの変更された点としては、ドキュメントの一部英訳化、リファ
+レンスのパスの修正などを行いました。また、rroongaをインストールし
+ようとした際、groongaがないと自動でインストールする機能が復活しま
+した。
+
+（コマンドなどのインストール方法）
+インストール:
+  % sudo gem install rroonga
+
+（チュートリアルページのURL）
+irbを使ったrroongaのチュートリアルはこちらにあります。
+
+  http://groonga.rubyforge.org/rroonga/ja/file.tutorial.html
+
+（http://groonga.rubyforge.org/rroonga/ja/file.news.htmlを見て、前回リリース時からの変更点を書く）
+1.2.1からの変更点は以下の通りです。
+
+1.2.3: 2011-06-27
+
+修正
+    gemパッケージに含まれてしまったオブジェクトファイル(*.o)を削除。
+    一部のリファレンスマニュアルの文字化けを修正。
+
+1.2.2: 2011-06-27
+
+改良
+    英語版の「開発者向け情報」ページを作成。
+    "html:publish"タスクと"publish"に関しての説明を追加。
+
+変更
+    Groonga::Record#attributesが重複したレコードが現れた際に
+    同じattributesオブジェクトを返すようにした。
+    Groonga::Record#attributesにドキュメントを追加。
+    「開発者向け情報」ページ内にあるドキュメント作成ツールを変更。
+    NEWS*.rdocとtutorial.texttileをディレクトリdoc/text/に移動。
+
+修正
+    インデックスページにある「チュートリアル」ページへのリンクを修正。
+    インデックスページにある英語版「チュートリアル」ページへのリンクを修正。
+    新しいgroongaのダウンロードURLに対応。 [mallowlabs]
+
+感謝
+    mallowlabsさん
+
+h3. 英語でのメールの具体例
+
+<pre>
+Everyone,
+
+（rroongaの再榛バージョンをリリースしたことを書く）
+We relesed rroonga 1.2.3.
+
+（インデックスページのURLを書く）
+  http://groonga.rubyforge.org/#about-rroonga
+
+（rroongaの説明）
+rroonga is the library which ruby-binding for grronga.
+
+（前回リリース時からの変更点のうち、ユーザにとって大事なものを書く）
+Since ver.1.2.1 was released, we translated some documents
+from Japanese to English, and fixed pathes in reference-manual.
+Thanks to mallowlabs, when installing rroonga without groonga
+installed, grronga is automatically installed.
+
+（インストール方法を書く）
+How to install:
+  % sudo gem install rroonga
+
+（チュートリアルについてのURLなどを書く）
+There is the tutorial of rroonga with irb:
+
+  http://groonga.rubyforge.org/rroonga/en/file.tutorial.html
+
+（news.textileから今回リリースのために書いた部分をコピーする）
+Please see below changes since ver.1.2.1.
+
+== 1.2.3: 2011-06-27
+
+=== Fixes
+
+* remove object files in gem packages.
+* fix charactor corruption in reference.
+
+== 1.2.2: 2011-06-27
+
+=== Improvements
+
+* created "Developers" page in English.
+* added description for tasks of "html:publish" and "publish".
+
+=== Changes
+
+* Groonga::Record#attributes return same attributes object for duplicate records.
+* added document for Groonga::Record#attributes.
+* changed tool name in document page for creating document.
+* moved NEWS*.rdoc and tutorial.texttile to doc/text/.
+
+=== Fixes
+
+* fixed the tutorial path in index page.
+* fixed the path of tutorial in index page in English.
+* follow the groonga downlowd URL change. [mallowlabs]
+
+=== Thanks
+
+* mallowlabs
+
+--
+（名前とメールアドレス）
+yoshihara
+(yoshihara at clear-code.com)
+</pre>
+
+h2. rubyforgeのニュースを更新
+
+rubyforgeのpost_newsコマンドを使ってrubyforgeの最新ニュースを更新する。
+
+h2. 次回リリース時のバージョン番号の設定
+
+ext/groonga/rb-grn.hにある、RB_GRN_MAJOR_VERSION,RB_GRN_MINOR_VERSION,RB_GRN_MICRO_VERSIONの値を次回リリース時のバージョンの値に変更する。

data/lib/packnga/reference-task.rb

@@ -116,8 +116,8 @@ module Packnga
 
     def define_po_tasks
       namespace :po do
+        namespace :update do
         @translate_languages.each do |language|
-          namespace language do
             po_file = "#{@po_dir}/#{language}.po"
 
             if File.exist?(po_file)
@@ -138,7 +138,7 @@ module Packnga
             end
 
             desc "Updates po file for #{language}."
-            task :update => po_file
+            task language => po_file
           end
         end
 
@@ -147,7 +147,7 @@ module Packnga
           ruby($0, "clobber")
           ruby($0, "yard")
           @translate_languages.each do |language|
-            ruby($0, "reference:po:#{language}:update")
+            ruby($0, "reference:po:update:#{language}")
           end
         end
       end

data/lib/packnga/release-task.rb

@@ -21,7 +21,7 @@ module Packnga
   # This class creates release tasks.
   #
   # Release tasks tag current version and install gem for test.
-  # It also define tasks to upload rubyforge whether option.
+  # It also define tasks to upload RubyForge whether option.
   #
   # @since 0.9.0
   class ReleaseTask
@@ -36,14 +36,18 @@ module Packnga
     # This attribute is message when tagging in release.
     # @param [String] message
     attr_writer :tag_message
-    # This attribute is options for uploading rubyforge by rsync.
+    # This attribute is options for uploading RubyForge by rsync.
     # @param [Hash] options for uploading.
     attr_writer :publish_options
+    # This attribute is text for changes in new release
+    # to post news to RubyForge.
+    # @param [String] text for changes.
+    attr_writer :changes
     # Defines task for preparing to release.
     # Defined tasks update version and release-date in index files
     # and tag in git.
     # If you set rubyforge_project of Jeweler::Task.new with its given block,
-    # it also define tasks to update rubyforge.
+    # it also define tasks to update RubyForge.
     # @param [Jeweler::Task] spec created by Jeweler::Task.new.
     def initialize(spec)
       @spec = spec
@@ -51,6 +55,7 @@ module Packnga
       @rubyforge = nil
       @tag_messsage = nil
       @publish_options = nil
+      @changes = nil
       yield(self) if block_given?
       set_default_values
       define_tasks
@@ -68,8 +73,9 @@ module Packnga
     def set_default_values
       @index_html_dir ||= "doc/html"
       @base_dir ||= Pathname.new("doc")
-      @tag_message ||= 'release #{version}!!!'
+      @tag_message ||= "release #{@spec.version}!!!"
       @publish_options ||= {}
+      @changes ||= ""
     end
 
     def define_tasks
@@ -137,11 +143,12 @@ module Packnga
       define_html_task
       define_publish_task
       define_upload_tasks
+      define_post_task
     end
 
     def define_reference_task
       namespace :reference do
-        desc "Upload document to rubyforge."
+        desc "Upload document to RubyForge."
         task :publish => "reference:publication:generate" do
           rsync_to_rubyforge(@spec, "#{html_reference_dir}/", @spec.name, @publish_options)
         end
@@ -158,7 +165,7 @@ module Packnga
     end
 
     def define_publish_task
-      desc "Upload document and HTML to rubyforge."
+      desc "Upload document and HTML to RubyForge."
       task :publish => ["html:publish", "reference:publish"]
     end
 
@@ -170,6 +177,7 @@ module Packnga
           system("stty -echo")
           @rubyforge.userconfig["password"] = STDIN.gets.chomp
           system("stty echo")
+          puts
           if @rubyforge.autoconfig["group_ids"][@spec.rubyforge_project].nil?
             @rubyforge.scrape_config
             @rubyforge.save_autoconfig
@@ -187,6 +195,23 @@ module Packnga
       task :rubyforge => "release:rubyforge:upload"
     end
 
+    def define_post_task
+      namespace :rubyforge do
+        namespace :news do
+          desc "Post news to RubyForge."
+          task :post do
+            group_id =
+              @rubyforge.autoconfig["group_ids"][@spec.rubyforge_project]
+            subject =
+              "#{@spec.name} version #{@spec.version} has been released!"
+            body = @spec.description + "\nChanges:" + @changes
+
+            @rubyforge.post_news(group_id, subject, body)
+          end
+        end
+      end
+    end
+
     def rsync_to_rubyforge(spec, source, destination, options={})
       host = "#{@rubyforge.userconfig["username"]}@rubyforge.org"
 

data/lib/packnga/version.rb

@@ -18,5 +18,5 @@
 
 module Packnga
   # Packnga version.
-  VERSION = "0.9.2"
+  VERSION = "0.9.3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: packnga
 version: !ruby/object:Gem::Version 
-  hash: 63
-  prerelease: 
+  hash: 61
+  prerelease: false
   segments: 
   - 0
   - 9
-  - 2
-  version: 0.9.2
+  - 3
+  version: 0.9.3
 platform: ruby
 authors: 
 - Haruka Yoshihara
@@ -16,9 +16,13 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-28 00:00:00 Z
+date: 2011-09-22 00:00:00 +09:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: rake
   version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -28,11 +32,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: rake
-  prerelease: false
-  type: :runtime
   requirement: *id001
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: yard
   version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -42,11 +46,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: yard
-  prerelease: false
-  type: :runtime
   requirement: *id002
 - !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: rubyforge
   version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -56,11 +60,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: rubyforge
-  prerelease: false
-  type: :runtime
   requirement: *id003
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: test-unit
   version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -70,11 +74,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: test-unit
-  prerelease: false
-  type: :development
   requirement: *id004
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: test-unit-notify
   version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -84,11 +88,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: test-unit-notify
-  prerelease: false
-  type: :development
   requirement: *id005
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: jeweler
   version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -98,11 +102,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: jeweler
-  prerelease: false
-  type: :development
   requirement: *id006
 - !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: RedCloth
   version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -112,9 +116,6 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: RedCloth
-  prerelease: false
-  type: :development
   requirement: *id007
 description: |
   Packnga is an library to translate to many languages by YARD.
@@ -134,6 +135,7 @@ files:
 - Rakefile
 - doc/text/lgpl.txt
 - doc/text/news.textile
+- doc/text/release.textile
 - doc/text/tutorial.textile
 - lib/packnga.rb
 - lib/packnga/document-task.rb
@@ -141,6 +143,7 @@ files:
 - lib/packnga/release-task.rb
 - lib/packnga/version.rb
 - lib/packnga/yard-task.rb
+has_rdoc: true
 homepage: http://groonga.rubyforge.org/
 licenses: 
 - LGPLv2
@@ -170,7 +173,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: groonga
-rubygems_version: 1.7.2
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: An utility library to package i18n-ed library.