【コメント】doxygen【コンソメ】

■ このスレッドは過去ログ倉庫に格納されています
2008/05/30(金) 19:50:27
無いので建てた

公式
http://www.doxygen.jp/
164162
垢版 |
2009/04/25(土) 21:45:11
>>163
レスありがとうございました。
確認したら「@param なし」ではwarning argumentと出ましたのでこれは書かないようにします。
2009/04/30(木) 13:43:57
今の大会は、開発環境の違いによる面白さもあると思う。
共通スペックでやるなら別に大会をおこせばよいと思う。
2009/04/30(木) 13:45:15
>>165
誤爆しました。すみません。
167デフォルトの名無しさん
垢版 |
2009/04/30(木) 23:56:10
Doxygen 1.5.9 age
2009/05/01(金) 00:16:08
さっきまでは1.5.8だったのに。早速試すぜ。
169デフォルトの名無しさん
垢版 |
2009/05/12(火) 10:55:11
ソースの先頭のコメントの 理想的なサンプル を教えて。
言語は問わないけど、出来ればCで。
2009/05/12(火) 18:22:26
理想的かどうか知らんが、私の典型。
--
////////////////////////////////////////////////////////////////
/// \file foo.c
/// \brief あーたらこーたら
///
/// あーたらこーたらをあーたらこーたらするとかなんとか。
/// \date 2009/3-4
/// \author bar\@site
/// \attention なんだかんだ
/// \version hage.hige.hoge
//
--
2009/05/13(水) 04:06:28
>>169
とりあえず最小限はこうだろ。 JAVADOC_AUTO_BRIEF オンで。

/** @file
* 簡単な説明.
* 詳細な説明
*/

170 のやつだと、ファイル名はどうせ名前変更したときに更新し忘れるし、
日付や作者やバージョンはバージョン管理ソフトに任せればいい。
詳細な説明も attention も必要に応じて、だな。とにかく書かないで済むものは
書かないのが一番。
2009/05/13(水) 09:19:41
>>170
ありがとうございます。

>>171
そのバージョン管理ソフトに書かせるので心配ゴム用です。
2009/05/13(水) 16:20:47
表書くのってtableタグ使うしかないんでしたっけ？
それだとソース上で見づらいんで、
リストみたいに簡易記法があればいいんですけど。
2009/05/13(水) 22:00:48
doxygenって使ったこと無いんだけど、
ぶっちゃけて言うと、オススメですかい？
2009/05/13(水) 23:26:06
>>174
おすすめとは言えない

でも面白い使い道がある事は確か

実際に走らせてみて「おー」とか言って楽しむものだと思う
2009/05/14(木) 09:55:19
>>174
クラス関連図とか、煩いクライアント向けのコーリングツリーを作るのに便利。
# 余程酷いソフトハウスに当たった経験があるのか、関数の依存関係を知りたがるクライアントがいるのよ。
177174
垢版 |
2009/05/14(木) 22:16:15
>>175-176
ほっほー。
ありがとう。
「ある程度習熟するために勉強を要してめんどくさそうだ」
と思っていたが、試してみようかなあ。
2009/05/14(木) 23:43:40
>>177
コメント付いてないのも全部出力する設定で、
とりあえず手持ちのソースそのまま掛けてみたらいいよ。

それで出来上がるものが気に入れば、それから書き方に慣れていったらいいし。
2009/05/14(木) 23:50:13
Graphvizの使い方が秀逸だと思う
これは出力結果を印刷してじっくり眺めたい
180177
垢版 |
2009/05/15(金) 06:46:11
>>178
ありがとう。分かった、そうしてみるわ。
2009/05/15(金) 09:37:18
客先から小汚いソースを受け取ったら、取り敢えずDoxygenに掛けて
静的解析するのは基本だな。
2009/05/15(金) 10:09:23
>>171
subversionとかの置き換えキーワードもdoxygenは認識してドキュメント化してくれる。
2009/05/21(木) 13:35:09
ちょっと詳しい説明を箇条書きで入れたいんだけど、
空白行が入るとパラグラフが終わってしまうので、空白行を一切入れないで
長い文章を書かなきゃいけなくなり、なんていうか
ソースコードのコメントが非常に見づらい。本末転倒な気がするんだけど、
空白行を無視してくれる方法とか、ない？
2009/05/23(土) 02:32:07
>>183
ソースコード上でだけ行間が空いてればいいのなら、
全角スペースを入れておけばどうでしょう？
ドキュメント上で行が連結されたときに、余分な空白が入りますが。

