青木日記

■ 日本 Ruby 会議 2007

http://jp.rubyist.net/RubyKaigi2007/

遅ればせながら会議の件。

ささださんに「応募しといて」と名指しされたので なんか応募しようかと思うんだけど、何で応募しよう。 順当に行くとリファレンスマニュアルになるけど、あれどのくらい進むんだろう。

「このテーマでしゃべれ」てのがあったらコメントください。

(18:48)

■ リファレンスマニュアル進捗状況

~/c/bitclust % ./tools/statrefm.rb ../rubydoc
--- Status
97/225 files done (43.11%)
　
--- Ranking by number of files
 1  128 (not yet)
 2   57 sheepman
 3   23 okkez
 4   11 date
 5    3 aamine
 6    2 tadf
 7    1 moriq
　
--- Ranking by Kbytes
 1  386 (not yet)
 2  321 sheepman
 3  121 okkez
 4   37 date
 5   12 aamine
 6    2 moriq
 7    2 tadf

12 月いっぱいにエントリを揃える計画で、現在 43% (ファイル数ベース)。 なんてありがちな数字だ。

こんなん俺が全部書いてやるよチクショー！って方は

http://doc.loveruby.net/wiki/HowToJoin.html

を読んで参加してね。

(18:53)

■ リファレンスマニュアル進捗状況 (2)

まあ、でもあれだ。 あと 128 ファイルだから、1 日 5 ファイルかたづければ 12 月で終わるよ。

おれもせめて自分のメンテしてるライブラリくらいはどうにかしよう。

(18:55)

■ るりマ！ / 作業方法

現段階の作業方法をなんとなくお伝えする。

とりあえず svn up

~/c/rubydoc/refm/api % svn up
At revision 839.

ASSIGN ファイルを編集してファイルのオーナーを自分にする

~/c/rubydoc/refm/api % grep net/smtp ASSIGN
net/smtp
~/c/rubydoc/refm/api % vi ASSIGN
~/c/rubydoc/refm/api % grep net/smtp ASSIGN
net/smtp                        aamine
~/c/rubydoc/refm/api % svn ci -m 'assign net/smtp to aamine' ASSIGN

本物にどういうメソッドが定義されてるか bc-methods で調査

~/c/rubydoc % bc-methods -rnet/smtp Net::SMTP
                               180 181 182 183 184 185 185 190
