ruby-list

なひです．

> From: Yukihiro Matsumoto
> Sent: Thursday, October 05, 2000 6:38 PM

> |> 提案1. RDの先頭の=beginと末尾の=endはなくてもよいことにする．
> |> 提案2. =begin header〜=end headerみたいな拡張も避けて，別の文法を
> |>   導入する．例えば=RDbegin〜=RDend．これならRuby本体が混乱しない．
> |提案1の方を考えているらしい。
> 
> 私も賛成です。元々は=begin, =endを抽出するツールとパーズする
> ツールは別にしようと思ってましたから。

従うべきsyntaxが別ですもんね．．．

	/	/	/

ところで，まつもとさんを含めて誰からもコメントがないということは，

| 質問. =begin〜=endという *Rubyの構文* は，
|   単なるコメントとしてではなく，
|   ドキュメントのために存在しているものなんでしょうか
|   （過去がどうだったかは別にして，現時点で）．
|   また今後もそうあるべきでしょうか．

については，誰も考えをもってない，ということなんでしょうか．

どうすべきなんですかね．もしドキュメント専用ではなく，
単に/*〜*/の替わりなんだということであれば，
以下のような取り決めがあってもいいかもしれません．

・Rubyのスクリプト中の=beginと=endについて，
  /^=begin\s*(?:\s+(.+))?$/
  /^=end\s*(?:\s+\1)?$/
  で囲まれているコメントについては，スクリプト中の同一の$1を持つ
  コメント（ただし=beginおよび=end部分は除く）を出現順に連結し，
  文字列$1に割り付けられたアプリケーションに渡すことを期待していると
  解釈する．
・上記$1をほげタグと呼ぶ．
・ほげタグに割り付けられたアプリケーションは必須ではない．
・ほげタグのないコメント（/^=begin$/〜/^=end$/）の解釈については不定．
  RDtoolがすべてのコメントを連結してドキュメントと解釈するのも自由．
・非公式なほげタグは/^[xX]-.+$/というsyntax．
・公式なほげタグはruby-devの議論で決まります．
  たとえば/^RD2l$/→rdtoolとか．

# これはRubyの=begin〜=endに含まれる部分（上では「コメント」）の
# semanticsについての取り決めであって，
# Rubyのsyntaxについての取り決めでも，
# RDについてのなんらかの取り決めでもありません．

## 最後の2つはsyntaxか．．．

上記の取り決めに基づいて，
「抽出するツール」がRuby本体になるか（咳さん案）
なにか他のツールになるか（まつもとさん案?）は，不明です．
誰かがなんとかしてくれればなひは嬉しい．^^;

Thread

Prev Next

In This Thread

Prev Next