ドキュメントでも行間が空くようにしたいのなら、
行頭の邪魔にならないところにでも「@n」を入れておくぐらいしか思いつきません。
2009/05/24(日) 13:15:10
doxygenの文字化け対策
ttp://d.hatena.ne.jp/kmt-t2/20090403/1238718375
ここに救われた俺がいる。
2009/05/24(日) 14:01:52
doxygenであるライブラリのドキュメントを作った時、
そのライセンスってどこにどうやって記載すればいいの？

ドキュメント内に表示されるようにしたいんだけど。
187174
垢版 |
2009/05/24(日) 16:39:03
doxygen気に入ってきた。


C++とdoxygen最新版にて。

ドキュメント作ると名前解決に使う::がドキュメントにもりこまれたり盛り込まれなかったりする。
例えばNameS::MyClassが、
ドキュメントの100行目ではNameS::MyClassになっているのに
101行目ではNameSMyClassになっていたりする。

これはどう解決すればいい？
2009/05/25(月) 10:31:42
>>187
このレスの流れを見ても分かるように、Doxygenは文字コードの扱いが未だ未だ不安定だったりする。
あんたの言う、「ドキュメント」がrtf出力ならこのスレにある対策版を使ってみた方がいいかもしれないし、
chm出力なら>185を参考にするといいかもしれない。
2009/05/25(月) 20:01:17
>>186
@mainpageコマンドでメインページに入れるか、
@pageコマンドで独立したページにすればどう？
190174
垢版 |
2009/05/25(月) 23:27:45
>>188
ありがとう。
説明不足だったね。
ドキュメントはフツーのHTMLなんだよね〜。chmじゃなくて。

>185をやってみたら文字化けは解消したんだけど
>> ドキュメントの100行目ではNameS::MyClassになっているのに
>> 101行目ではNameSMyClassになっていたりする。
この現象は解決しないのだ。。。

191186
垢版 |
2009/05/25(月) 23:41:59
>>189
@pageコマンド
なんて初めて知ったわ。

どこかいい解説サイトとか紹介してくれる
お方、いらしたらお願い！
2009/05/27(水) 12:59:53
>>191
doxygenに付いてくるサンプルも参考になるよ。
当然全部英語だけど、記述例のソースと
それを使って出力されたドキュメントがある。
コマンドの説明が知りたかったら、
>>1 のサイトの日本語版マニュアルを見ればいいし。
193186
垢版 |
2009/05/27(水) 19:11:01
>>192
そうか、ありがとう。
見てみるよ。
2009/05/28(木) 03:59:47
いつの間にかDoxywizardもだいぶ使いやすくなったんだな
195186
垢版 |
2009/05/28(木) 06:28:18
俺は最近doxygenを使い始めて、
最初に
Doxywizard
を使ってかなり直感的に操作できたから知らなかったが、
そうなのか。前は使いづらかったのか。

grach
2009/05/30(土) 12:54:18
#defineマクロ定義をドキュメント(html)に出力させたくて
ttp://www.doxygen.jp/commands.html#cmddef
ここを見て

C++ code - 19 lines - codepad
ttp://codepad.org/mUM77yZO

こんなの書いてみたんですが、
全然#defineマクロ定義が出力されません。

どうすれば良いでしょうか？
2009/05/30(土) 17:17:56
>>196
define_test.h のファイルのページ自体は出来てる？
実際のファイル名と @file の後ろに書いたファイル名が合ってないとかはないかな、と思ったもので。
198196
垢版 |
2009/05/30(土) 23:13:55
>>197
ttp://loda.jp/uploader_nrnrnr/?id=2
こんなHTMLが生成されました。

どうなんでしょう。。。？
199197
垢版 |
2009/05/31(日) 00:25:04
>>198
define_test.h ファイルのドキュメントのページができてないね。
>>196 のソースをコピペして同じ名前で保存してみたけど、
こっちじゃちゃんと出力されてるよ。

