ruby-list

あおきです。

いつのまにか立場がいれ変わっているような… ^^;;

  In mail "[ruby-list:16696] Re: RD and internationalization"
    wakou@fsinet.or.jp wrote:

> 青山です。

> > =begin...=endをぐるぐる入れかえながら.rbをさわるということで。
> 
> この点は同じなのですが、ちょっと違うのは、エディタで見る事が出来るのは
> *.rb だけで、*.rbd は完全に自動生成、更新になるという事です。
(略)
> mime ヘッダ案がありましたが、それのダウンスケール版みたいな感じでしょ
> うか。LANG をみれば、そこにどの言語が使われているかわかるわけです。

詳しく説明していただいたおかげでかなり把握できたように思います。


(略)
> と、いったあたりではないかと。で、対策として、人が書くのは *.rb だけ。
> 他言語情報についてはツールで自動生成。不要ならば、その生成さえも不要。
> 修正についても、ツールによって自動的に反映。
> 
> こんな感じで、それぞれの問題と思われる点にも対応させてみたつもりです。

作者とユーザそれぞれの立場で考えてみます。

作者の立場

大きくわけて書きかたは二通りです。ユーザに渡るそのままの形式を
いきなり作成する方法と、自分でなんらかの形式で作ってからユーザに
渡す形式に変換する方法です。
後の方法は最後に変換が必要になりますから、やや煩わしくなります。
そのかわりに、自分のやりやすいようにやれる長所があります。

ユーザの立場

いまだASCII環境が標準であることを考えると、少なくともソースコードは
ASCIIのみで構成されているのが望ましい。しかし、例えば日本語の
ドキュメントが欲しい人もたくさんいる。また、RDの大きな利点は、
ソースにドキュメントが埋めこまれていることなので、できれば日本語でも
そうしたい。

そして、決めておかなければならないのはユーザに渡るときの形式です。

そのうちもっとも単純で簡単なのは、(ソース+英語(ASCII))+(日)+...
というファイル構成です。この方式ではそれぞれがただのファイル
ですから、ユーザにとってはわかりやすく楽です。


と、長い前置きを置いて、青山さんの案をもう一度考えてみます。

まずユーザの側から見ると、最初ソースに入っている言語以外の
ドキュメントを見るには、rd のようなツールを介する必要があり、
手間が増えます。これ以外に多言語を格納する手段がなければ

できるなら、とくにデータベース方式を選択する必然性は
なくなります。
そして実際に、交換しやすいようにドキュメントが書かれていれば、
青山さんのような方式を使わなくてもドキュメント交換は可能です。

また、作者の側から見ると、青山さんの方式を使うからには、
ユーザの手に渡る前に「必ず」ひと段階置く必要があります。
おっしゃるようにエディタにやらせてしまえばそれも可能ですが、
世の中プログラマブルなエディタを使っている人ばかりではない
でしょう。

それと、ドキュメントに対するパッチに関して少し話がありましたが、
ぼくはドキュメントに関してはパッチを自動であてる必要性を
感じません。ドキュメントのパッチは、ソースコードよりは頻度も
低く、容量もたいして大きくないと想定できるので、どうしても
これができなきゃいけないという類のものではないと思います。
少くとも、他の要求よりも重要度は低いと思います。


まとめると、以下のような点が青山さんの案の欠点として指摘できます。

1  読む側の多国語化は、ツールを介さない方法でなんとかできる。
2  ドキュメント入れ換えツールは、データベースを作らなくても
   作ることができる。
3  書く側にとっては、もっと便利なフォーマットがある。
4  「最終結果」を直接作りたいと思う書き手の要求を満たせない。


またこの問題に対するぼくの結論は、
「ソースコードには英語(ASCII)でドキュメントに埋め込み、
  他の言語(charset)はそれぞれ別ファイル
  任意の言語をソースに埋め込むことはドキュメント入れ換え
  ツールを用意して代替手段とする」
