ruby-list

まつもと ゆきひろです

In message "[ruby-list:16225] Re: maillib? 0.5.0"
    on 99/08/19, Minero Aoki <aamine@dp.u-netsurf.ne.jp> writes:

|あおきです。とりあえずlistに送ります。

|いえいえ、Rubyのためならなんとやら、です  ^^;;

感謝します。

|> 個人的には英語のドキュメントをrd形式で埋め込むのかなと思って
|> ますが、日本語(なり英語以外の言語)のドキュメントはどう持つの
|> が良いでしょうねえ。
|
|MIMEっぽくBase64エンコードして埋めこむのはどうでしょうか。

ruby-talkでも話しましたが、私は少なくとも現時点ではあまり賛
成していません。

# やはり日本語で書く方がはるかに楽だなあ。

最大の問題はプログラムを読んだときにエンコードされたドキュメ
ントだと読めないことです。私自身はたとえばPerlだとPODのドキュ
メントを読むのはmanやperldocで読むよりも、スクリプトファイル
を直接読むことの方が多いので、このやり方だとかなり不自由をこ
うむります。

現時点での私の対案は

  foobar.rb
  foobar.rd.ja  # または foobar.rd.ja_euc?

のように英語(あるいはプライマリ)以外の言語は言語コード(場合
によってはエンコーディングも)を付加した別ファイルで持つこと
です。これならば、(英語が分かれば)スクリプトは直接ドキュメン
トと対比しながら読めますし、ある言語のドキュメントが欲しけれ
ば、そちらのファイルをrd2xxxにかければ良いわけです。

また、もともと海外のユーザについてまったく考えないのであれば、
その場合はプライマリ言語として日本語を選択すれば良いでしょう。

ま、英語のあまり得意でない国で開発されたフリーソフトウェアと
して、ドキュメントの多言語化についてはいろいろ考慮して良いも
のを提供したいですよね。

# ruby-talkも非nativeばかりだし。

|たとえば、ドキュメントを書く人はこんなものを作ります。

|=begin
|  内容1
|=begin
|  内容2
|=end
|
|は、内容1と2に同じ内容のものを別のエンコーディングで格納
|していることを示します。ただしこの方法はあくまで例で、
|別の方法でもかまいません。

そーですねえ。英語ともうひとつの言語という範囲の間はこの方法
でも問題ないでしょうが、英語とドイツ語と日本語とか、日本語と
韓国語とかだと、全体でUnicodeのようなエンコーディングを使わ
ないとファイルを編集できませんね。

そういう意味でも別ファイルの方が良いかも。私自身はまだ
Unicodeを手放しで受け入れる気にはなれませんし。

UTF-8を使った別の国際エンコーディングがあれば良いのに。いや、
別に無理にUTF-8でなくても良いんだけど。たとえばMuleの
internalコードを提案するとかいう話は無いんですかね。

                                まつもと ゆきひろ /:|)

Thread

Prev Next

In This Thread

Prev Next