Doxyfile 晒してもらえるなら、何が違うか比べてみるけど。
200197
垢版 |
2009/05/31(日) 00:31:38
>>198
もしかして、SHOW_FILESがOFFになってない？
Doxywizard使ってるなら、ExpartのBuildの下の方。
201196
垢版 |
2009/05/31(日) 04:59:33
>>200
丁寧にありがとうございます。
Doxyfileは以下です。
C++ code - 1503 lines - codepad
ttp://codepad.org/aNCHcRW3
お願いします。
202196
垢版 |
2009/05/31(日) 05:04:41
追記：
　　SHOW_FILES=NOになっていましたが、
　　YESにしても変わりませんでした。
　　私の環境は
　　windows xp sp2
　　doxygen 1.5.9です。
203197
垢版 |
2009/05/31(日) 05:45:10
>>201
WARN_IF_DOC_ERROR を ON にしたら判明した。
ENABLE_PREPROCESSING が OFF だとマクロは見てくれないらしい。
204197
垢版 |
2009/05/31(日) 05:51:37
補足

WARN_IF_DOC_ERROR を ON にしたら、
「マクロにコメント書いてるけど、ENABLE_PREPROCESSINGがOFFだからスキップしたよ」
というようなメッセージが表示された。
205196
垢版 |
2009/05/31(日) 14:59:44
>>204
ありがとうございます。
WARN_IF_DOC_ERRORとENABLE_PREPROCESSINGをYESにしてみましたが、
結果は代わりありませんでした。
Doxyfileはこちらです。
ttp://codepad.org/rsH3deU0
設定を読み込み直していないなどということはなく。
doxygenのウィンドウに表示される情報は
ttp://codepad.org/bqYOU7ug
の通りです。

すみませんがよろしくお願い申し上げます。
206196
垢版 |
2009/05/31(日) 22:27:30
追記：
　　テキストエディタでDoxyfileを開き、
　　= NO
　　を検索して全て
　　= YES
　　に置換してみました。
　　それでdoxygenを走らせたところ、見事#defineは出力されました。
　　やはり設定が問題な様です。

207196
垢版 |
2009/05/31(日) 22:43:14
どこの設定が問題なのか探るために
Doxyfileにて二分木法的にNOをYESに置換してみました。

ファイルのど真ん中の行を基準に上だけないし下だけを
全部NO→YES置換を行いました。

しかし、このどちらも#defineが出力されません。
やはり複数の設定項目が関わっているようです。
208196
垢版 |
2009/05/31(日) 22:56:12
解決しました。

正解は
・ENABLE_PREPROCESSINGをYESにする。
・SHOW_FILESをYESにする。
でした。両方が同時に満たされていないとだめなようです。

お手数をおかけ致しました！
209197
垢版 |
2009/06/01(月) 01:23:37
>>205-208
解決したようなのでもういいかもしれないけど、
WARN〜系の設定は、出力状態を変更させるためのものではなくて、
コメント付けてるのに出力されない設定になってるとか、
記述漏れがあるとか、そういうエラーメッセージを表示するためのもの。

今後何かうまくいかないときに参考になるかもしれないので念のため。
210196
垢版 |
2009/06/01(月) 05:54:55
>>209
はい、WARN〜系の設定に関して、よく頭に入れておきます。

ありがとうございました。
2009/06/01(月) 23:20:24
Windows XP SP2, doxygen 1.5.9です。
htmlドキュメントを生成すると、
本文中のstd::coutのようなスコープ解決演算子が消えてしまい、
stdcoutになってしまうことが多々あります。
再現するソースやその結果のhtml, Doxyfileは以下の様です。
ttp://loda.jp/uploader_nrnrnr/?id=3

具体的にはこのソースにて
　Test::foo()は
　numをstd::coutに出力します。
になるはずが
　Test::foo()は
　numをstdcoutに出力します。
になってしまいます。