Net::SMTP.default_port           o   o   o   o   o   o   o   o
Net::SMTP.default_ssl_context    -   -   -   -   -   -   -   o
Net::SMTP.default_ssl_port       -   -   -   -   -   -   -   o
Net::SMTP.default_tls_port       -   -   -   -   -   -   -   o
Net::SMTP.disable_ssl            -   -   -   -   -   -   -   o
Net::SMTP.disable_tls            -   -   -   -   -   -   -   o
Net::SMTP.enable_ssl             -   -   -   -   -   -   -   o
Net::SMTP.enable_tls             -   -   -   -   -   -   -   o
Net::SMTP.ssl_context            -   -   -   -   -   -   -   o
Net::SMTP.start                  o   o   o   o   o   o   o   o
Net::SMTP.use_ssl?               -   -   -   -   -   -   -   o
Net::SMTP.use_tls?               -   -   -   -   -   -   -   o
Net::SMTP#address                o   o   o   o   o   o   o   o
Net::SMTP#auth_cram_md5          -   -   -   -   -   -   -   o
Net::SMTP#auth_login             -   -   -   -   -   -   -   o
Net::SMTP#auth_plain             -   -   -   -   -   -   -   o
Net::SMTP#authenticate           -   -   -   -   -   -   -   o
Net::SMTP#data                   -   -   -   -   -   -   -   o
Net::SMTP#debug_output=          -   -   -   -   -   -   -   o
Net::SMTP#disable_ssl            -   -   -   -   -   -   -   o
Net::SMTP#disable_tls            -   -   -   -   -   -   -   o
Net::SMTP#ehlo                   -   -   -   -   -   -   -   o
Net::SMTP#enable_ssl             -   -   -   -   -   -   -   o
Net::SMTP#enable_tls             -   -   -   -   -   -   -   o
Net::SMTP#esmtp                  o   o   o   o   o   o   o   o
Net::SMTP#esmtp=                 o   o   o   o   o   o   o   o
Net::SMTP#esmtp?                 o   o   o   o   o   o   o   o
Net::SMTP#finish                 o   o   o   o   o   o   o   o
Net::SMTP#helo                   -   -   -   -   -   -   -   o
Net::SMTP#inspect                o   o   o   o   o   o   o   o
Net::SMTP#mailfrom               -   -   -   -   -   -   -   o
Net::SMTP#open_message_stream    o   o   o   o   o   o   o   o
Net::SMTP#open_timeout           o   o   o   o   o   o   o   o
Net::SMTP#open_timeout=          o   o   o   o   o   o   o   o
Net::SMTP#port                   o   o   o   o   o   o   o   o
Net::SMTP#quit                   -   -   -   -   -   -   -   o
Net::SMTP#rcptto                 -   -   -   -   -   -   -   o
Net::SMTP#rcptto_list            -   -   -   -   -   -   -   o
Net::SMTP#read_timeout           o   o   o   o   o   o   o   o
Net::SMTP#read_timeout=          o   o   o   o   o   o   o   o
Net::SMTP#ready                  o   o   o   o   o   o   o   o
Net::SMTP#send_mail              o   o   o   o   o   o   o   o
Net::SMTP#send_message           o   o   o   o   o   o   o   o
Net::SMTP#sendmail               o   o   o   o   o   o   o   o
Net::SMTP#set_debug_output       o   o   o   o   o   o   o   o
Net::SMTP#start                  o   o   o   o   o   o   o   o
Net::SMTP#started?               o   o   o   o   o   o   o   o
Net::SMTP#starttls               -   -   -   -   -   -   -   o
Net::SMTP#use_ssl?               -   -   -   -   -   -   -   o
Net::SMTP#use_tls?               -   -   -   -   -   -   -   o
Net::SMTP::Revision              o   o   o   o   o   o   o   o

bc-methods --diff (いまオプションつくった) で足りないエントリを確認。

~/c/rubydoc/refm/api % bc-methods -rnet/smtp --diff=src/net/smtp.rd  Net::SMTP
-Net::SMTP#auth_cram_md5
-Net::SMTP#auth_login
-Net::SMTP#auth_plain
-Net::SMTP#authenticate
-Net::SMTP#disable_ssl
-Net::SMTP#disable_tls
-Net::SMTP#enable_ssl
-Net::SMTP#enable_tls
以下略

がんばって編集

~/c/rubydoc/refm/api % vi src/net/smtp.rd

もいっかい bc-methods --diff

~/c/rubydoc/refm/api % bc-methods -rnet/smtp --diff=src/net/smtp.rd  Net::SMTP
+Net::SMTP.new

ぜんぶエントリが書けた。new は継承してるメソッドだから増えてても OK。

ASSIGN ファイルの status を done にする

~/c/rubydoc/refm/api % vi ASSIGN
~/c/rubydoc/refm/api % grep aamine ASSIGN
_builtin/Struct__Tms            aamine          done
fileutils                       aamine
net/http                        aamine
net/https                       aamine
net/pop                         aamine          done
net/smtp                        aamine          done    ←これな
ping                            aamine          done

こみっと

~/c/rubydoc/refm/api % svn ci -m 'net/smtp done' src/net/smtp.rd ASSIGN

(完)

ちなみに、文法エラーとかがあると cron で回してるビルドスクリプトから ruby-reference-manual-diff ML にエラーメールが飛ぶので、あせってなおす。

(19:31)