タグ

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

  • ASDoc覚え書き (godagoda.net)

    僕のプログラムにコメントを付けない癖を改善すべくASDocを勉強することに。 一応メモ。 ASDocってのは、クラスやらメソッドやらプロパティやらに書かれたコメントをHTMLにしてくれる優れものです。 Flex 2 SDK がインストールされてれば使えます。 早速実験。 ASDocはターミナルで、/Applications/Adobe Flex Builder 2/Flex SDK 2/bin/asdocを叩いて実行します。(Mac環境) ■asdoc コマンドの主なオプション ・-source-path :クラスファイルがあるディレクトリを指定します。 ソースファイルを/Users/godagoda/study/flex/asdoc/に作ったら

  • プログラマーにとっての読み書きそろばん : 小野和俊のブログ

    基礎的な学力を表す言葉として読み書きそろばんという言葉があるが、 私はプログラミングについても読み書きそろばんに当たるものがあると思っている。 まず読みというのは、プログラムを読む能力である。 たまに、人の書いたソースを見て、すぐに 「全面的に書き直さないと使い物にならない」とか、 「グチャグチャですよ」とか、 「気持ち悪い」といったことを口にする人がいるのだが、 多くの場合、なぜそのように感じるのかを聞いてみると、 単に自分が今まで書いてきたコードと違ったスタイルで書かれている、 ということだったり、ごく一般的なデザインパターンが使われているのに、 そのデザインパターンを自分が知らないだけで 「わかりにくくて読めない」などと言っていたり、 人のコードを使い物にならないと簡単に口にする人であればあるほど、 その人自身が使い物にならない、という傾向がある。 もちろん、全体の整合性を取るために

    プログラマーにとっての読み書きそろばん : 小野和俊のブログ