再現条件は絞れておりません。
どうかお知恵をおかしください。
よろしくお願い申し上げます。
2009/06/02(火) 02:54:51
>>211
理由はよく分からないけど、std::coutの前後に空白を入れたら正しくなりました。
識別子っぽいものに非ASCII文字がくっついてたらおかしくなるってことじゃないかと思うんですが。
213211
垢版 |
2009/06/02(火) 06:08:56
>>212
たしかに、前後に空白で正しく表示されます。
本当に適用したいソース(再現用ソースでない)でもうまく表示されます。
ありがとうございました。
2009/06/02(火) 23:53:16
>>195
今のdoxywizardはver.1.5.8(去年の暮れ頃)からですね。

基本的な設定項目だけのwizardモードと、
設定可能な項目が全部表示されるexpertモードの２本立てというのは
昔も今も変わりませんが、
設定を変えたら保存しないと実行できなかったとか、
設定項目のセクション切り替えがタブで、expertモードだと
たくさん並んでるのをぐるぐるスクロールさせる必要があったとか、
細かいところで少し不便でした。

マニュアルに載ってるスクリーンショットは旧バージョンのような気がします。
2009/06/02(火) 23:58:29
doxygenで、1カ所に書いたコメントを複数箇所で参照する方法はありますか？

例えば、
hoge.h内で@version 1.1.1
という記述が同じhoge.h内で他にも複数箇所に登場する場合、
全部に@version 1.1.1と書いてしまうとバージョンを上げる時に
全箇所を手動で修正する羽目になってしまいます。

どうにかする手段はありますか？

2009/06/03(水) 02:07:50
>>215
設定ファイルのALIASESで@version 1.1.1に別名をつければ、
バージョンを上げるときはそこだけ変えればOK

というのはどうでしょう？
217デフォルトの名無しさん
垢版 |
2009/06/03(水) 03:43:33
質問です。

いままでのプログラムは以下のようにコメントしていたのですが、
doxygenでは/** */の形式にしないとドキュメント作成はできないのでしょうか？
コメント部分を目立たせたいので、できれば今までのコメント形式を維持したいのですが・・

今までのコメント例
//********************************************************
// Test.cpp
// 2009.09 by Tester
// テスト用のクラス
//********************************************************

これを
/**
*
*
*
*/
形式にするのは少し抵抗があります
2009/06/03(水) 08:40:05
>>217
特定の形式にしないと、ドキュメントにしないコメントと区別できないですからね……

使えるコメント形式はマニュアルの「Documenting the code」にいろいろ例があります。
(日本語マニュアルは古くて少し情報が少ないです)

今までのに比較的近いのは
/*****************************************************//**
* Test.cpp
* 2009.09 by Tester
* テスト用のクラス
*********************************************************/
でしょうか。
2009/06/03(水) 10:41:33
>>217
最初と最後の //****** はそのままで、途中の行だけ先頭の//を3文字にすればいい
2009/06/03(水) 10:48:32
つまり、こうだな。
//********************************************************
/// \file Test.cpp
/// \date 2009.09
/// \author Tester
/// \brief テスト用のクラス
//********************************************************
2009/06/03(水) 16:06:28
>>217
俺も抵抗があったけど、
変えてみたら意外と平気だったよ。
要は見慣れるかどうか。
2009/06/03(水) 16:09:51
>>216
ALIASES
なんてものがあるのですね。
ありがとうございます、試してみます。
223デフォルトの名無しさん
垢版 |
2009/06/03(水) 22:23:44
>>218-221 thanks

ですが、ファイルの最初のコメントを
//********************************************************
/// \file Test.cpp
/// @file TEST.cpp
//********************************************************

と色々やってみたのですがうまくいきませんでした・・
ファイルの最初だと///ではドキュメント化されないのでしょうか
クラス宣言前や関数前では///で書いたコメントはちゃんとドキュメント
のコメントとなっておりました。

ちなみに、ファイル一覧からコードを見るとなぜか明朝体？で表示されてしまいます。
以下のドキュメントのようにゴシック表示をしたいのですが、Font設定はどのようにすればよいでしょうか？
http://www.ee.t-kougei.ac.jp/tuushin/lecture/technicalWriting/euclid/html/euclid_8c-source.html

