Thread Rating:
  • 404 Vote(s) - 2.88 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Curlのコメントについて
08-18-2011, 11:06 AM,
#1
Curlのコメントについて
Curlのソース(クラス)にJavaDocのようなコメントをつけたいと思ってますが
みなさんはどのように付与しているのでしょうか?
JavaDocちっくに
|##
#
#|
のような感じでつけているのでしょうか?
また、CurlではJavaDocのようなものは生成できないのでしょうか?
08-18-2011, 03:37 PM,
#2
RE: Curlのコメントについて
Curlでもjavadocみたいなことが可能です。ただし、javadocとは違いコメントではなく、ドキュメント用のマクロ(doc-nextなど)が用意されています。


Code:
{doc-next
    {purpose 概要を記述します。}
    {parameter v, 引数の説明をします。}
    {details 詳細な説明を記述します。}
    {notes 注意事項を記述します。}
}
{define-proc public {hello v:int}:void
   || ....
}


この記述した内容をもとに、IDEからデプロイするときに、ドキュメントファイルを生成することができます。

また、そのドキュメントはCurl IDE ドキュメント上で見ることができたり、Eclipse上のツールチップとしても表示されるようになります。


Curl のヘルプに詳細は載っていますので、ご参照ください。
 「Curl開発者ガイド」→「コンテンツの構成要素」→「アプリケーションの記述」

08-18-2011, 04:52 PM,
#3
RE: Curlのコメントについて
Curlブラケットでの記述はオブジェクトソースと混同しそうなのですが

eclipse上で見たときには記述内容が色分けされているのでまぁよいかなと。

JavaDocに慣れてしまっているとかなり違和感がありますが、これは慣れるしかないのでしょうね:-)

どうもありがとうございました。
08-18-2011, 05:01 PM,
#4
RE: Curlのコメントについて

業務アプリケーション開発の現場で、共通部品ではなく、javadocのようなドキュメントを必要としない場合は、
以下のようにコメントで記述するケースは多いかもしれません。



Code:
|| -------------------------------------------------
|| .....
|| .....
|| -------------------------------------------------

or

||| -------------------------------------------------
||| .....
||| .....
||| -------------------------------------------------


参考まで。

Forum Jump:


Users browsing this thread:
1 Guest(s)

MyBB SQL Error

MyBB has experienced an internal SQL error and cannot continue.

SQL Error:
1017 - Can't find file: 'mybb_threadviews' (errno: 2)
Query:
INSERT INTO mybb_threadviews (tid) VALUES('215')