喫茶XRAYトップページ

[7837] ドキュメント返信　削除
2014/8/26 (火) 10:37:36 snail
みなさんプログラムのドキュメントは作成していますか。


簡単に作成でき、できれば後から再利用できるようなツール
があったらいいんですが。皆さんはどんなツールを利用していますか。


私は今は主に EXCEL で作っています。以前は HCP チャートを
利用していましたが、作成するのに結構な時間が掛かるので
だんだん利用しなくなって、コピーが簡単な EXCEL でそれらしく
作っていたけど最近はそれすら面倒になってきてしまいました。 :-)



[7839] Re:ドキュメント返信　削除
2014/8/26 (火) 15:35:37 snail
▼ snailさん

Delphi用ドキュメント生成ツールをインターネットで検索すると
　DelphiCodeToDoc
　Pascal Analyzer
　!Doc
　EPTREE for Delphi
など、いくつか見つかりましたが UNICODE 対応版はありませんでした。
(試したソフトは全て途中でエラーが表示されて、ドキュメントは
生成されませんでした。)



[7844] Re2:ドキュメント返信　削除
2014/8/26 (火) 20:04:37 Mr.XRAY
▼ snailさん
 
> Delphi用ドキュメント生成ツールをインターネットで検索すると
> 　DelphiCodeToDoc
> 　Pascal Analyzer
> 　!Doc
> 　EPTREE for Delphi
> など、いくつか見つかりましたが UNICODE 対応版はありませんでした。
> (試したソフトは全て途中でエラーが表示されて、ドキュメントは
> 生成されませんでした。)

UNICODE 版への対応がされていないのですね．
Google で「ドキュメント 作成 Delphi」で検索したら，
こんなのがトップにヒットしましたが，どうなんでょう ?

[プロジェクト ドキュメントを生成する]
http://docwiki.embarcadero.com/RADStudio/XE4/ja/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88_%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%82%92%E7%94%9F%E6%88%90%E3%81%99%E3%82%8B

[表示] -> [モデルビュー] から設定できるようです．

[7847] Re3:ドキュメント返信　削除
2014/8/27 (水) 08:26:24 snail
▼ Mr.XRAYさん
> [プロジェクト ドキュメントを生成する]
> http://docwiki.embarcadero.com/RADStudio/XE4/ja/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88_%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%82%92%E7%94%9F%E6%88%90%E3%81%99%E3%82%8B
>
> [表示] -> [モデルビュー] から設定できるようです．

これはお高いバージョンで利用できるツールじゃないでしょうか。

[7852] Re4:ドキュメント返信　削除
2014/8/29 (金) 13:39:10 Mr.XRAY
> これはお高いバージョンで利用できるツールじゃないでしょうか。

