Gauche:Translation:Devlog:オンラインドキュメントのちょっとした改善

Gauche:Translation:Devlog:オンラインドキュメントのちょっとした改善

(原文: Little improvement of online doc)

0.9.5 において、オンラインドキュメント (REPL での info コマンド) は、項目を含む info ページのかわりに指定された項目のみを表示します。

gosh> ,info make-queue
 -- Function: make-queue
     Creates and returns an empty simple queue.

これはページ全体を読むよりは楽ですが、どのモジュールをインポートすべきなのかエントリ単体からは明らかではありません。 info で読んでいる場合であれば、あなたがいるセクションを見るのは簡単ですし、セクションはモジュール名を表しています。 オンライン文書はそのような文脈の埒外にあります。

私はそれについて検討してきましたが、一種の力任せな解決方法をとることを決断しました。 全ての項目にモジュール名を追加します。 HEAD (0.9.6 になるもののことです) では、以下のように表示されます。

gosh> ,info make-queue
 -- Function: make-queue
     {data.queue} Creates and returns an empty simple queue.

info ドキュメントを読んでいるときにすべての項目でモジュール名が繰り返されるので少しうざったいかもしれません。 でも、必要な情報が表示されないのはもっと苛立たしいです。


Last modified : 2017/04/03 05:35:08 UTC