タグ

2009年5月1日のブックマーク (2件)

  • Let’s use doxygen!

    はじめに プログラマには、ドキュメント、とくにプログラムの内部仕様書を書くのが苦手、 という人が多い。 その理由は明らかであって、そもそも、ソースコードに (バグも含めて)*1 すべての仕様が子細もらさず書かれているのに、なぜ、さらにそれと独立した仕様書が必要なのかと、 (半ば気で) 思ってしまうからである。 ソースコードと独立にメンテナンスをしなければならないような仕様書は、 いずれソースコードと整合性が取れなくなって、無意味ならまだしも、 かえって害をなす存在となり果てることもある、ということを、 彼らは経験的に理解しているのである。 (*1) Ruby の作者である、まつもとゆきひろ氏は、 その著者『オブジェクト指向スクリプト言語 Ruby』の中の「付録C Ruby 用語集」で、 次のように書いている: ドキュメント まつもとの苦手なもの。彼は普段から「ソースがドキュメントだ。

  • Meadow/Emacs memo:

    現在の最新版での確認が追い付いておらず,設定も古くなってきています.順次, 確認していきますが,中には動かないもの,エラーになるものもあると思います.気付い た方は,最下部のメッセージかメールにて知らせていただけるとありがたいです. 新規追加分の動作確認は Meadow 3.0 でのみ行っています。 Meadow の最新版 (あ るいは Emacs の最新版) では一部古いものと異なる機能などがあります。このページで紹 介しているものも既にいくつかは動作しませんので、ご注意ください。気付いた点は Wiki にメモしてあります。 このページでは Emacs を Windows に移植した Meadow というテキストエディタについて, ゼロからの基礎知識 使い倒すための設定 誰が使うんだよという無駄な設定 Emacs Lisp の紹介 Unix の知識 と片っ端から紹介しています.ほとんどの