224デフォルトの名無しさん
垢版 |
2009/06/03(水) 22:57:41
追加で質問失礼。

Player.hの内容↓

/** @brief クラスの簡易説明
　*　このクラスの使用目的・使用方法など詳しい情報を書く。
　*　@todo 必要であれば記述
　*　@bug バグがあれば記述
*/

#if !defined (__PLAYER_H__)
#define __PLAYER_H__

class CPlayer
{
...
}


というプログラムだと、インクルードガードのほうに

マクロ定義
#define __PLAYER_INFO_BASE_H__
クラスの簡易説明 　*　このクラスの使用目的・使用方法など詳しい情報を書く。

というドキュメントが付いてしまうのですが、
インクルードガードは一番上に書かなければいけないのでしょうか？

できればファイルに関するコメントを一番上に記述したいのですが・・・
225デフォルトの名無しさん
垢版 |
2009/06/03(水) 23:10:52
さらに追加質問ですいませんorz


出力されたドキュメントは任意の名前のフォルダに作成されますが、
index.htmlが他の細かいファイルと一緒のフォルダにあるため探しづらいです。
そのため、index.htmlだけ残して他のファイルを別のフォルダに押し込む
というようなフォルダ構成を構築したいのですが、そういったことは可能でしょうか？
2009/06/03(水) 23:33:53
>>223
ファイルの最初のコメント:
ファイル名の大文字・小文字の問題かもしれません。
ファイル名無しで @file だけにしてみてはどうでしょうか。

フォント:
フォントはデフォルトのスタイルシートで、
font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
と設定されてるので、
特にカスタマイズしてなければゴシックで表示されるはずなんですが。

>>224
対象を指定しないドキュメントは、直後にあるものに関連づけられます。
ファイルに関するコメントにしたいなら、@file が必須です。
2009/06/04(木) 08:53:01
>>224
本題とは直接関係ないと思いますが、ドキュメントに「 * 」が入ってるのが気になりました。
コメント行頭の「 * 」のところ、全角スペース使ってませんか？
228デフォルトの名無しさん
垢版 |
2009/06/04(木) 23:00:02
>>226-227
thanks.

一度doxygenを全削除して再インストールしたら
なんとかファイル要約関連のコメントはでるようにできました。
229デフォルトの名無しさん
垢版 |
2009/06/05(金) 00:21:06
また質問なのですが、
以下のような複数行について同じコメントをつけたい場合は
何かうまい記述法はありますか？

例：

/// 3D座標を示す値.
int nX;
int nY;
int nZ;

このままですと、nXだけにコメントがついてしまうため、
３つの変数全てに同じコメントを出すようにしたいのですが・・・

int nX;///< 3D座標を示す値x.
int nY;///< 3D座標を示す値y.
int nZ;///< 3D座標を示す値z.

これだと冗長な感じでちょっと抵抗があります
2009/06/05(金) 02:50:49
っ　nameタグ
2009/06/05(金) 09:01:35
>>229
普通は、一つのコメントで括られるような変数は構造体に入れるもんじゃね?
2009/06/05(金) 19:33:13
>>231
おお、良いこと言った！
2009/06/05(金) 22:02:00
>>231
座標とかだと、配列の方が扱いやすいかも
構造体の方が見やすいけどね
2009/06/06(土) 08:55:20
C++ code - 50 lines - codepad
ttp://codepad.org/imFgWQsK
これからdoxygenでhtmlドキュメントを生成させると、
メンバ一覧のページの上にある目次の部分は
すべてのメンバ一覧
Public メソッド
void foo (bool)
void foo (short)
void foo (int)
void foo (long)
void foo (double)
void bar (bool)
void bar (short)
void bar (int)
void bar (long)
void bar (double)
となります。このように並ぶと微妙に見づらいので
すべてのメンバ一覧
Public メソッド
foo系のメンバは
　void foo (bool)
　void foo (short)
　void foo (int)
　void foo (long)
　void foo (double)
bar系のメンバは
　void bar (bool)
　void bar (short)
　void bar (int)
　void bar (long)
　void bar (double)
の様にコメントをこの場所に入れたいしたいのですが、可能でしょうか？
2009/06/06(土) 09:13:44
>>234
マニュアルの「Grouping」(日本語版マニュアルだと「グループ化」)のページを見てください
2009/06/06(土) 09:55:14
>>235
それで出来るのですね。
ありがとうございます。見てきます。
2009/06/06(土) 11:53:22
doxygenで作ったthtmlドキュメントの
若干ながらフォントサイズが小さすぎると感じます。