ありゃ，失礼しました．
そうか，Starter 版にはないんですね (^^;

[7845] Re2:ドキュメント返信　削除
2014/8/26 (火) 21:31:22 igy
▼ snailさん
 
> Delphi用ドキュメント生成ツールをインターネットで検索すると
> 　DelphiCodeToDoc
> 　Pascal Analyzer
> 　!Doc
> 　EPTREE for Delphi
> など、いくつか見つかりましたが UNICODE 対応版はありませんでした。
> (試したソフトは全て途中でエラーが表示されて、ドキュメントは
> 生成されませんでした。)

使ったことないですが、
Doc-O-Matic
というのも、あるようです。

[7848] Re3:ドキュメント返信　削除
2014/8/27 (水) 15:33:50 snail
▼ igyさん
>
> 使ったことないですが、
> Doc-O-Matic
> というのも、あるようです。

今確認しましたがこいつは有料ですね。しかもプロ版は $999、高い
Express版 $49 もありましたが、違いがよくわかりません。
29日間お試しコースで動作させていますが、今まで試した物と違って
エラーは吐きませんでした。
ここでソースコードがシフトＪＩＳで有ることが発覚。(>_<)

[7869] Re4:ドキュメント返信　削除
2014/9/2 (火) 14:44:33 snail
▼ snailさん
> ▼ igyさん

> > Doc-O-Matic
> > というのも、あるようです。

試してみましたが、私が希望するものと違っているようでした。
詳しく使っていないので勘違いしているかもしれませんが
単純に　変数、メソッドなどの一覧と実際に呼び出している
ライン数が表示されるだけ。だと思います。



[7874] Re2:ドキュメント返信　削除
2014/9/3 (水) 19:12:31 SO
▼ snailさん
> ▼ snailさん
>
> Delphi用ドキュメント生成ツールをインターネットで検索すると
> 　DelphiCodeToDoc
> 　Pascal Analyzer
> 　!Doc
> 　EPTREE for Delphi
> など、いくつか見つかりましたが UNICODE 対応版はありませんでした。
> (試したソフトは全て途中でエラーが表示されて、ドキュメントは
> 生成されませんでした。)
>
>

Doxygen(http://www.doxygen.jp/)を使用していました。
けど、Delphiには未対応ということで、
間接的に以下のプロジェクトがあるようです。

Pas2Dox
http://pas2dox.sourceforge.net/
[7882] Re3:ドキュメント返信　削除
2014/9/4 (木) 21:15:02 snail
▼ SOさん

> Pas2Dox
> http://pas2dox.sourceforge.net/
こいつだけ落としても駄目なんですね。
Doxygen なんかすごそうだけど今回はパスします。

ありがとうございました。
[7841] Re:ドキュメント返信　削除
2014/8/26 (火) 19:44:01 Mr.XRAY
▼ snailさん

> みなさんプログラムのドキュメントは作成していますか。

していません．キッパリ (^^;

[7843] Re:ドキュメント返信　削除
2014/8/26 (火) 19:54:00 Mr.XRAY
▼ snailさん

> 私は今は主に EXCEL で作っています。以前は HCP チャートを

昔，Nifty の FDELPHI かなんかで，EXCEL で，
ドキュメント作成ツールを作っていた方がいたような記憶があります．
もしかして，snail さん ?

[7846] Re2:ドキュメント返信　削除
2014/8/27 (水) 08:22:55 snail
▼ Mr.XRAYさん

> ドキュメント作成ツールを作っていた方がいたような記憶があります．
> もしかして，snail さん ?

違います、そんなたいそうなもの作れません。(--;)

DelphiCodeToDoc

http://dephicodetodoc.sourceforge.net/

で確認すると 0.23b がダウンロードできる最新バージョンですが、

http://sourceforge.net/p/dephicodetodoc/code/ci/default/tree/

を見ると XE6 の文字もあるので何か修正をされているようですが
利用方法がよくわかりません。


もう少し地道に見てみます。

[7870] Re3:ドキュメント返信　削除
2014/9/2 (火) 14:55:20 snail
結局

http://www.dynamicdraw.com/jp/

から DD Thought Tickler をダウンロードして利用することにしました。
実はこのプログラム、以前に少しの間利用していましたが、作成した
ファイルをまとめる機能が無いと思って利用していませんでした。
改めてチュートリアルを読み直すと利用できそうなので
当面利用してみます。

テンプレートライブラリ からHCPやPADのテンプレートも落とせます。
標準でＪＩＳフローも利用できます。

[7875] Re4:ドキュメント返信　削除
2014/9/3 (水) 19:50:47 Mr.XRAY
▼ snailさん

> http://www.dynamicdraw.com/jp/

これいいですね．
こんなのがあるんですね．知りませんでした．

[DD Thought Tickler について]
http://www.dynamicdraw.com/jp/hr/index.html

[Dynamic Draw Professional
操作を記録してくれる履歴機能が付いた高機能ドローソフト]
http://www.vector.co.jp/magazine/softnews/060511/n0605111.html

[7881] Re5:ドキュメント返信　削除
2014/9/4 (木) 19:46:48 snail
▼ Mr.XRAYさん
>
> これいいですね．
> こんなのがあるんですね．知りませんでした．

実は昔から知っていました。
HCPチャートが気に入っているんですが
まともに使えるのはＤＥＮＳＯの１０万円のソフトしか無くて
諦めかけていたら見つけることができました。
その後ドキュメントを書かなくなってしまいました。
最近ソースが読めなくなってドキュメントの大切さを再認識
しています。　(>_<)

たしか

> [Dynamic Draw Professional
　　↓
> [DD Thought Tickler について]

途中で名前が変わったんじゃなかったかな。
それと同時にソースも公開されています。


Dynamic Draw は単体でチャート図を作成します。
DD Thought Ticklerは複数ファイルを履歴付きで管理できます。


INCM/CMT
Cyclamen v3.82