nDiki : Javadoc

Java のソースコードからドキュメントを生成するツール。 標準ではHTML形式のドキュメントを生成する。 doclet を使用する事で、他の形式のドキュメントを生成する事もできる。

同様のツールとしては doxygen などがある。

 -link オプションに与えるURL(package-list ファイルのあるところ)

Code Conventions For The Java Programming Language DoctorJ メモ Ant C++ IDE build.xml JRE インタフェース 仕様 コーディング規約 UTF-8 Pod プログラミング言語 ドキュメンテーションコメント GNU LGPL 識別子 usr 書き方 再起動 ISO 統計 実行可能ファイル ロケール 検索 Java の assertion pod2latex インデント幅 J2SE JSmooth

■ 17:15 Checkstyle を ant に追加

Checkstyle は Java のコードのスタイルや Javadoc 用コメントのチェックをする Java クラス(コマンドラインツール / Ant タスク)。

Debian のパッケージにはまだなっていないので、公式サイトからとってきて .jar ファイルを /usr/local/share/java に放りこむ。 必要なライブラリの ANTLR と Regexp は Debian パッケージになっているので入れとく。

コマンドラインでちょっと試した後 build.xml にターゲット追加して統合。 これで JUnit とあわせて、コードの品質があがるようにがんばろ。

• Linux 上で Flex 2 SDK を使った Flash コンテンツ開... (2007-09-11)
• 15:00 Java Cryptography Extension (JC... (2001-12-04)
• 21:00 Xalan-Java + Bean Scripting Fra... (2001-11-27)
• PAR (2004-07-19)
• PostgreSQL を使いはじめる (1999-12-17)

■ pod2latex

仕事で書いた Perl モジュールの API 仕様を紙媒体にしなければならないので、今回は pod2latex を使ってみる。

 pod2latex -modify -full -out hoge-utf8.tex lib

で lib ディレクトリ以下の *.pm の Pod が集められて hoge-utf8.tex になる。ソースを UTF-8 で書いているのでこれを lv などで EUC-JP に変換して、platex してdvipdfmx。

前に Javadoc から LaTeX に落とした時に比べて非常にすんなりと変換してくれる。 '=item foo([opt])' とかすると ] 文字が落ちたりする以外は特に今のところ目につく問題なし。

ま、いざとなったらスクリプトに手を入れて直せるだろうし、なかなかいいんじゃないでしょうか。

• Twitter ベイジアンフィルタプロキシ (2007-12-29)
• bundle を作成して Perl モジュールをまとめてインストール。 (2004-10-21)
• 日本語ファイル名どんとこい (2005-03-07)
• pLaTeX + hyperref + dvipdfmx で PDFにしおりを (2005-04-15)
• LaTeX でプレゼンテーション (2005-06-21)