[#15820] maillib with big base64 — kikutani@...

[#15825] matrix.o — Takashi Nishimoto <g96p0935@...>

[#15828] Ruby/Gtk for cygwin インストールについて — otokita@...

[#15832] Array#reverse! — setsura <setsura@...>

[#15833] ruby-orbit-0.0.1 — Dai <MAP2303@...>

[#15839] Windows95 で Tk — H サイトウ <HiroshiSaito@...>

[#15840] FreeBSD port kit for Ruby 1.3.6 — Yasuhiro Fukuma <yasuf@...>

[#15844] Re: alias new open — 助田 雅紀 <masaki.suketa@...>

[#15848] — Kazumi Okamoto <okamoto@...>

[#15856] Tiny Tiny eruby — Masatoshi SEKI <m_seki@...>

[#15865] mime.rb rev 1.4 — "NAKAMURA, Hiroshi" <nakahiro@...>

[#15870] help — Hideo Koyama <fa8h-kym@...>

[#15873] UDPsocket#recvfrom の API 変更について — Toshihiko SHIMOKAWA / 下川俊彦 <toshi@...>

[#15874] postgres でのユーザ指定 — Norio Kasahara <kasa@...>

[#15882] はじめまして — OGINO AKIHIRO <akimaru@...>

[#15885] difference of \Z between perl and ruby — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15890] difference of system() between UNIX and Windows — suzuki@...

[#15894] RE: difference of system() between UNIX and Win dows — 助田 雅紀 <masaki.suketa@...>

[#15899] ruby/tk on cygwin /w Tk8.1 — たむら けんいち <tamura-r@...>

[#15902] sybase module — Hisakuni FUJIMOTO <hisa@...>

[#15911] Re: [ruby-talk:00563] Date class and rfc822 — Wakou Aoyama <wakou@...>

[#15912] [][-n,n] — Wakou Aoyama <wakou@...>

[#15916] Re: [][-n,n] — Inaba Hiroto <inaba@...>

[#15920] Re: [][-n,n] — Inaba Hiroto <inaba@...>

[#15927] Ruby 1.3.7 — Yukihiro Matsumoto <matz@...>

[#15928] DAO クラスモジュール 0.001alpha — たむら けんいち <tamura-r@...>

[#15935] Ruby/IRC — Shugo Maeda <shugo@...>

[#15944] Ruby 1.3.7 — Yukihiro Matsumoto <matz@...>

[#15954] [^] — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15955] echo しない readline — m_seki@...

[#15956] FAQ-990807 — Akira Endo <akendo@...3.rim.or.jp>

[#15965] String#split — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#15966] あしたのために(その一) — kikutani@...

[#15981] Ruby/Tk81 Demos — ttate@...

[#15993] Where is "ruby-mode.sl" ?? — Ryuichi Tamura <tam@...3.kais.kyoto-u.ac.jp>

[#15996] Sun World — matz@... (Yukihiro Matsumoto)

[#16002] how to know binary file — kikutani@...

[#16003] RE: Sun World — 助田 雅紀 <masaki.suketa@...>

[#16004] RE: how to know binary file — 助田 雅紀 <masaki.suketa@...>

[#16023] Ruby/PDFlib — thitoshi@... (TAKAHASHI Hitoshi)

[#16025] eRuby 0.0.4 — Shugo Maeda <shugo@...>

[#16027] 日経オープンシステム — Ataru NAKATA <anakata@...>

[#16028] C マガ — hisanori@...

[#16034] mod_ruby 0.1.4 — Shugo Maeda <shugo@...>

[#16036] ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16042] JUS Ruby Workshop — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16048] ruby/tk の menu_spec について — S-Harada<jdn@...>

[#16049] [].length==0 — Kazuhiro HIWADA <hiwada@...>

[#16052] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16055] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16058] Re: ruby/gtk でウィンドウを中央に表示したい — Miyaki Masahiro <miyaki@...>

[#16059] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16061] calendar/date — Tadayoshi Funaba <tadf@...>

[#16085] Re: ruby/gtk でウィンドウを中央に表示したい — kkubota@18software.co.jp

[#16091] The last day of a month — Akihiro Yamauchi <aygoofy@...>

[#16095] rd2html — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16099] クラスの別名 — Takashi Nishimoto <g96p0935@...>

[#16102] mysql-ruby link on RAA — とみたまさひろ <tommy@...>

[#16118] Ruby 1.4.0 — matz@... (Yukihiro Matsumoto)

[#16126] English document for RDtool — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16127] readline with 1.4 — kikutani@...

[#16147] Q: Constants — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16151] extinit & mkmain — Takashi Nishimoto <g96p0935@...>

[#16152] mkprototype — Takashi Nishimoto <g96p0935@...>

[#16153] ANN: testsupp 0.2 released. — gotoken@... (GOTO Kentaro)

[#16157] rdtool-0.2.1 — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#16158] maillib? 0.5.0 — Minero Aoki <aamine@...>

[#16164] Re: Ruby 1.4.0 — SHIROYAMA Takayuki <psi@...>

[#16167] Ruby 1.4.0 on BSD/OS 3.1 — OHARA Shigeki <os@...>

[#16171] FAQ の間違い ? — hiramatsu@...

[#16177] Ruby 1.4.0 binaries for cygwin, djgpp — WATANABE Hirofumi <watanabe@...>

[#16179] parsearg with debug.rb — kikutani@...

[#16185] Ruby lecture in Sapporo — gotoken@... (GOTO Kentaro)

[#16199] ruby/gtk の focus_out_event について — kkubota@18software.co.jp

[#16201] Re: ruby/gtk の focus_out_event について — kkubota@18software.co.jp

[#16202] — Hiroyuki Ueki <ueki@...>

[#16209] year of parsedate — kikutani@...

[#16216] timeout.rb — wakou@...

[#16218] ruby-1.4.0 [BUG] Segmentation fault — Toshihiko SHIMOKAWA / 下川俊彦 <toshi@...>

[#16219] Re: year of parsedate — Inaba Hiroto <inaba@...>

[#15844] Re: alias new open — 助田　雅紀 <masaki.suketa@...>

[#15894] RE: difference of system() between UNIX and Win dows — 助田　雅紀 <masaki.suketa@...>

[#15899] ruby/tk on cygwin /w Tk8.1 — たむら　けんいち <tamura-r@...>

[#15928] DAO クラスモジュール 0.001alpha — たむら　けんいち <tamura-r@...>

[#16003] RE: Sun World — 助田　雅紀 <masaki.suketa@...>

[#16004] RE: how to know binary file — 助田　雅紀 <masaki.suketa@...>

[#16228] Setup.nt — 助田　雅紀 <masaki.suketa@...>

[#16264] RE: ruby hacking guide — 助田　雅紀 <masaki.suketa@...>

[#16274] Re: Setup.nt — 助田　雅紀 <masaki.suketa@...>

[#16287] RE: Japanese in ruby/gtk (cygwin) — 助田　雅紀 <masaki.suketa@...>