image

  • フォト Amazonギフト券
    ※この時計の時刻は、閲覧しているパソコンのものであり、必ずしも正確な時間とは限りません

検索

最近のトラックバック

無料ブログはココログ

« ピックアップ: 楽譜はどう書きますか?, Pathtraqは第二のGoogleになるか?, etc... | トップページ | ピックアップ:HTML5情報サイト, 平和的解決のススメ, XBRLパイロットデータ公開, etc... »

2007-08-14

xvcd 用のドキュメンテーションツールを作ろう

ruby には RD, rdoc というドキュメンテーションツールがある。
java には javadoc というツールがある。
doxygen という他言語対応のツールもある。

xfy/xvcd のための標準ドキュメンテーションツールはないのか?

なければつくれば良い。
fortran で RD, rdoc を利用した例があるようだ。

- http://www.gfd-dennou.org/arch/prepri/2005/ruby/RDinF90/RDinF90.htm
> > 自動ドキュメント生成システム rdoc と Fotran90 プログラムへの適用例

- http://www.gfd-dennou.org/library/dcmodel/rdoc-dennou/
> > Enhanced version of RDoc Fortran 90/95 parser

xvcd に限定せずに、 xml 中のコメントからドキュメントを生成するツール として
つくりあげればよい気がする。
すでに類似ツールがどこかにないかなぁ。

rdoc は ruby にふくまれているが、RD はそうではない。でも RD も便利そう。
RD のインストール方法は以下が参考になる。

- http://ujihisa.nowa.jp/entry/d23b111db9
> > rubyneko - そろそろrd2texを使ってもいいころ

RD の解説は
- http://jp.rubyist.net/magazine/?0006-RDIntro
> > Rubyist Magazine - RD でも書いてみようか 【第 1 回】 ブロックレベル

RD についての書籍は Rubyを256倍使うための本 魔道編 がある。

さて、どのように作業していけばよいか?

* xvcd に特化しないで、 <!-- --> コメントから document を生成するようにする
* その後、ソース参照もできるように xvcdに特化していく ...

プログラミング言語をつくる場合、動作実装だけでなく、
document システム, unit-test システム, debugger といったものも合わせてリリースされるとよい。そういった仕組みを備えた プログラム言語作成キットみたいなものはないのかなぁ。(
( parser ジェネレータは動作実装をつくるには便利だけど)

 

« ピックアップ: 楽譜はどう書きますか?, Pathtraqは第二のGoogleになるか?, etc... | トップページ | ピックアップ:HTML5情報サイト, 平和的解決のススメ, XBRLパイロットデータ公開, etc... »

コメント

コメントを書く

(ウェブ上には掲載しません)

トラックバック

この記事のトラックバックURL:
http://app.cocolog-nifty.com/t/trackback/184434/16109003

この記事へのトラックバック一覧です: xvcd 用のドキュメンテーションツールを作ろう:

« ピックアップ: 楽譜はどう書きますか?, Pathtraqは第二のGoogleになるか?, etc... | トップページ | ピックアップ:HTML5情報サイト, 平和的解決のススメ, XBRLパイロットデータ公開, etc... »

mokuji

2013年12月
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30 31        

google

  • twitter
  • __
  • _
    Googleボットチェッカー

合わせて読む

  • 合わせて読む
    フィードメーター - katoy: cocolog あわせて読みたい

リンク