です。
-------------------------------------------------------------------
あおきみねろう

Thread

Prev Next

In This Thread

Prev Next

[#16402] menu_spec — hiramatsu@...

[#16407] Homepage shoukai — Hirofumi Tamori <tamori@...>

[#16428] req: unless...elsif... — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16445] eql? — Tadayoshi Funaba <tadf@...>

[#16456] rbcw140 on WindowsNT4.0J+SP5 via inetd — Masaki YATSU <yatsu@...>

[#16459] bug? difference of while gets and -n — Takashi Shimizu <simtak@...>

[#16460] Workshop — SEKI <m_seki@...>

[#16464] nntpclient.rb — kikutani@...

[#16466] about killer applications. — HIGAKI Masaru (檜垣 賢) <higaki@...>

[#16470] ChaSen — IKARASHI Akira <ikarashi@...3.dion.ne.jp>

[#16474] ruby-man-1.4-jp — Masato KIYAMA <masato@...>

[#16480] backstage of ruby.freak — akaishi@...

[#16481] Ruby Workshop と ruby-projects ml — hisanori@...

[#16482] GD, mandel for cygwin — WATANABE Hirofumi <watanabe@...>

[#16483] win 版 ruby について — Tadashige Morii <m_tada@...>

[#16486] Ruby Workshop — matz@... (Yukihiro Matsumoto)

[#16501] Ruby/Gtk Tutorial — Hiroshi IGARASHI <igarashi@...>

[#16537] Range — Yoshiki Wada <wada@...>

[#16573] Workshop Report — matz@... (Yukihiro Matsumoto)

[#16587] FileMaker Pro & Ruby — Masatoshi SEKI <m_seki@...>

[#16590] Win Installer テスター — たむら けんいち <tamura-r@...>

[#16596] ruby RPM — nobu.nakada@...

[#16597] MySQL on RAA — とみたまさひろ <tommy@...>

[#16598] 札幌 (ゴミ ) — 中村暁史 Nakamura Akifumi <BXQ04723@...>

[#16601] win 版と linux 版 ruby の比較表 — Tadashige Morii <m_tada@...>

[#16602] ruby って登録商標？ — Tadashige Morii <m_tada@...>

[#16610] Opening session report: Ruby Workshop in 9/4. — "NAKAMURA, Hiroshi" <nakahiro@...>

[#16649] Second session report: Ruby Workshop in 9/4. — Katsuyuki Komatsu <komatsu@...>

[#16659] rbcw140-socket.zip — Ito Kazumitsu <ito@...>

[#16672] RPM of uconv&xmlparser — OZAWA Sakuro <crouton@...>

[#16677] Matz's talk in Sapporo — gotoken@... (GOTO Kentaro)

[#16680] modulo — Tadayoshi Funaba <tadf@...>

[#16690] gtk + socket — Miyaki Masahiro <miyaki@...>

[#16693] Re: gtk + socket — Miyaki Masahiro <miyaki@...>

[#16699] bug? parsedate.rb zone is nil — str <setsura@...>

[#16706] Ruby Conference in Okayama — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#16707] `::' on irb — Yasuhiro Fukuma <yasuf@...>

[#16712] d-chasen [dRuby/DRb] — Masatoshi SEKI <m_seki@...>

[#16725] RubyWin — Masaki Suketa <CQN02273@...>

[#16726] http-access-0.0.3 and html-parser-19990912 — Takahiro Maebashi <maebashi@...>

[#16732] 4th session report: Ruby Workshop in 9/4. — GOTOU YUUZOU <gotoyuzo@...>

[#16737] eval.rb について — Tadashige Morii <m_tada@...>

[#16738] on super computer — gotoken@... (GOTO Kentaro)

[#16745] #\ comment — nobu.nakada@...

[#16762] User's Guide — Tadashige Morii <m_tada@...>

[#16779] xml-parser example(xmlcheck.rb) error? — Hideto Ishibashi <s34204@...>

[#16782] プラットフォーム別 ruby — Noritsugu Nakamura <nnakamur@...>

[#16797] RubyWin 0.0.0.1a — Masaki Suketa <CQN02273@...>

[#16799] [Ruby/Gtk bug?] — Kazumi Okamoto <kazusan@...>

[#16811] About \&... — dellin <ogu@...>

[#16815] date2-1.8 — Tadayoshi Funaba <tadf@...>

[#16820] gtk: ツリーにスクロールバーをつけるには？ — Daisuke Sato <densuke@...2.so-net.ne.jp>

[#16821] Re: gtk: ツリーにスクロールバーをつけるには？ — Miyaki Masahiro <miyaki@...>

[#16823] Ruby 1.4.1 — Yukihiro Matsumoto <matz@...>

[#16831] Ruby 1.4.2 — Yukihiro Matsumoto <matz@...>

[#16837] リファレンスマニュアルの誤植 ? — "ISIHARA HIROSI" <ishihara-h@...>

[#16851] Dir.glob — kikutani@...

[#16873] Ruby 1.4.2 repacked — Yukihiro Matsumoto <matz@...>

[#16880] Ruby 1.4.2 repacked — Yukihiro Matsumoto <matz@...>

[#16895] N 桁対応カウンタ — Masato KIYAMA <masato@...>

[#16912] Ruby Entry Pac for Win 転載願い — 田村賢一 <ken-ichi.tamura@...>

[#16914] Re: プラットフォーム別 ruby — 中村暁史 Nakamura Akifumi <BXQ04723@...>

[#16916] Re: RubyWin — 中村暁史 Nakamura Akifumi <BXQ04723@...>

[#16923] rb2html released but... — dellin <ogu@...>

[#16928] Dir.glob — Takashi Nishimoto <g96p0935@...>

[#16951] ruby-1.4.2 for OS/2 upload — kenn@...

[#16961] quoted-printable in manual — kikutani@...

[#16968] Re: RubyWin — 助田 雅紀 <masaki.suketa@...>

[#16969] Re: RubyWin — 助田 雅紀 <masaki.suketa@...>

[#16970] Re: RubyWin — 助田 雅紀 <masaki.suketa@...>

[#16972] Re: RubyWin — 助田 雅紀 <masaki.suketa@...>

[#16973] Re: RDB アクセスの統一 (Re: RubyWin) — 助田 雅紀 <masaki.suketa@...>

[#16974] nested module file — Kazuhiro Yoshida <moriq@...2.seikyou.ne.jp>

[#16978] Profiler bug? — 土岐 仁謙 <toki@...>

[#16989] mime.rb patch — Takashi Nishimoto <g96p0935@...>

[#16995] address field split — Kikutani Makoto <kikutani@...>

[#17000] www.ruby-lang.org — matz@... (Yukihiro Matsumoto)

[#17015] Re: www.ruby-lang.org — Kazuya Shiida <BYC05717@...>

[#17017] make Ruby-1.4.2 on BeOS R4.5.2(Intel) — tenmei@... (Noriaki Harada)

[#17027] attribute — Masatoshi SEKI <m_seki@...>

[#16466] about killer applications. — HIGAKI Masaru (檜垣賢) <higaki@...>

[#16590] Win Installer テスター — たむら　けんいち <tamura-r@...>

[#16968] Re: RubyWin — 助田　雅紀 <masaki.suketa@...>

[#16969] Re: RubyWin — 助田　雅紀 <masaki.suketa@...>

[#16970] Re: RubyWin — 助田　雅紀 <masaki.suketa@...>

[#16972] Re: RubyWin — 助田　雅紀 <masaki.suketa@...>

[#16973] Re: RDB アクセスの統一 (Re: RubyWin) — 助田　雅紀 <masaki.suketa@...>

[#16978] Profiler bug? — 土岐仁謙 <toki@...>