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

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

公式
http://www.doxygen.jp/
2010/12/16(木) 18:07:20
hosh
2011/01/04(火) 13:01:20
明けましておめでとうございます。
hosho
2011/01/05(水) 08:16:00
1.7.3 が出ました
2011/01/08(土) 11:21:38
バグが2つ取れて新たに1つ入るんだよなこれって。
467デフォルトの名無しさん
垢版 |
2011/01/15(土) 20:33:03
C++で多重継承していた場合、一番最後に指定したクラスのオーバーライド関数しか「〜を実装しています。」が出ないな。
例えば、

class BasicActor : public Actor, public IEventListener
{

だとActorの方の仮想関数をオーバーライドしても「〜を実装しています」が表示されない。
ActorとIEventListenerの順番を入れ替えると逆の方のクラスの関数の「〜を実装しています」が表示されない。
早く治るといいなあ。
2011/01/20(木) 21:42:56
doxygen凄く便利そうだな！だけどRTF出力がうまくいかね…。
一応>>138のバイナリとdoxywizard(1.7.3)で試してるんだが、

OUTPUT_LANGUAGE=Japanese
INPUT_ENCODING=CP932

以外に何か設定って必要なのか？
もし良かったらだれかDoxyfileをうｐしてくれると凄く助かるわ…。
2011/01/21(金) 00:23:16
>>468
OUTPUT_LANGUAGE=Japanese-en
2011/01/21(金) 21:50:09
>>469
レスサンクス！
拾ってきたサンプルソースがCP932じゃなかったというどうしようもない原因でしたorz
スレ汚しスマソ
2011/04/05(火) 10:52:41.34
1.7.4 が出たようですが....
試してみた人います？
472デフォルトの名無しさん
垢版 |
2011/05/14(土) 11:06:54.20
1.7.4の日本語のｒｔｆ出力やっぱりおかしい。
以下、対処メモ。
>102,>134を参考にソース修正・コンパイルして日本語ｒｔｆ出力できたの確認。
doxygen-1.7.4/src/rtfgen.cppのencodeForOutputを修正
uint i;
uint mbFlag=0; // ←追加
for (i=0;i<enc.size();i++)
{
uchar c = (uchar)enc.at(i);
if (c>=0x80 || mbFlag==1) // ←修正
{
char esc[10];
sprintf(esc,"\\'%X",c);
mbFlag=1-mbFlag; // ←追加
t << esc;
}
else
{
t << (char)c;
}
}
473デフォルトの名無しさん
垢版 |
2011/06/09(木) 18:58:40.57
@だとドキュメント付けできて、\だとできないのは何故ですか？
2011/06/09(木) 23:04:27.97
>>473
言ってることがよく判らん。普通に@paramでも\paramでもできると思うが。
475デフォルトの名無しさん
垢版 |
2011/06/10(金) 09:31:34.72
>>474
ところが、\paramだとだめで、@paramだとできるんすよ。
何か切り替えるようなオプションがあるのだろうか？
2011/06/10(金) 14:41:51.21
そのダメなファイルと環境とリビジョンについて詳しく。
2011/06/16(木) 12:06:46.19
\\にすればおｋ
2011/06/16(木) 21:55:08.60
んな馬鹿な
2011/06/17(金) 15:09:51.06
馬鹿っていうほうが馬鹿
2011/08/26(金) 14:21:37.30
復帰
481デフォルトの名無しさん
垢版 |
2011/09/15(木) 21:14:39.34
#define HOGE 123
msg.h の 20 行で定義されています
みたいな行番号表示をオフにするにはどうしたらいいの？
2011/10/27(木) 08:42:23.16
1.7.5.1 は日本語 rtf 出力の文字化けが直ったみたいだ。
2012/02/16(木) 01:44:46.69
C++で、ソースを弄りたくない他所のライブラリの基底クラスのpublicなメソッドのリファレンスを
自作の派生クラス側のソースで書く事ってできないもんでしょうか。
2012/02/17(金) 00:52:56.77
>>483
宣言や定義の直前にしかその関数etcの説明を書けないと思っているなら一度doxygenの使い方をちゃんと勉強すると良い。
doxygenのタグのリファレンスを眺めるだけでも全然違うと思う。
485483
垢版 |
2012/02/21(火) 23:05:35.96
@fn を書いているのに出力されないと思ったら、うっかり他のネームスペース内に書いていた為でした。
お騒がせしました。
486デフォルトの名無しさん
垢版 |
2012/02/26(日) 01:02:49.50
Doxygen 1.8.0 age
2012/02/26(日) 01:16:48.60
x64バイナリも出たんだな
2012/03/01(木) 14:57:23.15
こういう、箇条書きをインデントさせると
　　/*!
　　　　　　- 列挙したい場合はこのように先頭に -をつける
　　　　　　　　- 更にインデントをつけたいときはこうする
　　　　　　　　　　- 更にインデントをつけたいときはこうする
　　*/

　・列挙したい場合はこのように先頭に -をつける
　　　・更にインデントをつけたいときはこうする
　　　　　・更にインデントをつけたいときはこうする

こうやってくれるんだけど


これを、このように、
ソースにそった形でインデントさせたいんだけど

　　//! - 列挙したい場合はこのように先頭に -をつける
　　if (a == 1) {
　　　　//! 　　- 更にインデントをつけたいときはこうする
　　}

これを普通にやると
　・列挙したい場合はこのように先頭に -をつける
　・更にインデントをつけたいときはこうする
こうなっちゃうんだよね

「単独行で、強制的に２つ以上のインデント」させる、いい方法ないかねぇ

というか、そもそも
doxygenは、こういうコメントを書くべきじゃないのかな？
2012/03/05(月) 04:23:13.19
やはりテンプレート関連でおかしくなるなあ
490デフォルトの名無しさん
垢版 |
2012/05/21(月) 11:48:57.46
Doxygen 1.8.1 age
2012/06/13(水) 13:00:33.35
http://www.doxygen.jp/manual.html にあるマニュアル、
一括ダウンロードできるようになってないのかな。
Webに繋がっていないときにこそ見たいときが多くて、歯噛みすることが多いんだけど。
# 取り敢えず、コマンドのページだけはダウンロードしておいたけど実例見られない……
2012/06/14(木) 15:19:16.46
「階層まるごとダウンロードツール」使えばええんちゃうのん
2012/07/17(火) 13:19:18.40
C#で表示されるクラス名が全部
＜パッケージ名＞.＜クラス名＞
になってすごく見づらいんですが、これをクラス名だけにする方法を教えてください
何というオプションなのかそもそも名前がわかりません
2012/07/17(火) 13:26:33.37
HIDE_SCOPE_NAMESでいけた。お騒がせしました
495デフォルトの名無しさん
垢版 |
2012/07/24(火) 20:50:05.56
クラスの階層じゃなくて、依存関係をグラヒカルに見たいんだけど
なにを設定すればいいんだっけか
2012/07/25(水) 11:08:33.44
HAVE_DOT
後は適当に。
497デフォルトの名無しさん
垢版 |
2012/10/14(日) 16:05:32.12
気になるけどまだ使っていない。
便利なんだろうか？
2012/10/14(日) 18:43:04.08
使えば判る。是非使え。
499デフォルトの名無しさん
垢版 |
2012/11/17(土) 02:10:59.92
Doxygen 1.8.2 age
2012/12/01(土) 05:59:46.03
doxygenで制作されたライブラリのレファレンスがあるんだけど、オフラインで見たいからダウンロードしたいんだが、なにか方法はないだろうか。
なんかサーバー側の調子が悪いのか、見たい時に中々見れない時とかあって困ってるんだ。

なんかメインページがphpだからなのか、普通のダウンロードツールじゃうまくいかないんだ。
2012/12/01(土) 06:02:58.31
じっさいに見てみないことには何とも言えん
URIはよ
2012/12/01(土) 07:16:56.55
doxygenで出力されるのは通常htmlで、phpじゃないよ。
そうでなくても、このスレで聞くのはスレ…いや、鼬害。
2012/12/01(土) 19:32:43.73
\relatesは関数にしか機能しないということですが、同じようにC++のクラスを他のクラスに関連付ける手段はないでしょうか？

//何かのTraitsクラステンプレート
template < typename T > xxxx_traits;

/*! クラスA
*/
class A { ... };

/*! xxxx_traitsのクラスAに対する特殊化バージョン
　\relates A　← 例えばこんな風に
*/
template <>
struct xxxx_traits< A > {.... };

クラスAのドキュメントからxxxx_traits< A >へのリンクを張りたいのですが。
504503
垢版 |
2012/12/01(土) 19:51:28.94
書き忘れていました。
今は、クラスAのドキュメントから\saでリンクを張っています。
しかし、Related Functionsと同列にできないものか、と思ったのです。
後出しですいません。
505デフォルトの名無しさん
垢版 |
2012/12/02(日) 00:27:49.22
プログラム関係で詳しい奴っている？
506500
垢版 |
2012/12/05(水) 18:40:16.24
>>501 >>502
doxygenで構築されるのはhtmlなのか。
ソースコード向けホームページ作成ツールみたな認識でいいんかな。
ってことはdoxygenを仮にインストールしたとして、WEB上にあるdoxygenで出力したページはhtmlとかだからgitみたいにダウンロードするとかそういうのも無いんか

ちなみにURLはこれ
ttp://www.arongranberg.com/astar/docs/
2012/12/07(金) 01:22:50.83
>>506
使った事はないけどpdfへの出力もサポートしてるよ。

Output Formats
http://www.stack.nl/~dimitri/doxygen/output.html
2012/12/07(金) 11:28:30.72
TeXからps経由でpdfにするのは日本語の扱いで結局満足いく出力になったことがないんだよなぁ。
rtfからdoc経由でpdfにするのはMS-Office2010があれば日本語も大丈夫なようだけど。
2012/12/11(火) 13:15:43.39
>>506
wget --mirrorとか。
510デフォルトの名無しさん
垢版 |
2012/12/27(木) 01:20:09.22
Doxygen 1.8.3 age
2012/12/27(木) 13:15:24.02
New features 見てみた。External Indexing and Searching 面白そうだな。
ttp://www.stack.nl/~dimitri/doxygen/extsearch.html
512デフォルトの名無しさん
垢版 |
2013/01/17(木) 19:51:25.05
RTFで出力したときに
1.先頭ページが「TITLE AUTHOR Version 1.0.0 CREATEDATE」となり内容が出力されない。
2.３ページ目が「目次 Tavle of contents」となり出力されない
3.最終ページが「索引 INDEX」となり出力されない
4.デストラクタ「~」で始まる名称が文字化けする
version は1.8.2 です。
DOXYFILE_ENCODING = UTF-8
INPUT_ENCODING = SJIS
としています。個別でも構いません解決方法ご存知の方はおられませんか。
2013/01/18(金) 09:11:06.86
>>512
INPUT_ENCODING=CP932
の方がいいと思います。
後は、MS WORD で読み込んで全文選択した後フィールド更新
514デフォルトの名無しさん
垢版 |
2013/01/18(金) 09:23:11.01
>>513
早速やってみたら全てきれいに解決しました。
ありがとうございました。
2013/01/18(金) 18:25:25.37
＞2.３ページ目が「目次 Tavle of contents」となり出力されない
なんだこれ。
516デフォルトの名無しさん
垢版 |
2013/01/18(金) 18:28:31.06
>>515
「目次 Table of contents」のパンチミスでした。m(__)m
517デフォルトの名無しさん
垢版 |
2013/01/22(火) 23:35:14.46
Doxygen 1.8.3.1 age
2013/04/05(金) 22:53:14.91
Doxygen 1.8.3.1 使ってます
rtfの出力なのですが

VisualStudio 2010でC#で使おうと思ってます

DOXYFILE_ENCODING = CP932
INPUT_ENCODING = UTF-8

として、出力したところ
refman.rtf
は何となくそれっぽい出力をされているのですが
おまけで作られる大量のrtfファイルが、UTF-8のままなのか文字化けしちゃいます


refman.rtfファイルに対して、ワード２００７で
読み込んで全文選択した後フィールド更新
としても、おまけファイルが取り込まれた様子もないです(おまけファイルの図が取り込まれていない)

それと、目次が「TOCが間違っています」・・・
というエラーになってしまうページがあったりします

doxygenはあまりワード出力は向いてないのでしょうか
htmlは結構イメージしたものに近い出力だったのですが
2013/04/10(水) 15:03:15.14
>>518
ソースもcp932にしないと難しいかもね。
それと、word2010にしたら改善するかもしれない。
いずれにしても、日本語は相性悪いよ。
そうそう、JapaneseでダメならJapanese-enも試してみる価値あり。
2013/05/06(月) 14:48:10.14
1.8.3.1で、C言語でグローバル変数を使う時に、
(foo.h)
extern int a;
(foo.c)
int a;
って書くと出力にaが2個現れるのですが、仕様でしょうか
2013/05/06(月) 14:53:50.36
@addtogroupでcとhを同じグループに入れた時だけ>>520みたいな状態なので、とりあえずexternの部分だけグループから外します
2013/05/06(月) 15:13:09.82
externはグループから外さなきゃいけないか
まあそりゃそうだな
失礼しました
2013/05/10(金) 23:59:33.52
doxygenを意識していないソースコードに
doxygen用のコメントのテンプレートみたいなのを書き込む機能ってありませんか？
例えば

class Hoge
{
...
};
などとあったら
/**
* @brief brief of Hoge
*
* detail of Hoge
*/
class Hoge
{
...
}:
のようなコメントを挿入するような
2013/05/12(日) 07:16:01.98
>>523
つeclipse
2013/05/13(月) 17:14:58.88
>>523
んなもん、Doxygenにあるわけないだろ。
LL言語で作るかエディタのマクロで作るかすればいいだろうが、それはスレ違い。
あぁ、JavaDocスタイルを有効にしておけば、もそっと簡単になるな。
2013/05/13(月) 20:40:48.28
でもそれこそdoygenにパーサがあるわけだから、doxygen内蔵でそういう機能があったらいいなとお思うのは
自然で低コストだべ？
2013/05/14(火) 01:41:00.13
VisualStudio で C++ なら DoxyComment だろうけど。
2013/05/14(火) 05:45:06.00
ありがたい、求めていたものはそれです
2013/05/14(火) 12:51:38.41
>>527
これ便利そうやな
コマンドライン版ある？
2013/05/14(火) 20:11:22.93
>Express Editionでは使えません
チクショー！
531デフォルトの名無しさん
垢版 |
2013/10/28(月) 16:59:29.04
細かいのはヘッダファイルに書く派？ ソース本体に書く派？
2013/10/28(月) 18:54:07.23
本体と別々にdoxygenコメントを書くことはねーよ。doxygenのいいところが全く無駄になるだろ。
ヘッダファイルに書くのは前方宣言とマクロ定義くらいだから当然ソース本体にしかdoxygenコメントなんざ書かない。
533デフォルトの名無しさん
垢版 |
2013/10/31(木) 15:00:35.36
@parのなかでPREタグ使いたいんだけどうまくいかない
AAとか書くときってみんなどうしてるの？
2013/10/31(木) 15:27:12.80
AAとか書かない
2013/10/31(木) 20:46:05.36
>>534
きみの思いとか気持ちを聞いているわけじゃあないんだ。 わかるね？
2013/11/01(金) 16:50:18.73
>>535
なんのAA書きたいんだよ
2013/11/01(金) 17:41:02.50
>>536
┌─┬─┬─┬─┐
│あ│い│ │お│
└─┴─┴─┴─┘
こういうのとか
2013/11/01(金) 17:54:00.33
>>537
table使えば？
2013/11/01(金) 22:42:39.54
@htmlonlyじゃダメなのか？
2013/11/02(土) 17:17:04.47
>>531
俺はヘッダに書くね
実装する時はヘッダから見るし
2013/11/04(月) 13:47:21.10
>>532と>>540、よくどちらも聞くしどちらも一理あるんだけど
どっちがより一般的なのかな。 長いものに巻かれたい。
542デフォルトの名無しさん
垢版 |
2013/12/17(火) 11:52:10.96
調べても分からなかったので、質問です。
同じ引き数の関数をまとめたいですが、どうすればいいでしょうか？
以下のようにしたいです。(doxygen 1.8.5使用)

関数
-----
bool add_apple(int* out, int in);
bool add_orange(int* out, int in);
bool add_lemon(int* out, int in);
-----
果物を追加する

引き数
　[out] out 出力
　[in] in 入力

戻り値
　成功 true
　失敗 flase
2013/12/17(火) 15:33:50.57
\refで参照するようにするとか。
2013/12/17(火) 18:49:21.24
Doxygen使ってるプロジェクトのドキュメントとかを見てみたけど
複数の関数をまとめて表示してるのは全く見つからなかった…

\refはグループ化とかしないと行けないっぽいし若干敷居が高い…
とりあえずバラでドキュメント化しておくよ
どうもでした
2013/12/18(水) 16:18:20.67
>>542
ところで、それ言語なんなの？
2013/12/19(木) 00:12:07.15
最近はC言語もマイナーになったのかぁ....
2013/12/19(木) 10:13:56.97
>>545
C++だけど何か変か？
もちろんサンプル用にその場で書いただけなんだけど
2013/12/19(木) 12:58:14.64
>>547
少なくとも>>545のコードはへん
2013/12/19(木) 12:58:46.35
>>542だった
2013/12/19(木) 13:52:30.20
もうちょっと分かり易く書くと

bool add_apple(Fruits* fruits, int add_num); // 成功 true 失敗 false
bool add_orange(Fruits* fruits, int add_num);
bool add_lemon(Fruits* fruits, int add_num);

C++なのに第一引き数にオブジェクトの指定が必要だけど、
別に変ではないよ
2013/12/19(木) 14:29:38.26
いや変
2013/12/19(木) 15:26:51.69
変なのは分かったから、ちゃんと具体的に言えないの？
2013/12/19(木) 16:21:36.49
君に使う時間ないし
強烈に変だと思ったからそれだけ伝えたかっただけ
2013/12/19(木) 16:29:15.77
あ、でもFruitsの定義とbool add_apple()の定義を書くというなら、そのコードのどこがおかしいかは指摘できる
2013/12/19(木) 16:35:13.03
スレ違い
2013/12/19(木) 17:05:53.26
逃げたw
2013/12/19(木) 17:49:31.89
まあC++の天才と謳われた俺に書かせれば
bool add ( string fruits_type, Fruits* fruits, int_add_num )
かな。

かなりスマートな設計になっているのが分かると思う。
2013/12/19(木) 17:54:43.58
なるほど。
2013/12/19(木) 18:00:35.80
Fruits fruits;
fruits.add("apple", 10);
とかするのが普通な気もするが。
2013/12/19(木) 18:44:41.90
bool add_apple(Salud* salud, int add_num); // 成功 true 失敗 false
も定義しておけば、

Salud salud;
Fruits fruits; // Salud と継承関係はない

add_apple(salud, 10);
add_apple(fruits, 10);

と出来るメリットもあるので、一概にどれがいいとは言えない
状況による
2013/12/19(木) 18:55:55.95
>>546>>547>>550>>552>>557>>559

＞失敗 flase
これじゃね？
2013/12/19(木) 19:10:25.11
まさかそんなあからさまなtypoに対して
「ところで、それ言語なんなの？」なんてドヤ顔でレスするのは想像の範囲外だわ
■ このスレッドは過去ログ倉庫に格納されています
5ちゃんねるの広告が気に入らない場合は、こちらをクリックしてください。
ニューススポーツなんでも実況