APIドキュメント @ Blog - Linux Life

APIドキュメント

2005/07/26 ( n ) < Doxygen KreetingKard >

色々調べて書いてみる。
Qt は /*! */ のスタイルだが、KDE では /** */ が多いようだ。

Doxygen は出力言語が選べるらしく、Japaneseにすると日本語でマニュアルが作成された。
ファイルのエンコードがUnicodeなので、入力フィルタ(INPUT_FILTER)に「nkf -e」が必要
Japanese-euc、Japanese-utf8、Japanese-sjisとかになってたら便利なのに。

QPROPERTY に対するコメントを以下のように記述すると Qt のドキュメントだと get/set に対してコメントが付加されているようだがそうはならなかった。

/**
* \property プロパティ名
* 説明
*/

ドキュメントを日本語と英語で書けたら(日本語だけ書いておけば後で訳してくれる人がいれば) 楽だなぁと思って色々調べたが、正式な方法では無理っぽい。
m17nのドキュメントは日本語版と英語版があり、ずるいことをして生成してるらしい。
英語と日本語のドキュメントを #if - #else - #end で分けてみるとうまく表示されたのでよいことにしよう。
日本語(゜д゜)ウザァって外国人(？)が現れたら泣く泣く削除するって事で。

スポンサードリンク

2009年01月
日	月	火	水	木	金	土
1	元旦
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

ダンジョンズ＆ドリーマーズ
UO開発の歴史とロマン
★★★☆☆

正規表現デスクトップリファレンス
具体的な文法や利用法がコンパクトにまとまっています。
★★★☆☆

インテルスレッディング・ビルディング・ブロック —マルチコア時代のC++並列プログラミング
マルチコア時代のC++並列プログラミング
★★★★★

Effective C++ 原著第3版
C++での開発をしている方は必携です。
★★★★★

入門bash
身近で強力なbashを使いこなし、様々な手続きを便利にしましょう。
★★★☆☆

UNIXシステム管理
様々なUNIXの管理をするための情報が網羅されています。
★★★☆☆

Unixバックアップ&リカバリ
サーバー管理者は必読！自信と安心をこの本で。
★★★★☆

仕事で差がつくメモ術・ノート術
うーん
☆☆☆☆☆