[#25273] Re: ruby1.6.1(cygwin) が動作しません — "Mitsuo Igarashi" <mitsu5@...>

[#25274] Re: stack size — Toyofuku <toyofuku@...>

[#25276] ruby-wjed.exe — toyofuku@...

[#25277] Re: mswin32 組み込み用 Ruby — toyofuku@...

[#25279] mkmf - DESTDIR is ignored — dellin <dellin_geo@...>

[#25280] Array#delete が破壊的な理由 — Yasushi Shoji <yashi@...>

[#25281] winide16 — "Shigeo Kobayashi" <shigeo@...>

[#25291] MD5 の違い — "Shigeo Kobayashi" <shigeo@...>

[#25297] 変数の名前を取得する方法 — "T.Shimomura" <redbugml@...>

[#25299] Re: mswin32 組み込み用 Ruby — toyofuku@...

[#25311] =begin, =end — m_seki@...

[#25322] blade? — Takahiro Kambe <taca@...>

[#25333] Gtk: 個別に require — Yasushi Shoji <yashi@...>

[#25337] Win95 上で Ruby/GTK が動きません — ITO@...

[#25349] ruby for EPOC32 — Takeshi KAKEDA <kakeda@...>

[#25367] ＰＤＡ関係で、もう１機種 — "hata" <bxf01026@...>

[#25377] win32ole on ruby 1.6.0 [i586-cygwin] — 堀川 久 <vzw00011@...>

[#25378] Python のブロック — "ページコム佐藤" <k-satoh@...>

[#25388] media watch 2000.10.07 — Noritsugu Nakamura <nnakamur@...>

[#25389] install guide draft for OS/2 — kenn@...

[#25391] multipart/form-data — OMI Toshiaki <omi@...>

[#25393] [BUG?] ruby-mode.el — akira yamada / やまだあきら <akira@...>

[#25394] Is there SYTECOPY.RB ? — dezawa@...

[#25415] Re: ＰＤＡ関係で、もう１機種 — "hata" <bxf01026@...>

[#25417] Re: mswin32 組み込み用 Ruby — toyofuku@...

[#25427] rd2mgp — rubikitch <rubikitch@...>

[#25430] equal?ity of object by object type — "UENO Kazuaki" <kazu@...>

[#25436] Wintoys installation instructions — Aleksi Niemel<aleksi.niemela@...>

[#25439] html2cgi 1.0.5 — MoonWolf <moonwolf@...>

[#25441] Ruby/Jed — Toyofuku <toyofuku@...>

[#25445] media watch 2000.10 — Masaki Suketa <CQN02273@...>

[#25456] What is universal %Q escape — gotoken@... (GOTO Kentaro)

[#25459] FreeBSD section of install guide has been updated — "Akinori MUSHA" <knu@...>

[#25464] The Ruby Application Archive — Daisuke Aoki <dai@...>

[#25468] === of Range — OHARA Shigeki <os@...>

[#25474] 始めまして — matsue <mattue@...>

[#25483] 1.6.2? — akira yamada / やまだあきら <akira@...>

[#25491] 1.6 と cgi.rb — "Masao Shirakura" <masa@...>

[#25504] ＲｕｂｙＧｔｋ — Megumi Tanaka <m-tanaka@...>

[#25505] media watch 2000.10.18 — Noritsugu Nakamura <nnakamur@...>

[#25509] Re: media watch 2000.10.18 — SHIROYAMA Takayuki <psi@...>

[#25510] Re: net/imap.rb — Shugo Maeda <shugo@...>

[#25516] setter: two or more args — Yasushi Shoji <yashi@...>

[#25526] How to call an '='-ended private method — NISHIKAWA <nyasu@...3web.ne.jp>

[#25530] RE: How to call an '='-ended private method — Aleksi Niemela <aleksi.niemela@...>

[#25538] open3.rb — Takaaki Tateishi <ttate@...>

[#25567] Ruby で遅い処理は？ — Yasuki <yasuki@...>

[#25576] Re: [ruby-talk:5747] Q on Queue — m_seki@...

[#25578] Ruby/GTK の FileSelection が Win95 でうまく動きません — ITO Yoshiaki <yoshi@...>

[#25585] Strange Scope of Constants — YANAGAWA Kazuhisa <kjana@...>

[#25586] BUG ? net/smtp.rb with SMTP — Sakae Kobayashi <sakae@...>

[#25587] Ruby Readline — hiroya@...

[#25598] Re: Ruby/GTK の FileSelection が Win95 でうまく動きません — "岡本" <okamoto@...>

[#25599] 原先生の本 — WATANABE Tetsuya <tetsu@...>

[#25605] RDBC? — TAKAHASHI Masayoshi <maki@...>

[#25621] media watch 2000.10.24 — Noritsugu Nakamura <nnakamur@...>

[#25622] require で so をロードするときの環境変数について — Kengo Nakajima <ringo@...>

[#25628] RWiki 1.0 and てんこもりぱっく — Masatoshi SEKI <m_seki@...>

[#25633] ping.rb の使い方 — goto@...

[#25652] 拡張モジュールで定義されているモジュール名は？ — " たけ (tk)" <ggb03124@...>

[#25653] ブロックの返り値 — Kengo Nakajima <ringo@...>

[#25661] media watch — OZAWA -Crouton- Sakuro <crouton@...>

[#25667] (win32,cygwin) String#tr in jcode.pl — t-ochi <t-ochi@...>

[#25674] EOF before end of embedded document — YANAGAWA Kazuhisa <kjana@...>

[#25702] AERA — Noritsugu Nakamura <nnakamur@...>

[#25709] 複数の Enumerable — Yasushi Shoji <yashi@...>

[#25720] 日本語表示について — hkatsuno <hkatsuno@...21.co.jp>

[#25725] XML::SimpleTree::Node#accept_* — Yasushi Shoji <yashi@...>

[ruby-list:25340] Re: =begin, =end

Thread

In This Thread

[#25377] win32ole on ruby 1.6.0 [i586-cygwin] — 堀川　久 <vzw00011@...>