このフォントサイズを大きくすることはできますか？
238234
垢版 |
2009/06/06(土) 20:44:39
C++ code - 17 lines - codepad
ttp://codepad.org/vf7DFqYq
とりあえずこの様にしてみました。
/** document former */
がメンバ関数全部について、
/** document latter */
がメンバ関数void func_1_InGroup1()だけにつくかと期待したのですが、
結果は
void Test::func_1_InGroup1に
document former document latter
と付いただけでした。
どこが誤っているでしょうか？
よろしくお願いいたします。
239234・238
垢版 |
2009/06/06(土) 20:56:51
C++ code - 26 lines - codepad
ttp://codepad.org/wOT4IAlv
とりあえずこれで行けそうです。
・・・法則性がわからない。
2009/06/06(土) 22:29:27
法則性はその>>238と>>239の違いの@nameの有無の部分ですよ。

マニュアルより：

ブロックの開標識の前に、独立したコメント・ブロックを置くこともできます。
このブロックは、@name (または、\name) コマンドを含む必要があり、
グループのヘッダーを指定します。
そうしたければ、グループに関するより詳しい情報をコメント・ブロックに
含めることもできます。
241239
垢版 |
2009/06/06(土) 22:36:14
>>240
doxygen用語の理解が今ひとつ足りなかったようです。
親切にありがとうございました。
2009/06/07(日) 12:54:49
Use built-in class diagram generator
だと継承に関するクラス階層図がうまく表示されますが、
Use dot tool from the GraphViz package
だとうまく表示されません。

このようなHTMLになってしまいます。
ttp://loda.jp/uploader_nrnrnr/?id=4
（これには再現する簡単なソースとDoxyfile、出来上がったHTMLが含まれています。）

環境はWindows XP SP2で、
doxygenはdoxygen-1.5.9-setup.exeを使ってインストールしました。
GraphVizはgraphviz-2.22.2.msiを使ってインストールしました。

GraphVizの問題だとしたら若干スレ違いかもしれませんが、
よろしくお願いいたします。
243242
垢版 |
2009/06/07(日) 13:43:31
C++ code - 25 lines - codepad
サンプルソースが腐ってたので
ttp://codepad.org/AwsZMCHk
これでお願いします。
2009/06/07(日) 23:01:58
>>242-243
DOT_FONTSIZEが小さい(デフォルト値は10)のが気になりますが、
正直なところデフォルト設定と余りに違いすぎて、それだけなのかどうかは何とも。

もしこだわって作りこんだ設定でないのなら、一度デフォルト設定に戻して、
最低限必要なところだけ変えるようにしてみてはどうでしょう？

デフォルト設定にはメニューから[Settings]→[Reset to factory defaults]で戻せます。
2009/06/08(月) 00:35:20
>>242
どこを問題視したいのか判らんが、HAVE_DOTがNOだからクラス階層図が出ないのは当たり前なんだが。
つーか、>>244も含めて
Doxyfile位真面目に読んでくれ。
246242
垢版 |
2009/06/08(月) 06:55:17
>>244-245
ありがとうございます。
教えを頼りに読んできます。
247244
垢版 |
2009/06/08(月) 08:39:21
>>242, >>245
>>242のドキュメントではdotファイルが吐かれてるし、
クラス階層図はdotファイルの内容どおりに生成されてます。
文字が読めないのはフォントサイズが4のためです。
コラボレーション図はdotにノードがなぜか出力されてませんが、
画像ファイル自体は真っ白なのが存在していて、
dotファイルの内容どおりには生成されているといえます。

