ruby-list

Toshです。

In message "[ruby-list:23604] Re: readablity of RD"
    on 00/06/29, Yukihiro Matsumoto <matz@netlab.co.jp> writes:
>|>%%%%%%%% ******** ======== --------
>|>
>|>こんな感じとか。
>|
>|ふ〜む、話しているとだんだんよさげに思えて来るのですよね。(^^;;
>|でもまつもとさんのほうから鶴の一声が入っちゃったしなぁ、とか。
>
>いや、RDより「書きやすい・読みやすい」フォーマットが出て来ちゃ
>ダメとはいいませんよ。それはRDではないというだけです。

う〜ん、でもRDtoolのパーサにこっそり入れておいても余計な混乱生む
だけって気もしますし。かと言って、パーサ2つメンテするだけの余裕も
なし。

>それに、私はterseなのが好きなので
>
>|%%%% Title %%%%%
>|**** Title *****
>
>というのは受け入れがたいです。もしかして「読みにくい」って人
>はRDのterseさが御嫌いなのではないでしょうか。

僕がいまいちわからないのは、

  == Title
  === Sub Title

の様な形式が「terse(って辞書ひくまでわかりませんでしたが、"簡潔"で
いいですよね？)」であって、

  %%%% Title %%%%
  ==== Sub Title ====

が「terseでない」という感覚ですね。僕には大差ないように思えるのですが。

>私はsetextあんまり好きじゃないです。RDより「読みやすい」だろ
>うとは思うけど、「書きやすくない」と思います。3以上の数を気
>にしないといけないのが私には一番つらい。それにRD(ソース)のレ
>ベルで指示が本文より目立つのは本末転倒でしょう。

でもパラグラフやリストよりGlobalで目立つべき見出し要素がパラグラフに埋
もれて目立たないのもおかしな話では？

「目立つ見出し」の提案は、別に「指示(書式となる記号列)」を目立たせるた
めでなくて「見出しと言う要素」を目立たせる必要がある、って意味ではない
ですか？

そういう理由で「もっとも」なのです。僕には。

In message "[ruby-list:23602] Re: readablity of RD"
    on 00/06/29, Yukihiro Matsumoto <matz@netlab.co.jp> writes:
>「もっとも」なんですかねえ。


>メソッド毎に=begin/=endでくくるとごちゃごちゃするってのは確
>かなんですが、そもそもそういう使い方での読みやすさってのはあ
>んまり必要ではないと思うのです。
>
>局所的にレベルが分かれば、読みやすさのためにはLaTeXなりなん
>なりに変換することで対応すれば十分のように感じています。
>
>ってそういう話じゃないのかなあ。

Globalな構造をどれだけ速く把握できるか、と言うのはドキュメント
のメンテナにとってかなり重要ではないですか？

スクリプトの変更に合わせてドキュメントを変更するのに、最初にする
のが、「ドキュメントのどこを変更すればいいのか探すこと」ですよね。
最初にGlobalに探して、あたりをつけたところでLocalに探すというのを
意識・無意識に関わらずやっているはずです。そういう時にGlobalな探査
でもっとも頼りにしているのが見出しのような構造なのではないかと。

「読むだけの人ならHTMLにでもInfoにでも好きな形式に変換すればそれで済む。
いやでもソースを読まないといけなくなるのは結局書いている/メンテしてい
る本人で、その人が楽できるようなフォーマットは読みやすくないといけない」
っていうのが、僕のRD観です。

---
Tosh
Toshiro Kuwabara

Thread

Prev Next

In This Thread

Prev Next

[#23023] 社名変更のご挨拶 — matz@... (Yukihiro Matsumoto)

[#23024] net/ 1.1.20 — Minero Aoki <aamine@...>

[#23026] ruby compile/ruby-gtk — Taiji.Can@...

[#23031] description on fork and Process.fork — kjana@... (YANAGAWA Kazuhisa)

[#23032] Racc Array#filter -> collect! — Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>

[#23036] '==' causes TypeError — NISHIKAWA <nyasu@...3web.ne.jp>

[#23037] media watch 2000.05.29 — Noritsugu Nakamura <nnakamur@...>

[#23052] UTF-8 on print method — kenn@...

[#23056] JLA Doc-CD アンケートのお願い — Hisaaki Shibata <shibata@...1.netspace.or.jp>

[#23061] rfc822.rb parse error — Hideto ISHIBASHI <hideto-i@...4u.or.jp>

[#23079] Re: [ruby-talk:03129] Re: my wish list for Ruby - dRuby — Masatoshi SEKI <m_seki@...>

[#23085] about : ruby-mode.el — Masahiro Kawata <kawata@...>

[#23088] 文字列置換 — Takayuki Tanaka <tanaka@...>

[#23095] setup.rb testrun — rubikitch <rubikitch@...>

[#23096] http.rb will change — Minero Aoki <aamine@...>

[#23115] rd2ewb — gotoken@... (GOTO Kentaro)

[#23116] making Array — OZAWA Sakuro <crouton@...>

[#23125] メソッドの中の動きを変える — Masahiro Kawata <kawata@...>

[#23140] Apollo 0.601 — Kazuhiro Yoshida <moriq.kazuhiro@...>

[#23141] Re: [ruby-math:00302]: Float#ceil, Float#floor, Float#round — "Shigeo Kobayashi" <shigeo@...>

[#23156] ports — Wakou Aoyama <wakou@...>

[#23161] RDtool trouble. — rubikitch <rubikitch@...>

[#23168] media watch 2000.06.08 — Noritsugu Nakamura <nnakamur@...>

[#23169] Kconv::guess(str) — NAWATE Masahiko <agul@...>

[#23171] Re: Kconv::guess(str) — NAWATE Masahiko <agul@...>

[#23177] Re: Kconv::guess(str) — NAWATE Masahiko <agul@...>

[#23185] commonly used notation — Hideto ISHIBASHI <hideto-i@...4u.or.jp>

[#23190] pstore — Masatoshi SEKI <m_seki@...>

[#23191] pstorewc — Masatoshi SEKI <m_seki@...>

[#23197] self の振る舞いを書き換えたいです — Kenya Ogata <k_ogata@...>

[#23214] Access serial port (cygwin32) — Hagemu Higuchi <hahiguc@...11.odn.ne.jp>

[#23222] readablity of RD — TAKAHASHI Masayoshi <maki@...>

[#23230] Usage of system function — Hagemu Higuchi <hahiguc@...11.odn.ne.jp>

[#23235] nkf MIME space handling — "Kikutani, Makoto" <kikutani@...>

[#23259] libpng wrapper library — "DATE Ken" <ge6537@...>

[#23274] encoding of files from cvsweb — TAKAHASHI Masayoshi <maki@...>

[#23277] net/smtp.rb extra lines ? — "Kikutani, Makoto" <kikutani@...>

[#23284] Ruby/zlib — Ueno Katsuhiro <unnie@...>

[#23303] RDlabel bug — rubikitch <rubikitch@...>

[#23305] xmarshal.rb — Masatoshi SEKI <m_seki@...>

[#23308] "make test" error on MacLinux — Ryutaro Matsushita <ryutaro@...>

[#23311] UTF-8 in RubyBook — "Kikutani, Makoto" <kikutani@...>

[#23356] rd2texi-lib.rb 最新版？ — Noritsugu Nakamura <nnakamur@...>

[#23357] media watch 2000.06.17 — Noritsugu Nakamura <nnakamur@...>

[#23359] ASP — Yoshinori Tahara <platypus@...1.mbn.or.jp>

[#23368] Message Digest (MD5) Function — Hagemu Higuchi <hahiguc@...11.odn.ne.jp>

[#23372] (GMT+0500) — "Kikutani, Makoto" <kikutani@...>

[#23384] oracle on UnixWare — 市村 光康 <ichimura@...>

[#23385] DBMS and ruby CGI — toyofuku@...

[#23401] Re: Message Digest (MD5) Function — Hagemu Higuchi <hahiguc@...11.odn.ne.jp>

[#23410] Re: DBMS and ruby CGI — "Kahori Takeuchi" <EB89012@...>

[#23411] dump a single object — Hideto ISHIBASHI <hideto-i@...4u.or.jp>

[#23416] ruby <--> java <--> C++ — Noritsugu Nakamura <nnakamur@...>

[#23422] catch/throw — NAWATE Masahiko <agul@...>

[#23428] Re: catch/throw — NAWATE Masahiko <agul@...>

[#23452] ftp.rb で resume — "Uechi Yasumasa" <uechi@...>

[#23454] MHC in RAA — Yoshinari Nomura <nom@...>

[#23475] about cgi.textarea() — goto@...

[#23477] Re: DBMS and ruby CGI — toyofuku@...

[#23485] Ruby 1.4.5 — matz@... (Yukihiro Matsumoto)

[#23497] cgi.rb でエレメントの削除可能？ — Noritsugu Nakamura <nnakamur@...>

[#23500] Ruby/zlib — Ueno Katsuhiro <unnie@...>

[#23501] Ruby 1.4.5 repacked — matz@...

[#23504] 拡張ライブラリの作り方 — Akimichi Tatsukawa <akimichi@...>

[#23508] about cgi.rb — goto@...

[#23509] Dimension of array — agul@...

[#23519] media watch 2000.06.24 — Noritsugu Nakamura <nnakamur@...>

[#23520] pty on 48 — Noritsugu Nakamura <nnakamur@...>

[#23533] Solaris から Linux への変更 — Yoshihiro Nakahara <yoshihiro@...>

[#23537] Ruby Language reference manual version — MATUDA Hazime <matsuda@...>

[#23539] [Q] unix のコマンドとのデータ受け渡し方法 — Sakae Kobayashi <sakae@...>

[#23550] protocol.rb http.rb 1.1.24 — Minero Aoki <aamine@...>

[#23555] insert_table(postgres) — Noboru Saitou <noborus@...>

[#23558] ruby-1.4.5 GNUmakefile — IWATSUKI Hiroyuki <don@...>

[#23574] ruby-list was crashed; restored — matz@... (Yukihiro Matsumoto)

[#23589] optparse / racc — TAKAHASHI Masayoshi <maki@...>

[#23608] about array::pack — goto@...

[#23629] 1.4/ruby-1.4.5.tar.gz — Yasuhiro Fukuma <yasuf@...>

[ruby-list:23613] Re: readablity of RD

Thread

[#23384] oracle on UnixWare — 市村光康 <ichimura@...>