なので、これらはHAVE_DOT=YESの状態で生成されたはずです。
DoxyfileはHAVE_DOT=YESにする前に保存したものと思われます。
dotの中身が異常なので、ほかに問題があると思います。
2009/06/08(月) 15:59:54
Doxygenて
__declspec(dllexport) int WINAPI MyFunc(int arg);
とか、それを簡略化して
#define API(type) __declspec(dllexport) type WINAPI
とした場合に
API(int) MyFunc(int arg);
みたいな宣言もちゃんと処理してくれる？
249242
垢版 |
2009/06/08(月) 16:17:43
>>247
ありがとうございます。
全然こだわって作りこんだ設定ではありませんので、
デフォルトに戻すことに抵抗はありません。

いろいろ教えの通り試してみます！
250デフォルトの名無しさん
垢版 |
2009/06/08(月) 22:09:14
http://appleloader.bbsnow.net/pic_loader/nomal/html/1_11.html
Exportタブに何も表示されないのですがバグですか・・・？

ノートPCでは表示されました

両方　WinXP 32bit　ＳＰ３　です
2009/06/08(月) 22:48:53
>>248
__declspec()は関数と誤認識されるので、
PREDEFINED で __declspec(x)= を定義するなどして、
プリプロセス時に取り除いてやる必要があります。
(マニュアルの「Preprocessing」に書かれてます)
2009/06/08(月) 23:24:43
>>250
eeepc + winxp でやってるけど、ウチも全く同じ現象になるよ。
253250
垢版 |
2009/06/09(火) 19:08:32
レスありがとう。

じゃあエクスポートタブの設定はできないのですかね・・・？

日本語マニュアルを作成したいので以下の設定をしたいのですが

設定する箇所は2箇所です。まずProject内にある「OUTPUT_LANGUAGE」をJapaneseにします。これで日本語マニュアルが作成されます。ただ、このままだと文字化けが起こります。

　続いて、Inputの中にあるINPUT_ENCODINGに「CP932」と文字を打ちます。CP932というのはMicrosoftなどが拡張したShift-JIS文字コードです。Visual Studioなどのソースコードはこの文字コードを指定するとDoxygenでうまく読み込んでくれます。

改善方法分かる人いたらアドバイスください　よろしくお願いします
2009/06/09(火) 19:38:26
>>253
設定内容を保存したファイルはテキストなので、直接編集できますよ。
255250
垢版 |
2009/06/09(火) 19:54:02
>>254
お！
ありがとうございます
2009/06/09(火) 21:16:16
>>255
念のため。
PROJECT_NAME 等に日本語を使ってる場合、UTF-8で保存されてるので気を付けて。
2009/06/11(木) 21:35:53
doxygen20090611.zip - uploader_nrnrnr
ttp://loda.jp/uploader_nrnrnr/?id=5
このaaaaaa.hとDoxyfileからdoxygenでhtmlドキュメントを生成させると、
　aaaaaa.h
　ソースコードを見る。
　マクロ定義
　#define ABS(x)
　#define MAX(x, y)
　#define MIN(x, y)
　#define MYMACRO "表示されたくない。"
このように表示されるのですが、私は最後の
　#define MYMACRO "表示されたくない。"
を
　#define MYMACRO
の様にしたいと思っております。
また、各マクロの説明文にある
　値:〜〜
というのも非表示にしたいと思います。

どうすればよろしいでしょうか？
2009/06/11(木) 22:23:30
関数テンプレートなどの
テンプレート引数を出力する項目は作れませんか？
2009/06/12(金) 01:24:59
>>257
MAX_INITIALIZER_LINES を 0 にするのはどうでしょう？
変数の初期値なども全部表示されなくなりますが。
2009/06/12(金) 01:58:14
>>258
@tparamで出来るらしいです。
261258
垢版 |
2009/06/12(金) 08:02:39
>>260
ありがとうございます。
助かります。
262257
垢版 |
2009/06/12(金) 19:21:47
>>259
MAX_INITIALIZER_LINESを0にする方法でいけそうです。
ありがとうございます。
2009/06/12(金) 19:54:28
doxygenの公式サイト（英語版）
が見たいのだが、リンクが死んでいる気がする。

それとも単に落ちただけだろうか？
■ このスレッドは過去ログ倉庫に格納されています
5ちゃんねるの広告が気に入らない場合は、こちらをクリックしてください。
ニューススポーツなんでも実況