04/02/18 20:18
Visioなら書けるが、VC・VBの方が楽。よってVisioでは無理。
128:デフォルトの名無しさん
04/02/18 21:45
>>127
wxWindowsのGUIツールキットBOAとかFOXとかFLTKあたりで作成できないもんかと思って、
とりあえず、暇できたらなんか色々チャレンジしてみます。
でも、.NET対応流行ったらどうすっぺ・・・。
129:デフォルトの名無しさん
04/02/18 22:36
FLTKは日本語まわりがアレ、wxWindowはちょっとDLLがデカイ
gtk+ 導入するのにものすごい壁がある。 Foxは知らん。
なんとなく実用的なものならwxWindowがいい、
でもどれでもポトペタは無理だと思う。
130:デフォルトの名無しさん
04/02/18 22:44
ポトペタってなに？
131:デフォルトの名無しさん
04/02/18 23:15
>>126
俺の会社の先輩はPowerPoint使ってデモしてました。
文字入力画面はできない(アニメーションでやってた)みたいだけど、
ボタンと画面表示はリンクで適当に作ってました。
全画面表示のアプリで、それっぽく見せてましたよ。
132:デフォルトの名無しさん
04/02/18 23:42
まぁVBが一番楽なんだろうね。
133:デフォルトの名無しさん
04/02/19 01:56
画面設計書じゃないから、それこそ"○○部分"と書いた枠の配置だけでいいと思う。
というか、そうでもして抽象化しないと完成画面だと思われる。
はっきりいえば、Windows の画面かどうかも分からないように書いたほうがいい。
134:デフォルトの名無しさん
04/02/19 06:20
もしもしTcl/Tkを忘れてますよ
135:124
04/02/19 09:35
>>129-134
みなさまどーもありとうございます。
>>129,132
ポトペタ（ポトッとおとしてペたって貼り付け？）は無理ですか。
ＶＢで適当につくるのがいいんですかね・・・。
でもおいらＶＢ苦手っす（なんかめんどいからかな？）。
超初心者用ページでいいページないですかね（スレ違い）。
C++ならそれなりにモウマンタイって感じなんですけど。
>>131
パワーポイントっすか。使ったことないですね。考慮してみます。
>>133
うーむ、画面設計書とかそこらへんの違いよくわからないです。
そういうのわかる書籍とかページありませんか？（スレ違い？）
とりあえず、今度は抽象化してだしてみますね。
>>134
あ、どもです。とあるページに載ってなかったもんでメジャーではないのかと思いまして。
（ここのＧＵＩスレには載ってますけど）
136:デフォルトの名無しさん
04/02/26 23:15
末端プログラマしかやったことないんですが、
ちょっとＰＭで設計書の類（まだはっきりしてないけど）を書く必要にせまられました。
で、役立つオススメな本あります？
137:デフォルトの名無しさん
04/02/27 22:42
まず、身の周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもないような代物なら…ガンガレ。
プログラム 設計書 で ぐぐると合うような物が見つかるかもよ。
138:デフォルトの名無しさん
04/02/27 22:47
周りに先輩達が書いた設計書(見本)がないか探してみる。
なかったり、どうしようもない代物だったら…ガンガレ。
プログラム 設計書 でぐぐる
要求定義からやる羽目になる罠もあるのでその辺もひっかけておく。
139:デフォルトの名無しさん
04/02/27 22:50
二重カキコ。逝って(ry
＿|￣|○
140:(゜Jし゜）
04/02/27 23:55
URLﾘﾝｸ(www.seshop.com)
このへんどうよ？
141:136
04/02/28 05:24
>>137-139
ありがとうございます。あさってみます。
>>140
ありがとうございます。アキバのラオックスで立ち読みして、よさそうならかってきます。
142:http://bulkfeeds.net/app/search2?q=UML
04/03/31 00:03
UML・仕様書・設計書関連2chスレッドのまとめ （siyousyo - wikich）
URLﾘﾝｸ(pwiki.chbox.com)
URLﾘﾝｸ(bulkfeeds.net)
143:デフォルトの名無しさん
04/05/11 00:16
doxygen 1.3.7 age
144:デフォルトの名無しさん
04/07/18 17:51
詳細設計書は、プログラム処理の羅列でいいんだよね？
145:デフォルトの名無しさん
04/07/20 02:43
>プログラム処理の羅列
ダメ、それはプログラム設計書だNe!
146:デフォルトの名無しさん
04/07/25 19:54
doxygen 1.3.8 age
147:デフォルトの名無しさん
04/09/11 00:13:39
142さんありがとうございます。助かりました。
激遅レスだけど、感謝です。
148:あげ
04/09/25 05:02:40
doxygenで複数の言語向けのドキュメントを書くにはどうすればよいのだろう？
149:デフォルトの名無しさん
04/09/25 05:06:02
URLﾘﾝｸ(www.npb.or.jp)
150:148
04/09/25 05:09:09
すまん。
doxygen+"two languages"でぐぐったらマニュアルの\ifディレクティブの項に書いてある事が分かった。
151:デフォルトの名無しさん
04/09/28 16:09:35
保守
152:デフォルトの名無しさん
04/10/06 23:25:55
運用マニュアルや仕様書だの、どこか公的な書き方の決まりはあるんでしょうか。
例えばメニュー名などはどういう括弧でくくるのか、単語末の長音はない
方がいいとか、会社とかによってルールとかはあるとは思うんですが…。
でもまちまちだとどこか新しい営業先に提案書持っていくときだの、いろんな
会社のマニュアルを保管する側とかとまどったりするんじゃないかと
思うのですが、みなさんは普通に自分の周辺ルールで書いてますか？
153:デフォルトの名無しさん
04/10/07 01:12:28
doxygen 1.3.9 age
154:デフォルトの名無しさん
04/10/07 01:18:23
>>152
今までマニュアルや仕様書を（良い悪いに関わらず）読んできた経験に基づいて決める。
どこでも見かけるルールには従う。
あ、このルールいいな、と思ったものは取り入れてみる。
このルールだめじゃん、と思ったものは自分ではそうならないように気をつける。
ま、毒にも薬にもならん意見だな。
「ドキュメント」「標準」とかをキーに検索すれば？
155:デフォルトの名無しさん
04/10/07 23:01:14
俺も結局わからないまま、ウケよかったからいいか…とか
先例でいい奴とかまねしてるが、業界として共通の表現とかって
どっかないんかな…
156:デフォルトの名無しさん
04/10/07 23:10:44
この調子ではどうせ読む奴もわからないからいいんじゃない
157:デフォルトの名無しさん
04/10/08 06:09:48
どうせ誰も読まないから適当でいいんじゃない
158:デフォルトの名無しさん
04/10/13 00:00:55
doxygne 1.3.9.1 age
159:デフォルトの名無しさん
04/10/13 01:09:00
doxygenやJavaDocは多言語対応まで視野に含めると、どうかなと思ったり。
160:デフォルトの名無しさん
04/10/13 01:58:22
>>159 詳しく
161:デフォルトの名無しさん
04/10/13 07:55:33
>>159
INPUT_FILTER使えば？
162:デフォルトの名無しさん
04/10/13 17:55:43
俺ぐらいのレベルだと
ソースがドキュメント
163:デフォルトの名無しさん
04/10/13 17:56:44
ドキュメントが嘘ついている場合もあるのだ。
164:デフォルトの名無しさん
04/10/13 21:45:34
>>162のソースは嘘をついている
165:デフォルトの名無しさん
04/10/13 21:49:15
ソースがドキュメントと言っている奴のソースは大抵糞。
俺のソースはきれいだと腐ったソースで自分に酔ってる厨と同じ。
166:デフォルトの名無しさん
04/10/13 22:08:47
腐ったソースで走り出す♪
（プロジェクトが）
167:デフォルトの名無しさん
04/10/13 22:33:25
warota
168:Ruby!!!!!!!!!!!!!!
04/10/13 22:35:09
まつもとゆきひろ尊師は「ソースがドキュメント。バグもそこに記述されている」と仰いました。
おまえらひれ伏せ。
169:デフォルトの名無しさん
04/10/14 00:53:52
#if 0
ドキュメントはソースだけで十分です。
#endif
170:デフォルトの名無しさん
04/10/14 11:46:15
×ドキュメントはソースだけで十分です。
○ドキュメントはソースだけしかありません。
171:162==163
04/10/15 12:47:21
>>164-166
いや、
おれが、ドキュメント書かないわけじゃないよ。
一応気を使ってdoxygen対応で書いてるぜ。
で、
わかりにくいドキュメント見るぐらいなら、ソース見るって感じ。
ドキュメント読んで信じて、騙されるぐらいなら
ソースを読んだ方が正確。時間もさほど変わらない。←これが俺ぐらいのレベル
ソースが汚い奴のドキュメントは、
やっぱりわかりにくい罠ってのもある。
一応、EffectiveC++レベル以上のその系統の書籍を数冊読んでるし、
汚いソース何個も見てきたので
ある程度の読みやすいソース書く自信あるぜ。
そういう本読んでない初心者ちゃんにはきついかも。
172:デフォルトの名無しさん
04/10/15 15:14:32
ソースだけだと仕様なのか脆弱性なのかバグなのか区別がつかん。
ソース自体が読みやすいとか読みにくいとは全く別問題だし。
自分のソースにはバグは一切無いとか、
仕様のためのコードなのか、高速化のためのコードなのか、単にダメっぽいコードなのか、
みたいのを誰が見ても一目瞭然で区別できるとかいうなら話は別だが。
173:デフォルトの名無しさん
04/10/17 07:34:17
サルベージ
174:デフォルトの名無しさん
04/10/31 22:59:23
ドキュメントがメンテされてなくて役に立たん、というのはよくある話だ。
175:デフォルトの名無しさん
04/10/31 23:06:43
ドキュメント更新まで含めてコーディングすればいい
176:デフォルトの名無しさん
04/11/03 15:51:12
ドキュメントは古参ＳＥの頭の中だけってプロジェクトもあるよねえ（溜息）
177:デフォルトの名無しさん
04/11/23 20:57:53
今日Doxygen使い始めた。教科書はCマガジンの2002/8とDoxygenヘルプ。
*.hにコメント書くよりも*.cppに書いたほうが良い、というのは理解した。
(そりゃそーだわな)
でも、DLLなどのバイナリライブラリでソース見せたくないときは、
*.hに書くしかないような気がする。
*.cppに書いてあったコメントが、あたかも*.hに書いてあったように
Doxygenできる方法ってあるの？
それともローテクにリリース寸前でコメントを*.hにコピペするんか？
178:デフォルトの名無しさん
04/11/23 21:01:35
おれ177
まだまだ使い始めだからわかってないのかもしれないが、
要は、ソースが丸見えになるのがいやなのだ。
ソースを隠すオプションが探し切れていないだけなのかもしれん。
179:デフォルトの名無しさん
04/11/23 23:23:10
>>177
Doxygenした結果はcppに書いてあろうがhに書いてあろうが同じだと思うが。
ソース隠すオプションはある。
180:デフォルトの名無しさん
04/11/24 15:01:58
というかデフォルトで隠されてたような。
WindowsならDoxyWizard使うと楽チン。
181:デフォルトの名無しさん
04/11/24 19:01:47
おれ177
すまんかった、いろいろ試してみたらソース隠せたよ。
DoxyWizardは知らんかった、ちょっとさわってみる。
182:デフォルトの名無しさん
05/01/03 15:58:41
doxygne 1.4.0 age
183:ライブラリアン
05/01/03 16:36:26
ドキュメントってプログラミングする前に
書くものじゃないの。仕様書とか検査成績書とか。
プロはドキュメントを書いている時点で情報不足や矛盾が
わかるのでしょう。
プログラムを作ってからドキュメントを作るのは
最低だな。ゲーム少年の域をこえてないよ。
184:デフォルトの名無しさん
05/01/03 18:44:34
cppdocもソースやヘッダーの内容を文書化するのに使える
185:デフォルトの名無しさん
05/01/03 19:00:47
>>183 うるせーばか
186:デフォルトの名無しさん
05/01/03 21:42:33
>>183は真のゲーム少年
187:デフォルトの名無しさん
05/01/03 22:07:53
まず「ゲーム少年」というのが何だかよくわからないな
188:デフォルトの名無しさん
05/01/03 23:36:12
>>183
おいらのとこでは、プログラマが書くのは保守ドキュメントのほうが多い。
そうするとあとで書いたほうがいい。
同時にかくのはもっといい。
仕様書、成績書は別の人間が書く。
同じ人間がかくってことは零細？
189:デフォルトの名無しさん
05/01/03 23:38:38
零細の何が悪い
190:デフォルトの名無しさん
05/01/04 00:00:46
誰が書く、ということではなく
書く順番の話をしているのでは
ということは188は読解力ゼロ？
191:デフォルトの名無しさん
05/01/04 01:47:32
属人性MAX
192:188
05/01/04 23:28:28
>>190
プログラマの文書は保守文書が多かろうから
あとか同時に書くほうがいいし、あとが駄目とは
言い切れないんじゃないのということが言いたかった
ですよ。
んで、矛盾を見つかる仕様書は別の人が
書くだろうからそれで、非プロとはいかがなものかと。
>>189
悪くないけど大変ですね。
193:デフォルトの名無しさん
05/02/08 23:36:23
doxygenのLaTeX出力は鬼門だな
URLﾘﾝｸ(www.atmarkit.co.jp)
この辺のでｻﾝﾌﾟﾙは上手く逝ったが、漏れのソースだとｲﾋけ杉
194:デフォルトの名無しさん
05/02/09 15:13:57
要件定義書でのデータモデルって、良いお手本ありますかね？
概念モデルで。
195:デフォルトの名無しさん
05/04/09 19:20:51
doxygen 1.4.2 age
196:デフォルトの名無しさん
05/05/08 01:04:55
doxygenで、ローカル変数のコメントを出力するにはどうすりゃいいんすか？
int main(void){
char s[BUFSIZE]; //!汎用バッファ
↑こんなやつ。
197:デフォルトの名無しさん
05/05/08 01:11:53
>>196
ローカル変数を廃止して、全部グローバルにすればOK？
198:デフォルトの名無しさん
05/05/08 01:14:38
URLﾘﾝｸ(FLH1Ach124.kng.mesh.ad.jp)
ｗｗｗｗｗｗｗｗｗｗｗｗおｋｗｗｗうはっｗｗｗ
うぇｗｗｗ
おｋｗｗｗっっおｋｗｗｗｗｗｗｗｗｗｗ
ｗｗｗうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
199:デフォルトの名無しさん
05/05/08 01:28:10
URLﾘﾝｸ(YahooBB219215164084.bbtec.net)
おｋｗｗｗっっおｋｗｗｗっうぇうぇｗｗｗ
うはっｗｗｗ
っｗｗｗｗｗｗｗｗｗｗｗｗ
っうぇｗｗｗｗｗｗ
うはっｗｗｗっうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
200:デフォルトの名無しさん
05/05/08 23:37:07
>>196
そんなもの出力する必要あるの？
201:デフォルトの名無しさん
05/05/08 23:48:31
>>200
変数のドキュメントは必要でしょー
202:デフォルトの名無しさん
05/05/08 23:50:12
えーだってローカル変数だよ？
doxygenって、関数やクラスのインタフェースを記述するためのものじゃないの？
203:デフォルトの名無しさん
05/05/09 11:15:06
>>202
きめつけ：(･Ａ･)ｲｸﾅｲ
204:デフォルトの名無しさん
05/05/09 11:27:33
>>203
ローカル変数ってのは隠蔽されるべきものなので、
皆が読むドキュメントには書くべきではないと思われ。
実装者とか保守する人用に注意書き程度にコメント書くなら構わんと思うけど。
205:デフォルトの名無しさん
05/05/09 11:54:51
意味不明文書が大量生産されるのは
じつわ
ぜんぶmadeinusa
なので
それを
にほんごにするときに∞∴♂♀℃￥＄￠￡％＃＆＊＠§☆
206:デフォルトの名無しさん
05/05/09 12:07:04
URLﾘﾝｸ(ntchba046149.chba.nt.ftth.ppp.infoweb.ne.jp)
おｋｗｗｗうはっｗｗｗｗｗｗおｋｗｗｗ
ｗｗｗｗｗｗｗｗｗｗｗｗ
っうぇ
ｗｗｗｗｗｗｗｗｗｗｗｗ
うはっｗｗｗおｋｗｗｗｗｗｗｗｗｗｗｗｗｗっうぇ
207:デフォルトの名無しさん
05/05/10 00:19:54
>>204
保守用ドキュメントを作成し
208:デフォルトの名無しさん
05/05/10 02:08:45
>>207
普通は意味無いので
209:デフォルトの名無しさん
05/05/10 02:30:03
URLﾘﾝｸ(pl070.nas931.nara.nttpc.ne.jp)
ｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗｗｗ
ｗｗｗっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
おｋｗｗｗ
うはっｗｗｗｗｗｗうぇｗｗｗ
ｗｗｗｗｗｗｗｗｗｗｗｗ
210:デフォルトの名無しさん
05/05/10 03:33:47
URLﾘﾝｸ(218.33.211.112.eo.eaccess.ne.jp)
おｋｗｗｗうぇｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗうはっｗｗｗ
うぇｗｗｗｗｗうはっｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ
ｗｗｗｗｗｗｗｗｗｗうはっｗｗｗｗｗｗうぇｗｗｗ
211:デフォルトの名無しさん
05/05/11 08:37:36
↑あげると、こうなるので、上げないように。
212:デフォルトの名無しさん
05/05/11 20:58:44
だが断る
213:デフォルトの名無しさん
05/05/12 09:26:54
だがそれがいい
214:デフォルトの名無しさん
05/05/12 22:50:48
だが断る
215:デフォルトの名無しさん
05/05/13 09:19:26
だがそれがいい
216:デフォルトの名無しさん
05/05/13 18:14:50
俺たちの青春かよ！
217:デフォルトの名無しさん
05/05/15 00:34:54
おまいら、API仕様書とか書くときMS-WORDか？
ソースのひな形つくってdoxygenか？
なんか綺麗な方法ないか探し中の俺に教れろ。
218:デフォルトの名無しさん
05/05/15 01:00:18
>>217 doxygen 使っとけ。
219:デフォルトの名無しさん
05/05/17 01:13:37
doxygen 1.4.3 age
220:デフォルトの名無しさん
05/06/07 00:18:40
doxygen 使っとけ
221:デフォルトの名無しさん
05/06/12 01:55:49
DocBookとかDITAとか使ってる香具師いる？
222:デフォルトの名無しさん
05/06/12 12:15:26
いたらどうなんだよｗ
つーか、いねーよそんな奴(ﾌﾟｹﾞﾜﾛｳｽ
223:デフォルトの名無しさん
05/06/12 14:45:09
WORDで作るWebページって仕様になるのですかな？
目的はdoxygenにリンクさせて、一括管理しようと思ってます。（名づけて一元化）
WORDで作るとhtmlじゃなくhtmってなって、WORDで開いて.docにも変換可能です
質問はhtmって一般常識として普及しているのかどうかです
みなさんは、仕様を書くソフト（拡張子）は何を使ってますか？
224:デフォルトの名無しさん
05/06/12 14:51:50
>>223
テキストで管理して変換変換
.txt→.htm→.pdf と
225:デフォルトの名無しさん
05/06/12 15:10:03
>224
なるほど、テキスト最強ですな。
でもページ上でリンクしたいから、テキスト厳しいかも。
変な表とか入れずに、互換性上げるのには気をつけてます。
226:デフォルトの名無しさん
05/06/12 15:29:56
>>223
htmlをWORDで作るってのが個人的には好きではないが。
htmlは電子文書としては最強の一つだと思ってるよ。PDFよかぜんぜん好き。
仕様書は紙で出してナンボと思ってる古い業界体質も残ってるから
ウケはあまりよくないかも知れないけどね。
227:デフォルトの名無しさん
05/06/12 18:54:41
cssにしろXSLにしろ、理念は良いのだけど
どうせならもっと徹底して、テキストを完全に分離して欲しかったなぁ
テキスト側はもう生txtそのままでさ、
スタイルシート側は、面倒でも行で指定する感じ
実際は簡単なツールで補えば、行指定やテキスト変更も、手間でも無いだろうし
228:デフォルトの名無しさん
05/06/12 19:41:15
>>227
行指定は面倒すぎだろ
あと、その概念はWord文書みたいだ
229:デフォルトの名無しさん
05/06/12 20:26:40
>>227
確かに両方用意しないと行けない場合に便利だな。
頭の固いおっさん向けに、紙に印刷する必要がある時とか。
230:デフォルトの名無しさん
05/06/12 23:17:56
>>229 頭の柔軟な若者にも紙に印刷する必要があるだろ？
231:デフォルトの名無しさん
05/06/13 01:14:18
>>223
自分ならdoxygenでRTFで出力してpdfに変換して添付ファイルにするか、
WORDでRTFを開いてDOCに保存しなおすか。
RTFだとリンクはそのまま残るし、ドキュメントとしてもそれなりに
綺麗に出力されるからお勧め。一度試してみれ。
232:デフォルトの名無しさん
05/06/13 01:22:28
みなさんいろいろ言ってますが
それでお客に納品するの？
おいらは、Visioやパワーポイントも使わないようにしてるけど
打ち合わせ資料で使うときあるけど、最終的にはエクセルで書き直す事になる
233:223
05/06/13 01:31:32
>>231
ふむ、試してみます
234:デフォルトの名無しさん
05/06/13 03:52:03
XMLにコードとドキュメントを共存できる
XMLに対応したコンパイラ
235:デフォルトの名無しさん
05/06/13 11:35:27
>>234
XMLってマジで言ってますか？
236:デフォルトの名無しさん
05/06/13 20:30:41
>>234
XSLT使えばどうにでもなる気がする
237:デフォルトの名無しさん
05/06/14 13:26:23
つーかかつて Knuth というシトが
「文芸的プログラミング」(literary programming)
つーのを提唱して WEB つーシステムを開発したよね
それやりゃいいんだろ
238:デフォルトの名無しさん
05/06/14 21:01:39
,,ｒ'" ｀ヽ,、
,r" .,/i、 .ﾍ, ｀ヽ、
､" ./::::::i, /ヽ l..:::i, . '、
/ .,/:::::::::::i /.,:::l i::::::::i 、 ヽ
/ .,、.,i:::::::::::::::i, /:::::::::v,,:::::::::l, ,li i
│ /:l./::::i::::|l::::::V,:::::::/i:::::::ﾍ::::::V::l, . | ,.,..,,.,..､、
| ./:::l:::::::l-i:|-!::::::::::::::/ 'l:::/--l::::::;;;;l ..ﾚ'"´
l .i::::::::::::l-i-'｡.ヽ::::::::/ ´l/-｡､i:::::::::::! ..i 可 理
'!l:::::::: ﾍl |::::::l` i:::::/ ｲ::::::| ,!/::::::. i | 能 論
i::::/i::::l,｀ ￣｀ Ｖ ￣ i::::i::::./ な 上
V l::::l, J /::::i "i/ ん は
ﾞl:::＼ ＿＿ ./l:::/ で
'!/ ヽ._ ヽ ﾉ ,／" iv す
＿.|｀ヽ- -イ|＿ ＜ ﾟ
,,､ノ;;;;;;;||||| |||||;;;;;;;ヽ.｀!
SmartDocみたいな使えないものになるのが落ち
239:デフォルトの名無しさん
05/06/26 01:01:12
今のプロジェクトのドキュメントは
基本設計書からすべてExcelだ（´･ω･`）
確かに図を書くのがラクだけど・・・
240:デフォルトの名無しさん
05/06/26 17:00:24
質のいいスケルトンがあれば
Wordでもなんでもいいと思う
241:デフォルトの名無しさん
05/06/26 17:48:03
>>240
おれ、ワードは線がずれたら直せないんだよ。
242:デフォルトの名無しさん
05/06/26 17:52:50
>>241
根性、根性、ど根性
ちなみにIMEだと ど根性 で一単語になってる
243:デフォルトの名無しさん
05/06/27 03:53:01
IME
244:デフォルトの名無しさん
05/06/27 12:39:17
MS-IMEもATOKも「IME」だからな
245:デフォルトの名無しさん
05/06/28 11:06:46
MS-IMEがポピュラーになるまでは
FEPって方が通りがよかった。
だからついMS-IMEの事をIMEといってしまうま。
246:デフォルトの名無しさん
05/08/21 20:15:27
そんなことないよ
247:デフォルトの名無しさん
05/08/22 09:31:21
結局、仕様書書くのにどんなアプリつかっている？
俺の場合
図や表、文をまぜこみの仕様書である程度見栄えも気にする場合は、
OpenOfficeOrg2.0Betaを使っている。
Wordは俺は受け付けることができなかったが、Oooはなんとか好きになれそう。
htmlでやっているって言う人は、テキストエディタでごりごり書いているのだろうか？
ま、それが一番書きやすいのだが、そろそろhtmlエディタで良いのが出てきてほしいなあ。
248:デフォルトの名無しさん
05/08/22 19:05:24
マクロ使えるエクセルに決まってんじゃん
Wordは俺のUIと合わなかった
249:デフォルトの名無しさん
05/08/27 15:18:42
Wordは、いらぬお世話をするオプション類を全部OFFにして使えば使える。
挙動不審な事が多いし良く落ちるがドキュメントやマニュアルを書くのにはやっぱ
エクセルよりワードだな。
250:デフォルトの名無しさん
05/09/03 13:55:02
一度、どこかマ板辺りで
プログラマのためのワード講座
みたいなスレを立ててみようか
使いにくいと文句をいっている人は
例えるなら秀丸でVC++のソース編集してるようなもので
きちんと環境構築と突然死への備えを整えれば
VisualStudioなみの便利さを手に入れることはできる
251:デフォルトの名無しさん
05/09/10 01:05:56
僕は、LaTeXちゃん！
252:デフォルトの名無しさん
05/09/10 04:56:03
うちは何故かエクセル。開発環境はLinux＋Eclipseなのに、文章作成は
Windowsでエクセル（ ﾟдﾟ）ﾎﾟｶｰﾝ
社内通達がエクセルで回って来た事もある。本文無しで添付ファイル
があるだけという、思わずゴミ箱に放りそうになったぞ。
それはそれとして、前に文章作成なのに何故エクセル？という問いを
投げてみたんだが、エクセルで何の問題がある？と聞き返されて有耶
無耶になった。
ワードを使えば云々と言えるほど、俺はオフィスツール知らんからな。
て言うか、正直エクセルも線の引き方と文字の属性変更くらいしか知
らんのだけどねorz
誰もが納得するワードの利点とかあるなら聞きたい＞250
253:デフォルトの名無しさん
05/09/10 08:15:48
>>252
おぢさん達はExcelが大好きなのです。
日々の報告書からプレゼン資料まで、全部Excelで作ってくれます。
Wordは勝手に整形しやがるから使いにくいそうです。
罫線使いまくりの日本語文書はExcelの方が使いやすいんでしょう。
250じゃないが、誰もが納得するWordの利点： （取引先も含めて）みんなが使ってる
254:デフォルトの名無しさん
05/09/10 09:31:46
目次勝手につくってくれる
分厚い仕様書を方眼紙みたくしたエクセルで書かされて
目次の管理で死にました。
255:デフォルトの名無しさん
05/09/10 15:11:30
>>252
スタイル
なぜかあんまり使われていないようですが……
256:名無しさん＠そうだ選挙に行こう
05/09/10 19:01:51
>>252
エクセルだと表計算と図と文章作成、全てエクセル
でやろうと思えば済んでしまうらしいので、プレゼン資料
とかも全部エクセルだけにしてる奴がたまにいるｗ
257:名無しさん＠そうだ選挙に行こう
05/09/10 20:13:54
>>253
みんなが使ってる度ならExcelの方が上じゃない？
少なくともWordの方が一方的に有利って事はないと思う。
>>255
初めて聞いたｗ
>>256
最近、MindManager(MindMap)が大人気。
少し前はEA(UseCase)が大流行だったが
次は何が流行るんだろう？
258:名無しさん＠そうだ選挙に行こう
05/09/11 00:56:45
>>257
Wordのスタイル、少し覚えてみなよ。
マジデ便利だから。
259:名無しさん＠そうだ選挙に行こう
05/09/11 01:08:00
なんか興味が出てきてWordを立ち上げてみる
インストールして5年は経っているが、たぶんこれが起動2回目くらいだな
んでしばらくイジくってみたんだけど、テキストボックス使えればOKな感じでいいのかね？
他にめぼしい機能あるかな。些末なの抜きで。
260:名無しさん＠そうだ選挙に行こう
05/09/11 03:38:57
>>259
>些末なの抜きで。
Wordの売りはむしろ些末な機能が豊富にあるとこかもしれんｗｗｗ
261:名無しさん＠そうだ選挙に行こう
05/09/11 03:40:38
デフォ設定で自動補正になってなけりゃもっと評価高いかも
迷惑な便利機能を殺したくてその便利機能について学ぶという不毛な時間がすごくアレだ
262:名無しさん＠そうだ選挙に行こう
05/09/11 04:01:28
でも、ホント、Word の売りってなんなんだろうな？
パワポは俺も最近までは全然評価してなかったんだけど、会議で使う資料をパワポで作ったら、
いつもテキストファイルで書いてる内容と変わらんのに、妙に内容の評価がよくてﾜﾗﾀ。
やっぱり人は体裁で騙されるもんだなｗｗｗ ・・・それからはパワポに一目置いている俺ｶﾞｲﾙ。
263:名無しさん＠そうだ選挙に行こう
05/09/11 11:27:31
>>262
発表において、体裁ってもんがどれほど重要か。
どんな小手先の技でもいいから、人の気を引くというのは大切よ。
Word の利点、ぱっと思いついたのだと、
- 修正履歴を残せる → 学生の論文チェックとかかなり楽
- コメントを付けれる → これも校正に凄く便利
- スペルチェック → 英文はとりあえず最初 Word で書いとけみたいな
- 一応、段落ごとにスタイル定義しておいて、スタイルの書式変更したら同じスタイル一斉に変更される
264:名無しさん＠そうだ選挙に行こう
05/09/11 13:27:47
Wordで20ページ↑の仕様書を書いてみればわかるよ
スタイルとかクロスリファレンスつけておくとマジ便利
目次や索引も自動で作れるし。
これでもう少し図形描画の機能が充実してればなぁ・・・
ま、そっちはVisio使ってるからいいんだけど。
#でも、個人的にはLaTexを吐いてくれるエディタが欲しいところ
265:名無しさん＠そうだ選挙に行こう
05/09/11 13:29:26
利点
- 目次作成 + 自動更新
- 図表番号の自動更新
266:名無しさん＠そうだ選挙に行こう
05/09/11 17:20:24
>>263-265
どれも俺からすると些末な機能なんだけど。
XSLTが大好きな俺的にはXML形式に対応してるところなんかが蝶最高なんだけど、
これはExcelやパワポでもできることだしな。
267:名無しさん＠そうだ選挙に行こう
05/09/11 17:33:54
Wordの最大のウリは
多数派であるということ
268:名無しさん＠そうだ選挙に行こう
05/09/11 17:50:31
>>264
最近のはマシなんか？
Wordでページ数多い文書作ると重いわすぐ落ちるわで……
いい印象無かったんだが
269:名無しさん＠そうだ選挙に行こう
05/09/11 18:28:11
>>264-265
この辺のテンプレート集とかスクリプト集ってある？
折角の利点も簡便で分かり易くないと説得が難しい。
偉いさんてのはプライドを刺激されると意固地になるからな。彼らは難しいとか
理解できないを決して口にせず、それらを必要がないの一言で片付けてしまう。
270:名無しさん＠そうだ選挙に行こう
05/09/11 18:32:51
>>267
Excelの方が多数派だよ？
総務などの非生産部門には必ずと言っていいほどExcelが導入されてるから
271:名無しさん＠そうだ選挙に行こう
05/09/11 18:33:14
>>269
目次だのなんだのって、単なるWordの基本機能だから、スクリプトは不要だよ。
ちゃんとスタイル使って（「見出し1」とか「見出し2」とか）文書を
書けば、章番号を自動で振ってくれるし、後でそれをもとに自動で目次が作れる。
272:名無しさん＠そうだ選挙に行こう
05/09/11 18:34:18
>>270
ExcelとWordでは用途が違うというだけの話だ。
適材適所で使い分けるのが賢いやり方。
273:名無しさん＠そうだ選挙に行こう
05/09/11 18:51:04
>>271
ありゃ？そうなのか、て言うか基本機能なのかよ！
俺自身が実際に触って、基本機能くらいは理解しないと話にもならんな＿|￣|○|||
それが何とも億劫と言えば億劫なんだが……
俺も偉いさんの事をとやかくは言えんな……
>>272
問題は、決して賢くないという点だ！Σ(´Д｀ ）
274:名無しさん＠そうだ選挙に行こう
05/09/11 19:02:01
>>273
URLﾘﾝｸ(www.amazon.co.jp)
この本がおすすめ。
アウトラインモードで取り敢えず書くのが
自然に思えてきたら結構使ってる人なんじゃないでしょか。
275:名無しさん＠そうだ選挙に行こう
05/09/11 21:47:06
>>273
俺、元々LaTeX派だったけど、3日でWordに転向しちゃったよ。
割とすぐ覚えれる。
276:名無しさん＠そうだ選挙に行こう
05/09/11 21:50:52
>>274
この本、自分も人から薦められて買ったけど、かなりいい本ですね。
職場に一冊常備すべし。
277:名無しさん＠そうだ選挙に行こう
05/09/11 22:54:18
Win板かソフ板の話題が続いている件について
278:デフォルトの名無しさん
05/09/12 00:35:07
>>274-276
ホントかよ？ジエリじゃねぇだろうなｗ
とりあえず明日本屋行ってくるよ。初心者向けではないみたいだから
一緒に入門書も買ってくる。
279:デフォルトの名無しさん
05/09/12 00:59:59
>>278
じえんじゃないよ。
まあじえんだとしてもいいじゃん
本屋で立ち読みしてみて決めてちょー。
カラーページがないところとかが硬派で
それだけで好感が持てますだ。
DTPのマナーみたいな話も、システム文書には
必要ないけど、面白かったな。
280:デフォルトの名無しさん
05/09/16 00:55:41
Wordのスタイル機能は書式をいぢりづらいのがネック。
特にスタイル使わずに書かれた文章にスタイルを導入しようとすると死ねる。
281:デフォルトの名無しさん
05/09/16 10:45:36
>>280
あとからは相当骨でしょそりゃー。
282:デフォルトの名無しさん
05/09/23 00:26:28
なんかMSワードって何処でも決まって悪者にされる傾向があるけどなんでだろうね。
俺はかなり良いソフトだと思うんだけど。いやマジで。
今までアドビのフレームメーカーとかロータスのワードプロも触ってきてるけど
ワードのUIはそれらより飛びぬけて直観的だし、機能も多い。
ワード使い難いって奴はフレームメーカー使ってみるといいかも。
フレームメーカーの糞UIはマジで殺したくなるよ。それでいてワードより高かったりしたから恐れ入る。
まあでも時々挙動不審だったりするし、段落番号の設定みたいに異常にわかり難い
UIがあったりする欠点は確かにあるな。
それにしても、ワード貶してる奴らに関しては、ワードの問題というより
そいつらの能力の問題じゃないかと思うが。
283:デフォルトの名無しさん
05/09/23 01:07:59
デフォルト設定のせい
UNIXが使いにくいのとおなじ
284:デフォルトの名無しさん
05/09/23 11:01:41
それにしても、UNIX貶してる奴らに関しては、UNIXの問題というより
そいつらの能力の問題じゃないかと思うが。
285:デフォルトの名無しさん
05/09/23 14:04:57
じゃあWordに文句を言うやつも無能だな。
286:デフォルトの名無しさん
05/10/10 16:31:55
>>285
そりゃ無能だろ
287:デフォルトの名無しさん
05/10/10 17:27:01
あーでもWordの使いにくさとUNIXの使いにくさは別だな。
UNIXはどうしようもないからな。
288:デフォルトの名無しさん
05/10/10 17:33:25
doxygen 1.4.5 age
289:デフォルトの名無しさん
05/10/10 17:34:07
なんで並列に語ってるのか知らないけど あえてノルなら
Wordの使いにくさは 袋小路 であり、UNIXの使いにくさは 迷路 だ。
Wordでやりたいことをやるとき、正式な方法が無いことはよくあり
正式じゃない方法で突破することが多い
UNIXでやりたいことをやるとき、正式な方法がそもそも難解で
そのことを訴えると「道があるんだからいいだろ」と突っぱねる
290:デフォルトの名無しさん
05/10/10 18:29:51
Linuxの場合、とっつきやすさや使いやすさを最初から目指していないのだから使いにくくて当然な気がする。
Wordはなー。MSってUIにけっこう力入れてるはずなのになんであんなことになるのか。
291:デフォルトの名無しさん
05/10/10 19:38:35
英文だと一般の評判多少マシなのか？
292:デフォルトの名無しさん
05/10/11 11:07:21
ドキュメンテーションを書くときは常に例を書き込むとかなりグー。
PHPのドキュメンテーションなんていい例じゃないかな。
使い方系のドキュメンテーションはシナリオ書いとく。
ところで、結局Wiki立てても書くのは結局一人だけだよなぁ。
でもみんなで書くという機能よりも手軽にどこからでも書けるというのが気に入ってる。
使いこなすとかなり快適。あとはVISIOでちょっと図を描いて終了。
293:デフォルトの名無しさん
05/10/27 03:40:16
確かにリファレンスとかは、
動作例ある方が読みやすいもんな。
つーか動作例無いと、リファレンスに見えないというか。
294:デフォルトの名無しさん
05/11/01 01:47:40
ドキュメントなんか書いてる暇があったらソースを書け。
295:デフォルトの名無しさん
05/11/06 15:48:48
概要仕様はワープロソフトできっちり作るな。納品しやすいし。
細かい仕様はソースにコメント埋めまくり。
ワードとかUNIX使いこなせない香具師はスキル低いだけ。
何か一つだけしか覚えられない香具師がエクセル使っている感が有るな。
自由紙、原稿用紙、レポート用紙、方眼用紙っていろいろあるけど、どれか一つ選べって状態で方眼紙選んじゃってるだけだ。
レポート用紙にグラフも書けるのにさ。
296:デフォルトの名無しさん
05/11/11 16:36:53
どのソフトを使うかなんか関係ないって。中身ですよ中身。
つーか、こんだけソフト開発が行われてるんだから、もちっとドキュメント作成技術も洗練されていてくると思うんだけどな～。
どこのプロジェクト行っても、読まれない＆読んでも意味ないドキュメントばっか。
新規で起こす時も役にたたねぇだろうなーと思いつつ作ってるし。
それともオレが知らないだけで、既に良いツールor作成理論とかあったりするの？
もしあったら教えてエロイひと
297:デフォルトの名無しさん
05/11/11 22:53:22
>>296
コツを教えてあげるよ
自分が欲しいと思えるドキュメントを作ればいいよ
役に立つように作るべし
役に立たないと思った個所はどんどん削除
298:デフォルトの名無しさん
05/11/11 22:55:25
あと、起承転結では読みづらいので 起結承転 を心がけること
299:デフォルトの名無しさん
05/11/11 23:11:01
正直「転」はいらん。
300:デフォルトの名無しさん
05/11/11 23:23:41
統合設計書作成アプリケーション作って。
普通のアプリでWikiっぽい機能＋Wordの章番管理＋Excelみたいな表が
自由に作れる幹事で
301:デフォルトの名無しさん
05/11/12 08:19:16
転ってアレか。
この関数は○○の機能を持つ <- 起結
ただし、××の副作用を持つ <- 承転
302:デフォルトの名無しさん
05/11/12 17:11:51
さすがにtxtを推奨する奴はいないようだ。
303:296
05/11/14 09:43:53
いや、ドキュメント書けないわけじゃないないけどね。
この業界、結局ウォーターフォール型がほとんどじゃない？
だったら 要求＞仕様＞設計＞試験 ぐらいのテンプレートとか支援ツールあってもいいんじゃねーかなと思って。
それに有名な規格ができたら、顧客の理解度、満足度ももっと高くならないかなぁ。とか
（Rational Rose とかは勘弁な。”UML図”だけじゃレビュー通らないし）
あと変に思うのは設計書。実装イメージをそのまま文書にしたのをよく見かけるけど、設計書は利用者ガイドであるべきだと思うんだ。
あの高いソフト買うと付いてくる大量のマニュアル郡みたいに、コンセプト、概要、実装サンプル、注意点、とか。
設計者が変わりに文書で実装しても意味ないっしょ。
あ～ぐだぐだと駄文書いてスマヌ
304:デフォルトの名無しさん
05/11/14 10:41:15
俺もそう思う。
納品物としての仕様書なんかいらん。読んでくれないし。
きっちり書いたユーザーマニュアル納品すれば一番ブレがない。
要求は全てそこに落とせばいいんじゃないかなあと。
だからマニュアルといっても画面の説明だけじゃなくて
半分業務マニュアルって感じ。
所謂仕様書らしい仕様書は、
お客さんにガッチガチの情シスがあって
そこが出せっていうんだったら書くよ、って感じで
いいんじゃないでしょうか。
なんか仕様書とあまり変わらないか。
でも言葉とかフォーマットとか、もっとお客さんに優しい感じ。
305:デフォルトの名無しさん
05/11/14 13:50:36
納品物としての仕様書は、
質重視ではなく量重視だな。
306:デフォルトの名無しさん
05/11/14 15:40:39
すると普通の仕様書より表現が冗長になりそうな
マニュアルでの納品がやっぱいいな
スクリーンショットわんさかで
307:デフォルトの名無しさん
05/11/14 21:10:06
>>301
そんな感じ
注意事項
308:デフォルトの名無しさん
05/11/15 01:24:59
>>306
マニュアル + クラス仕様書(自動生成したもの) が最強。
そして両面印刷なんてもってのほか。
309:デフォルトの名無しさん
05/11/29 03:00:58
>>254
亀レスすまそ。
よくExcelのセルを方眼紙みたい（正方形）にする人がいるんだけど、
あれって何が便利であんなセルにしちゃうわけ？
レイアウトしやすいってだけ？
310:デフォルトの名無しさん
05/11/29 10:04:30
本当に方眼紙に仕様書を書いてた名残らしい。
あと、インデントしやすいからといってた。
311:309
05/11/30 18:12:53
>>310
方眼紙ってそのまんまかいなｗ
312:デフォルトの名無しさん
05/12/31 19:33:11
doxygen 1.4.6 age
313:デフォルトの名無しさん
05/12/31 20:00:13
wiki風の装飾付きtxtを書いて、自前ツール通してhtmlにしてるな。
リンクやレイアウトが簡単だし、ブラウザは誰でも入ってるから。
314:デフォルトの名無しさん
06/01/25 17:59:27
doxygenのマニュアル読んでも、「使わねー」とか「ソース汚なくなるだけー」
みたいなコマンド(キーワードや記法)が多いと思ったんだけど、どう？
おまいらのdoxygenボキャブラリーはどんなもんよ？
315:デフォルトの名無しさん
06/01/25 22:45:51
file brief author
pre post param return retval
後メンバグループにname { }
316:デフォルトの名無しさん
06/01/27 09:26:58
>>315
それだけあれば、ひととおりの仕様は説明できそうだよね。
「意見」なんかを入れはじめるとややこしくなるんだよね。
317:デフォルトの名無しさん
06/02/25 02:38:32
ドキュメントが書けないやつは自分の頭でわかってないからだ。
自分ではわかってるけど説明するのが下手というやつは、自分でも
わかってない。それは直感と連想能力とヒントでピントでプログラミング
してるだけだ。
318:デフォルトの名無しさん
06/02/25 11:59:02
16分割の最初の2枚ぐらいでわかっちゃうようなやつには
ドキュメント作成なんてまだるっこしくってやってられんのだろうな。
馬鹿の気持ちが分からないから、標準からはずれたのを作成してしまう。
医者なんかでもそうだけど、臨床とかエンドユーザーが絡む作業は
あんまり頭が切れるヤツは向いてなくて、
ちょっと馬鹿だけどそれを自覚して慎重・着実に作業する
ヤツの方が向いてる。
319:デフォルトの名無しさん
06/03/04 02:25:09
ソフトウェア開発の世界標準フォーマットみたいなもの無いかな
各工程で何の文書が必要で、どのような項目を記載するものだ、みたいな
320:デフォルトの名無しさん
06/03/32 17:58:17
UMLって客に見せても実際は理解してもらえない。
客側に上級シスアドみたいなのがいれば話は別だが、現在ではそんな状況はあまりない。
結局UMLで書くってのは設計者のオナニーなんだなと思う。
なにしろUML試験なんかあるくらいだから、コンピュータど素人のお客にわかりやすいわけがない。
ところでXP開発におけるドキュメントの生成の仕方ってどうしてる？
うちは要件定義書が文章じゃなくて業務フローのの図だけなんだが。
そんなのが入力では詳細設計書なんて書けないぜ。
321:デフォルトの名無しさん
06/03/32 18:31:53
UMLは客に理解してもらうためのもの、
なんて言ってる人はあなた以外に見たことありませんけどw
自分が勝手に銀の弾丸を求めてるだけでしょ？
銀の弾丸がきっとあるに違いないと無意識に思ってるから
ネジ廻しがネジを締めることにしか使えないことに苛立つんだよ。
322:デフォルトの名無しさん
06/03/32 18:57:02
＞UMLは客に理解してもらうためのもの、
＞なんて言ってる人はあなた以外に見たことありませんけどw
見聞が狭いんだね。俺は何人か知ってるよ。
見たこともない、とは重傷だな。
323:デフォルトの名無しさん
06/03/32 20:35:16
ダメなドキュメントってあるよね。当たり前のことしか書いてなくて、
ポイントが抑えられてないような。
UMLだろうがワードだろうが、同じ人間が書く限りダメなドキュメントなのは変わらないのが現実
324:デフォルトの名無しさん
06/03/32 23:02:48
ドキュンメント
325:デフォルトの名無しさん
06/04/09 00:06:13
みんなはdoxygenでコメント書くとき
Qtスタイルにしてます？JavaDocスタイルにしてます？
326:デフォルトの名無しさん
06/04/09 17:17:32
JavaDoc スタイル。
Qt ってマイナーだし Qt にするメリットってあるの？
327:デフォルトの名無しさん
06/04/09 20:37:45
>>320
むつかしく書きすぎ、細かく書きすぎ
なんじゃないの？
328:デフォルトの名無しさん
06/04/09 21:42:04
言われてみればそうだよな…・。
伝えるだけなら、
紙に手書きしてコピったりスキャナで取り込むなりの方が遥かに敏速。
329:デフォルトの名無しさん
06/04/10 03:00:04
>>319
それこそ本屋にいけば山ほどその手の本があるやん。
成果物が一番はっきり明示されているのはラショナル統一プロセス
じゃないの。ISO9001なんかを取得している会社なら社内標準で
成果物が設定されているでしょ。
>>320
オブジェクト指向言語で開発しているなら、それとの親和性の
高さという点から、内部設計はUMLでするのはいい。けど、
要求仕様をユースケースなんかで顧客に見せるやつの気が知れない。
というかそういうやついるのか？俺はずっと前からアンチユース
ケース派でそういうことばっかり言っているけど。
330:329
06/04/10 03:02:49
>>319
それと追記するけど、どんな職場や環境、メンバーのスキルに
合致した魔法の世界標準フォーマットは存在するわけがない。
それぞれに合致したものはそれぞれが苦労して考えるしかない。
参考にするのはいいけど、巷に出回っている開発プロセスを
そのままやろうとすると失敗するよ。
331:デフォルトの名無しさん
06/04/18 15:12:14
質問。
仕様書だけ書いて、それを
ベクターみたいに、アップロードして
みんなに見せるサイトって、どこかある？
332:デフォルトの名無しさん
06/04/18 15:15:33
参考。仕様書相互リンク
良いドキュメント・マニュアル・仕様書を書くスレ
ｽﾚﾘﾝｸ(tech板)
小規模開発では仕様書は作るだけ無駄
ｽﾚﾘﾝｸ(prog板)
AJAX時代の仕様書とは
ｽﾚﾘﾝｸ(tech板)
営業が作った仕様書に
ｽﾚﾘﾝｸ(prog板)
良い仕様書、悪い仕様書、普通の仕様書
ｽﾚﾘﾝｸ(prog板)
プログラマ経験がないのに仕様書を作成
ｽﾚﾘﾝｸ(prog板)
仕様書の量でしか成果を決められない客
ｽﾚﾘﾝｸ(prog板)
Excelで仕様書を作る会社の奴の数→
ｽﾚﾘﾝｸ(prog板)
333:デフォルトの名無しさん
06/04/19 02:18:12
Doxygenの質問はここでいいのかな…？
HIDE_UNDOC系のタグをYESにしててドキュメント付けした要素だけ
書き出してるんだけど（もちろんEXTRACT_ALLはNO）
\fnとか一行コメントとか付けてない関数を強制的にドキュメントに含めてよ！
って指示するコマンドありますか？
今は全角空白の一行コメント付けて無理やり出してるんだけど
リスト表示のとこで無駄に下に空白ができちゃってみづらいんです
（同じページに列挙したいけどわざわざコメント付けしたくない関数ってのがいっぱいある）
334:sage
06/04/28 11:10:03
コーディングは製造であって、
その前に設計仕様書があるべきだと思うんですが、
DoxygenやJavaDocで出したものを、仕様書にするってことは
それ以前にモジュール設計仕様書とか無いままコーディング
してるんでしょうか？
335:デフォルトの名無しさん
06/04/28 12:19:21
中身ダミーで関数名と Doxygen 形式の仕様コメントだけ入れた骨組みをもって設計仕様ではダメなの？
336:デフォルトの名無しさん
06/04/28 13:07:44
で、実際んな事やってんの?って話だろ
337:sage
06/04/28 13:21:18
>>336
そりゃ、設計代もらってるんだからやりますよ
フリーソフトウェアの開発者とかなら話は別ですが…
338:デフォルトの名無しさん
06/04/28 13:55:57 BE:162918959-
鉄面皮で四角四面のウォーターフォール うぜぇ
339:デフォルトの名無しさん
06/04/28 17:09:48
>>334
>コーディングは製造であって、
違います。
- コーディングは設計作業です
- ソースコードは設計成果物です
- コンパイル・リンクなどが製造工程になります
340:デフォルトの名無しさん
06/04/28 17:25:01
不正確でつまんない比喩なんてどうでもいいよ。
341:デフォルトの名無しさん
06/04/28 21:56:05
>>339
幸せだなぁ…
そう思ってるうちはコーダーから卒業できんよ
342:デフォルトの名無しさん
06/04/28 22:45:00
東芝とか日立とかの大手が集まって仕様書の標準作るらしいね。
２００７年をめどに完成予定とか。
どうなるのかな？
343:デフォルトの名無しさん
06/04/29 04:30:26
実行されたプログラムの動作こそが製造だ。
コーディングは、ラインの設計だ。
344:デフォルトの名無しさん
06/04/29 10:24:49
不正確でつまんない比喩なんてどうでもいいよ。
345:デフォルトの名無しさん
06/04/29 21:31:40
コードコンプリートの
メタファの章はよくまとまってるよ
346:デフォルトの名無しさん
06/05/01 20:45:13
Doxygenを実際使ってるプロジェクトってある？
俺は個人的にちまちまいじってるぐらいです。
みんなに使ってもらうにはやはり雛形を作成するしかないけど
どんなのがいいのか思案中。
なにかサンプルと成るものってあります？
347:デフォルトの名無しさん
06/05/01 20:49:42
>>346
Doxygen 自体
libstdc++
Subversion
いっぱいあるよ。
っていうか、雛形なんか要らないと思うけど。
348:デフォルトの名無しさん
06/05/01 20:54:11
Doxygenで悩むのがテンプレート定義しかないヘッダファイルへのコメント
そりゃヘッダに実装も書いてあるんだからそこにコメント付けるのが自然かもしれんが
各テンプレートの間にミッチりコメントが詰まってソースコードとして読みづらくなる（困
こういうときってコメントだけの空cppファイルとか作るんですかね？
349:デフォルトの名無しさん
06/05/01 20:58:42
>>348
Doxygen とか関係なしに、コメント書きすぎなんじゃね？
もしくはコメント書かざるをえない設計とか？
350:デフォルトの名無しさん
06/05/01 22:23:54
>>349
書きすぎってのはあるかも試練…
対象ユーザーのC++理解度が低い前提で書いてるんで
どう使ったらいいかのコード例みたいのもコメントに含んでるんだけど
やりすぎかね
@defgroup してモジュールの説明とか書き始めるともうコメントだらけですよ
351:デフォルトの名無しさん
06/05/02 16:26:03
サンプルみたいなものが書いてあるならそれはコメントとは呼ばないよ
352:デフォルトの名無しさん
06/05/05 14:12:41
doxygenだと__declspec(property)とかがメソッドとして認識されちまう。
なんかうまい方法ある？
っつーかこんなん使うなって話になりそうな気もするけど
353:デフォルトの名無しさん
06/05/06 13:39:38
>>352
プリプロセッサで消せば？
こんな感じで。
#ifndef __MSC_VER
#define __declspec(arg) /* ignore */
#endif
354:デフォルトの名無しさん
06/05/11 01:18:44
おぉ？
URLﾘﾝｸ(www.doxygen.jp)
355:デフォルトの名無しさん
06/06/11 22:16:55
Doxygen 1.4.7 age
356:デフォルトの名無しさん
06/06/14 14:33:53
ちょっと見やすくなったね＞1.4.7
357:デフォルトの名無しさん
06/06/22 09:09:28
1.4.7 で dot を使おうとすると FreeSans.ttf が見つからんエラーになるなorz
まあ、すでに bugzilla に報告済みだから次のバージョンでは何らかの対策がされることを
期待するが。
358:デフォルトの名無しさん
06/06/22 10:13:30
【佐賀】サムスンSDS開発のシステム不具合で市が課税ミス 昨年度はSEがデータだけ修正して誤魔化した？
ｽﾚﾘﾝｸ(newsplus板)l50
佐賀市は１９日、市税や住民票などを管理する市独自の基幹システムでプログラムエラーが
あり、国民健康保険税に課税ミスがあったと発表した。
この基幹システムは、旧市が韓国ＩＴ大手の「サムスンＳＤＳ」と約８億７千万円で共同開発し、
０５年４月から運用を始めた。開始直後は約５０人の同社員がエラーをチェックしていた。
市情報政策課は「昨年度もエラーはあったはずだが、データを手直ししただけで、プログラム
自体を修正しなかった可能性が高い」と話している。
359:デフォルトの名無しさん
06/06/29 23:09:03
URLﾘﾝｸ(www.atmarkit.co.jp)
360:デフォルトの名無しさん
06/07/16 19:06:32
doxygenで
/// @file test.hpp
/// @brief doxygenテスト
/// 加算
int add(int a, int b);
/// 加算
加算double add(double a, double b);
をドキュメント化すると最初のint add(int a, int b)しか載りません。
クラスのメンバ関数はオーバーロードしたものもドキュメントに載るのに。
何か方法はないでしょうか？
361:デフォルトの名無しさん
06/07/16 19:15:50
>>360
その 加算double ってのは何だ？
362:デフォルトの名無しさん
06/07/16 19:23:54
タイプミスです。すみません。
/// @file test.hpp
/// @brief doxygenテスト
/// 加算
int add(int a, int b);
/// 加算
double add(double a, double b);
363:デフォルトの名無しさん
06/07/24 11:03:53
.bat, .vbs, .rb等々どんなソースにも仕込める
簡単な書式のヘルプ作成ツールみたいなのないですか？
例えば.batなら
@echo off && goto enddoc
<title>mytool</title>
<description>なんか役に立つツール</description>
<parameters>
-h: このヘルプを表示
-v: verbose
</parameters>
:enddoc
...
メインの処理
とかやっといてフィルタかますとmytool.htmが生成されるとかそんな感じのもの
364:デフォルトの名無しさん
06/07/24 18:39:30
>>363
その程度だったら、
自分でRubyかPerlあたりでフィルタ作ればいいんじゃない？
上の例を借りると、
@echo off && goto enddoc
REM @XX_BRIEF <title>mytool</title>
REM @XX_BRIEF <description>なんか役に立つツール</description>
REM @XX_BRIEF <parameters>
REM @XX_BRIEF -h: このヘルプを表示
REM @XX_BRIEF -v: verbose
REM @XX_BRIEF </parameters>
:enddoc
とでもしておいて、
行中に@XX_BRIEF等の特定のキーワードが含まれるかチェック
→ キーワードの後ろから行末までの文字列を抽出
→ 必要に応じて文字列を整形し、特定のフォーマットに変換
→ ファイルに出力
という感じで。
ソースコード内の変数名やメソッド名を参照するようなことはできないけどね。
365:デフォルトの名無しさん
06/07/26 04:08:38
>>360, 362
1.4.7 で問題なく出力できた。
366:デフォルトの名無しさん
06/07/28 01:57:06
DQNメント
367:デフォルトの名無しさん
06/10/18 11:22:21
Doxygen 1.5.0 age
368:デフォルトの名無しさん
06/10/30 01:23:57
doxygen 使ってますが、
> Generating caller graph for function foo
という行で止まってしまいます。
いつも同じ関数の処理をしている時に止まるようです。
止まってしまう関数の処理を中断して先に進ませる方法はないでしょうか？
369:デフォルトの名無しさん
06/10/30 11:19:27
Doxygen 1.5.1 age
370:デフォルトの名無しさん
06/10/31 00:35:52
doxygenだと改行が無視されて
せっかく綺麗に作ったコメントがぐちゃぐちゃになるんだけど
なにか対策ある？
371:デフォルトの名無しさん
06/10/31 00:43:23
>>370
<pre></pre> でどう？
場合によっては何かもっと適切な対策があるかもしれないけど。
372:デフォルトの名無しさん
06/11/01 00:55:01
\n書くとか。
漏れはもう改行を気にするのはやめたけど。
373:デフォルトの名無しさん
06/11/01 13:48:26
>>370
doxygenの整形に任せるのが正解。
改行が必要なほど複雑な説明を長々とコメントに書いてはいけない。
補足説明とか引数別の説明とか例外のリストとかそういうのは
それようのタグがあるのでそれを使ってdoxygenに整形させる。
374:デフォルトの名無しさん
06/11/11 11:36:25
楽にドキュメントを書ける(・∀・)ｲｲ！ツールすらないことがよくわかった。
おまいら今なら作れば売れるぞw
375:デフォルトの名無しさん
06/11/11 12:00:06
脳味噌にUSBケーブル接続して脳内仕様をダイレクトに出力できるデバイスが
発明されない限り、ドキュメント作成ツールのメガヒットはありえない。
376:デフォルトの名無しさん
06/11/11 13:26:33
えーそんなの出来たら
おっぱいとか満載になっちゃって大変そう。
雑念払う練習しないと。
377:デフォルトの名無しさん
07/01/08 23:42:18
ソースがドキュメントとか逝ってる人、勘弁してよ。
ちょっと不思議な動きしてるんですけど、
ソースのバグなんだか、仕様なんだか、わからないよ！
と、１０年以上前に誰かが作ったソースをメンテさせられることになって
鬱状態の僕は思いました。５万行もあるよ。。
みんな、doxygen使ってるか！
ちゃんと、その関数が何やりたいのとかきちんと書いてな！
あとsunのJavadocみたいに、スレッドセーフかどうかとかも書いてあるとうれしいよ！
パッケージとかモジュールとか、ソースより大きい単位でも
doxygenってドキュメント書けるの？
>>374
買うから作って。
あけましておめでとう。
378:デフォルトの名無しさん
07/03/10 16:46:51
"要求定義"
"要件定義"
同じものを違う呼び方してるだけ？
379:デフォルトの名無しさん
07/03/10 17:25:20
>>378
レイヤーが違う
上位が要件、下位が要求
380:デフォルトの名無しさん
07/03/10 17:53:37
なるほど。
これらを区別していない書籍も多いと思ったのですが、
そんなことないでしょうか？
381:デフォルトの名無しさん
07/03/10 17:55:28
多いか少ないかなんて問題なのか？
382:デフォルトの名無しさん
07/03/10 18:40:21
学習者にとっては問題です。
それぞれ英語では何という語句にあたりますか？
383:デフォルトの名無しさん
07/03/10 20:30:09
>>382
要件はマターとかファクター
要求はリクエスト
384:デフォルトの名無しさん
07/03/10 20:52:38
requirement...
385:デフォルトの名無しさん
07/03/10 21:02:38
>>384
requestもrequireも語源は同じですよ
re(再び) ＋ quaerere(ラテン語で求める)
再び求める ⇒ 要求、お願い
requireよりrequestの方が若干丁寧です
386:デフォルトの名無しさん
07/03/10 21:49:15
>>378
海外では"requirements definition"。
日本の計算機屋の言語感覚が鈍かったから、「要求」と「要件」がごっちゃになってる。
「要求」の方だけ覚えときな。
387:デフォルトの名無しさん
07/03/10 23:01:13
"要求"・・大学・研究機関で使われる
"要件"・・企業で使われる
だろ？
388:デフォルトの名無しさん
07/03/10 23:27:23
"要件"・・営業が使う
389:デフォルトの名無しさん
07/03/12 01:50:03
うーん。 難しいんですね。
レイヤーが違うというなら、
比喩的に、ボールペンの
要求定義、要件定義はどのようになるんでしょうか。
390:デフォルトの名無しさん
07/03/12 21:24:59
>>389
[要求]
先端は鋼などの硬球
運筆に応じて回転、軸内のインクが滲出
391:デフォルトの名無しさん
07/03/12 22:01:44
それは仕様じゃないの
392:こんなもんかな
07/03/13 10:29:20
仕様
速記に適し、それなりの耐久性を有すること。
ある程度の耐候性があればインクの種類は問わないが、掠れ難いこと。
393:デフォルトの名無しさん
07/03/13 10:52:47
[要求]
字が書けること
394:デフォルトの名無しさん
07/03/13 23:51:25
>>392
そっちのが要求じゃないの
あっこれマジレスってやつかっ？
395:デフォルトの名無しさん
07/03/14 00:16:56
「要件」は何？
396:デフォルトの名無しさん
07/03/14 00:48:48
要件定義書 ver0.00
- 普通紙に字が書けること
- インクの補充が容易であること
- 出来うる限りメンテナンスフリーであること
以上の要求を実現する筆記用具を開発することにより、ユーザーの利便性を高め
生産性の向上に（以下省略
＞以上の要求を実現する筆記用具を開発することにより、ユーザーの利便性を高め
＞生産性の向上に（以下省略
↑この辺が要件。
397:デフォルトの名無しさん
07/03/14 01:06:54
URLﾘﾝｸ(www.atmarkit.co.jp)
少なくとも日本IBMでは区別してるようだな。
IEEEでは単にSoftware/System Requirements Speciticationであって、
区別してないようだな。
398:デフォルトの名無しさん
07/03/14 01:19:00
俺もIだけど、要求しか使わないよ。
上の例で挙げられているような仕様書は、
今どきコボラーくらいしか書かないんじゃないかな。
399:デフォルトの名無しさん
07/03/14 04:30:05
要望と要求と要件は微妙に違うという意見もある
要望は客が単に思ってること
要求はシステム上不可欠なこと
要件は実装するシステム機能
ま、いちいち分類したところで、結局ドキュメントを書かないもれには関係ない話だｗ
400:デフォルトの名無しさん
07/03/15 00:34:54
要件とは顧客の要望や要求を日本語に文章化したものではないかと思います。。。
その意味じゃ>>396の言ってる事がしっくりくるｗ
401:デフォルトの名無しさん
07/03/15 17:05:37
management textでいうプロジェクトリーダーの理解＝要件
ってこと？
402:デフォルトの名無しさん
07/03/18 15:15:13
プログラム単体レベルで考えると、破綻する。
システム全体を見据え、ドキュメントを体系化すべし。
富士通だと、SDAS
URLﾘﾝｸ(img.jp.fujitsu.com)
NEC、日立も似たようなもん持ってる。（どれが良いとかはシラン）
孫会社、下請けは知らないかもしれないが、本尊の動きくらい知っときなょ。
403:デフォルトの名無しさん
07/03/18 21:26:20
俺の考えは、
マニュアル → 専門のテクニカルライターを使う
設計書 → システム全体が見渡せるもの／外部仕様はしっかり書く。
内部仕様はほどほど。（結局ソースが正になるから）
ドキュメントが無いソフトは糞とかいうけど、
ドキュメントが無いと保守できないソフトこそ糞だと思う今日この頃だよ。
404:デフォルトの名無しさん
07/03/18 23:12:23
全体の概要とか外部仕様、内部仕様を区別せず、
一口にドキュメントの是非を問うから議論が分かれる気が。
>>403 が言うとおり、
システム全体像・外部仕様はしっかり、
内部仕様はソースが正、doxygen とかで自動生成
って言えば、あんまり反対する人いないと思うんだけど。
405:デフォルトの名無しさん
07/03/18 23:15:45
マーケティング部門向けの仕様書って
開発用と別に書いて渡してますか？
406:デフォルトの名無しさん
07/03/19 00:49:55
>>404
内部仕様書でも、分業単位の分まではきっしり作っておこう
407:デフォルトの名無しさん
07/03/19 04:40:13
>>403
上場企業だと、内部統制の関係で全てキッチリ必要
408:デフォルトの名無しさん
07/03/27 23:59:41
unmanagedとmanagedのコードが混在したアセンブリのドキュメントってdoxygenで出力できますか？
CVSに入ってるdoxygenだとCPP_CLI_SUPPORTという設定が使えるみたいなんだけど
409:デフォルトの名無しさん
07/03/28 09:19:09
>>407
上場企業というより、メーカー系の企業だな。
やつらは工場で作るものとソフトウェアを同じ体系にまとめようとするからムリがある。
上場企業でもソフトハウス系はそんなことない。
410:デフォルトの名無しさん
07/03/28 12:50:41
>>409
でも、工場で作るものと同じ仕様で仕様書を作っておくと
何年後でも開発者が死んだあとでもメンテが出来たりするので
あなどれないんだよな
411:デフォルトの名無しさん
07/03/28 18:55:58
小さな会社が手がけるレベルの開発じゃそこまでライフサイクル長くない…
412:デフォルトの名無しさん
07/03/29 09:16:07
あって役にたつのは、外部仕様書と内部実装の理解を助けるための簡単なドキュメントだな。
それ以上細かい内部仕様書は糞。
思うに、本当の内部仕様書ってのはソースコード自身だと思う。
413:デフォルトの名無しさん
07/03/29 11:35:18
>>412
それじゃ バグがあっても仕様通り ぢゃあないか
414:デフォルトの名無しさん
07/03/29 11:50:55
そうそう、大抵納品後数年経ってから発覚するような(必ずしもバグでない)不具合があったときに
一番役立つのがソースコードとソース内にきちんと書かれたコメントなんだよね。
尤も、それらがきちんと書かれていないコードに限って後から不具合が露見するんだが。
で、ついでに言えばそういうプロジェクトは大抵仕様書に仕様変更がきちんと反映されていないから仕様書は手掛かりにしからない罠。
415:デフォルトの名無しさん
07/03/29 12:14:21
勝手に転載
979 名前： デフォルトの名無しさん [sage] 投稿日： 2007/03/29(木) 10:14:13
処理Aの仕様書
・・・Aを実行する。
１行きたー。どうしよう。
416:デフォルトの名無しさん
07/03/29 23:41:27
良いDQNなんていません
417:デフォルトの名無しさん
07/04/05 13:28:09
Doxygen 1.5.2 age
UTF-8 ｷﾀ
418:デフォルトの名無しさん
07/04/14 22:07:50
要件定義書とか設計書とかのフォーマットはダウンロードできるとこありますか？
書籍でも良いです
419:デフォルトの名無しさん
07/04/14 22:33:19
RFP本とUML設計本くらいしか知らない。
実務資料はふつープロジェクト外秘や社外秘だから
必要なら会社で見せてもらえ
420:デフォルトの名無しさん
07/04/14 22:35:59
ためしに 設計書 フォーマット でググったら、
見覚えあるプロジェクトの公開資料が出てきてびっくらこいたｗ
421:デフォルトの名無しさん
07/05/16 01:23:38
スレ違いかもしれませんがdoxygen使いの方が
多そうでしたので質問させてください。
WinXPProSP1 VB6.0で開発を行っており、
このVBのソースをdoxygenに出力させたいのですが、
どなたか方法をご存知の方はいらっしゃらないでしょうか?
ネットを漁りvbfilterを使用し、tee.exe/gawk.exe/sh.exeも必要との事でインストールし、
input-filterに 「C:\vbfiltervbfilter.bat C:vbfilter\tools」と入力し
なんとか変数一覧やメソッド一覧等が出力されるようになったのですが、
コメント部分の文字が化けてしまいます。
VBのソースがshift-jisで書かれておりdoxygenのinput-encodingが
UTF-8になっておりましたので、nfk.exeもインストールしdoxygenのinput-filterに
「C:\vbfiltervbfilter.bat C:vbfilter\tools|"nfk -w"」
としてみたのですがうまく変換されません。
(nfk単体で確認した所うまくshift-jis→utf-8変換処理は動作しておりました。)
恐らくdoxygenのinput-filter辺りでうまくパイプ処理が使えていないのが
原因だと思います。
４～５時間ほど試してみたのですが自分の力では解決できず
書き込みに至った次第です。
説明不足も多々有ると思いますがどなたか
方法をご存知の方がいらっしゃいましたらご教授のほどよろしくお願い致します。
422:デフォルトの名無しさん
07/05/16 06:57:14
>>421
ソースが shift-jis だってんなら INPUT_ENCODING=Shift_JIS だろ。
423:デフォルトの名無しさん
07/05/16 10:48:18
手元のDoxyfileにはinput-encodingなんてないのだが。
で、input_filter="iconv -f eucjp -t cp932"、use_windows_encodig=yes、output_language=japaneseで使ってるが。
#doxygenはcygwinので、バージョンは1.5.1。
424:デフォルトの名無しさん
07/05/16 11:15:06
INPUT_ENCODING は 1.5.2 で追加されてる。
VB 使いが言う shif-jis は cp932 が正解だろうな。
425:423
07/05/16 11:21:47
>>424
情報THX。ちょっとリビジョン上げてくるわ。
426:423
07/05/16 11:50:37
がーん、未だcygwin版がリリースされてなかったw
#RedHatNetworkは1.3.9.1のままだし。
今回(1.5.2)の変更点はUTF-8対応のほか、C++/CLI対応だとか随分Win使い寄りのような。
件のinput_encodigやdoxyfile_encodingが追加されたと同時にuse_windows_encodingが無くなったようなので、
私のところでは進行中のプロジェクトのDoxyfileをいくつか修正する必要がありそうです。
#逆に、rtfとtexのencodingをわざわざ変えなくて済むようになるなら嬉しいけれど。
427:デフォルトの名無しさん
07/05/16 23:22:19
1.5.1 と 1.5.2 の間で互換性を失ってるのは甚だ遺憾。
428:421
07/05/17 02:03:27
会社から書き込めないので遅くなりましたが、
>>422様の仰るとおり
INPUT_ENCODING=Shift_JIS
input-encoding=C:\vbfiltervbfilter.bat C:vbfilter\tools
にして見た所VBのソースが文字化けせず正常に出力される事が確認できました。
ありがとうございました。
と言うかこんな事に気付かない俺ってダメすぎですorz
的確な突っ込みありがとうございました。
429:デフォルトの名無しさん
07/05/17 10:27:21
つーか、それでも書き間違える(写し間違える)辺りがなんとも。
430:デフォルトの名無しさん
07/06/21 11:08:45
今まで特にコメントのスタイルとか自分では決めず
コメントを書いてきたんだけど、やっぱりそれじゃ
後から見てばらばらで気持ち悪いので、何らかの
ドキュメント自動生成ツールに従った形で書こうと思っています。
doxygen / javadoc / phpdocumentor などのツールが
あるようですが、書式はそれぞれ異なるんですよね？
スレタイに doxygen / javadoc / phpdocumentor とかの文字列が
なかったから検索に手間取っちゃったよ・・・
431:デフォルトの名無しさん
07/06/25 10:46:20
DoxygenにはJavadoc互換モードがあるからどっちかにあわせておけばいいんじゃない?
#phpのは知らない。
432:デフォルトの名無しさん
07/06/25 12:22:53
>>430
その3つなら、PHPとJava使うときはそれぞれの、他はDoxygenでいいんじゃね。
433:デフォルトの名無しさん
07/06/25 20:30:05
sandcastleでC++用のものも作れるんでしょうか？
434:デフォルトの名無しさん
07/07/06 01:22:50
doxygen(Ver1.5.2)とHTML Help Workshopを使って、
Windowsヘルプを 作成しているのですが、索引が
どうしても文字化けしてしまいます。
INPUT_ENCODING = Shift-JIS
DOXYFILE_ENCODING =UTF-8
と設定し、ページに関しては文字化けは解消された
のですが… 何か解決策があれば教えてください
435:デフォルトの名無しさん
07/07/28 08:38:52
doxygen 1.5.3 age
436:デフォルトの名無しさん
07/08/12 01:05:32
>>430
doxygen ではよくこの書き方が紹介されているが、個人的にあまりおすすめしない。
/*!
@brief メソッドの説明
@param p 引数の説明
@return 戻り値の説明
*/
・複数行コメントは一括コメントアウトの邪魔になるから
・実コードで引数が変更になると Doxygen の内容も変更しなくちゃいけなくなるから
（つまりコードと Doxygen の２重管理になる）
437:436
07/08/12 01:08:05
じゃあどうやるかというと
//! @brief メソッドの説明
//! @return 戻り値の説明
void hoge(
p //!< p の説明
)
{ ... }
438:デフォルトの名無しさん
07/08/12 01:46:25
Doxygenは警告吐くんだからちゃんとチェックすりゃいいやん。
>437のやり方だってコードとコメント両方メンテすんのはかわらん。多少近くなるが。
あと長い説明を入れにくくなるな。
439:437
07/08/12 01:55:50
>>438
> あと長い説明を入れにくくなるな。
う゛、鋭いな。
440:439
07/08/12 01:56:36
重ね重ねすまん、間違えて age てしまった
441:デフォルトの名無しさん
07/08/12 02:30:53
おれが昔立てたスレが上がってるな。
おまえら、ドキュメントなんて書きたくなきゃ書かんでいいぞ。
例えばWindowsにはヘルプがあるだろう。
けど、WindowsのGUIは洗練されてるから、あんなの読まなくても判るよな。
判らん奴もいるが、どうせそいつらはヘルプの読み方すら判らんアホだし、
付き合うだけ無駄だろう、と。こういった無茶な主張も今や世間が味方だ。
つまりウィンドウの操作なんて、もはや一般常識なのだ。凄い時代になった。
この概念を突き進めていけば、ユーザーはプログラムの画面を見れば、
何をすべきなのか判るという事だ。洗練されたGUIによって、プログラムと、
ドキュメントは融合を果たしたわけだ。
画面見て使い方が判らないプログラムはゴミと同じ。(これはGNU製に多い)
いや、むしろ今の時代は判らないとのたまう人間の方が、立場は下なのだ。
「ドキュメント見なくても判ります」
おまえら、この言葉を吐く自信はあるか？
442:デフォルトの名無しさん
07/08/12 02:56:38
>>441
GNU の作った GUI 製品って、何かあったっけ？
443:デフォルトの名無しさん
07/08/12 04:59:50
>>441
> WindowsのGUIは洗練されてるから
笑うところですか？
444:デフォルトの名無しさん
07/08/12 05:11:08
いちいち人に聞かないと笑うところも判らない、と。
445:デフォルトの名無しさん
07/08/12 13:51:49
>>437
void hoge( //! @return 戻り値の説明
ついでにここまでやろう
446:デフォルトの名無しさん
07/08/12 13:53:32
>>441
どこ立て読み？
447:デフォルトの名無しさん
07/08/12 16:57:19
＞＞４４２
ＧＴＫ＋
448:デフォルトの名無しさん
07/08/12 17:46:54
>>447
それは GUI 製品とは言わんだろ。
画面見ただけで GTK+ の使い方がわかったら神だな。
449:デフォルトの名無しさん
07/08/12 21:34:45
Glade
Sylpheed
450:デフォルトの名無しさん
07/08/12 22:09:55
>>449
そいつらは GPL でライセンスされてるだけで GNU 製とは言わんのじゃないか？
もしかして >>1 や >>441 の言ってる GNU 製ってのは GPL でライセンスされてる
製品ってこと？それなら作者もバラバラなはずだから、ただの偏見だね。
451:デフォルトの名無しさん
07/08/12 22:44:33
>>441
見ただけで処理がわかるとか
どんだけ紙プログラマなのｗ
ユーザがそんなに凄けりゃ俺たち要らない子だよね（・ω・
452:デフォルトの名無しさん
07/08/12 22:49:21
GNU製ってったらGIMPは？
あれはフォトショのコピーUIな気もするが。
453:デフォルトの名無しさん
07/08/12 23:10:29
つってもGIMPがもとでGTKが生まれたわけだが
今更Cでオブジェクト指向ゴッコかよ
と思わないでもない
454:デフォルトの名無しさん
07/08/12 23:44:15
仮にライブラリのインターフェースをC++にしたとして、
使う人間の方にしわ寄せがくる。DLLにしたくてもABIの問題もあるし。
COMやQTは難解すぎる。
C++はプログラマのフロントエンドとしてのみ使うべきだろう。
455:デフォルトの名無しさん
07/08/12 23:49:25
GNUか忘れたけど、OpenGLなUNIXのライブラリで、
失敗すると勝手にexitやabortするアホなのがあった。
勝手に終わらすなや。straceなかったら死んでた。
456:デフォルトの名無しさん
07/08/13 01:11:07
wxD
457:デフォルトの名無しさん
07/08/13 12:02:32
話を戻そう。
>>436
＞・複数行コメントは一括コメントアウトの邪魔になるから
一括コメントアウトってなに?
ソース管理の原則からは、不使用コードは#ifで囲ってしまうべきであり/* */や//は使うべきではない。
まして、基本的にリリース時には残さないべきなので、複数行コメントを忌避する理由はないと思う。
458:デフォルトの名無しさん
07/08/13 22:07:06
ソース「管理」の原則からは、ね。
でも実際に集中して作業してるときって /* */ 使わないか？
#if #endif より入力しやすいと思うんだが。
ついでに、古いコーディング規約が改定されずに使われる場合、
「VSS でチェックインするソースには原則として /**/ を含まないこと」
みたいな決まりが未だにまかり通る現場もあるんでは？（←ウチだけか？）
>> // は使うべきではない。
おまえんとこは１行コメントも #if なの？
459:デフォルトの名無しさん
07/08/13 22:11:15
>>458
/**/を使ってはならないという規則で/**/でコメントアウトするのは
ナンセンスな気がするが……
もっと言うと、/**/でコメントアウトするときに障害になるから
/**/を使うなということか
あまりにナンセンスすぎて意味がよくわからないな
460:デフォルトの名無しさん
07/08/13 22:24:42
>>459
こんな些細なネタで話を伸ばしたくないんだが。
/**/ は作業中のみ一時的な目的に使うべし、
チームメンバーに公開するソースからは /**/ 無くすべし、
当然使わないコードは消すべし、
一時的に残すなら #if ～ #endif を使うべし。
ということでまぁ折り合いがついてる。
それより、
>> // は使うべきではない。
> おまえんとこは１行コメントも #if なの？
についての解答が欲しい。あんまりコメント書かない習慣ってことか？
461:459
07/08/13 22:34:47
>>460
俺は上の人とは違う（はじめて書き込んだ）ので、上での話を
俺に聞かれても知らん。
俺のことを言えば、//を禁じるのも/**/を禁じるのもナンセンスにしか
思えない。
462:デフォルトの名無しさん
07/08/13 22:42:06
>>461
人違いスマソ
大人しく 457 からの回答を待つよ
463:デフォルトの名無しさん
07/08/14 00:37:35
457ではないけど、コードの無効化に//を使うなって事じゃない？
//f(a, // aのコメント
//b, // bのコメント
//c) {// cのコメント
//}
/*
f(a, // aのコメント
b, // bのコメント
c) {// cのコメント
}
*/
↑つまりこんなことするなって？（こんなことするか？）
#if 0
f(a,b,c) {
}
#endif
>>458
/* */て右手だけでシフト押したりするから入力しづらくね？
手前のキー使うから爪切ってないと辛い
#if 0
#endifのが気持ち早い
464:458
07/08/14 00:58:23
>>463
が紹介したような使い方は稀だけど、無効化した理由を添えることはあるだろう。
// int i = func();
int i = func2();
// ↑×××により○○○に変更。
/* */ の入力にシフトは使わん。テンキーについてるやつを使う。
465:デフォルトの名無しさん
07/08/14 02:00:54
#if で無効化しておいて理由をコメントで添えずにコミットすることを禁止すべきだろう。
466:458
07/08/14 10:24:32
㌧ なるほど
467:457
07/08/14 11:04:13
＞ソース管理の原則からは、不使用コードは#ifで囲ってしまうべきであり/* */や//は使うべきではない。
読み難かったかな。
不使用コードをコメントアウトする目的で、/* */や//は使うべきではないということね。
その目的で//を使うと、例えばリリース前に消したくても通常のコメントと区別がつきにくいので消し損ねかねない。
#ifならgrepでの検出も簡単だろう。
って、>465が書いているね。更には、リビジョン管理しているなら残すべき理由もないはずだが。
468:デフォルトの名無しさん
07/08/14 22:41:53
a = b;
/*
c = d;
*/
e = f;
↑こうなってるときに
/*
a = b;
/*
c = d;
*/
e = f;
*/
↑あとからこんなことする馬鹿がいるからじゃね？
469:デフォルトの名無しさん
07/08/15 03:51:34
>>468
誰に向けて書いたのか知らないがそれはコンパイルエラーだから論外
470:デフォルトの名無しさん
07/08/18 03:26:18
>>468程度でも見難いと思う程度の脳味噌ですが…
471:デフォルトの名無しさん
07/08/22 00:13:17
/* */ とか #if #endif でコメントアウトされてると、grepでコードを引っかけたときに、
それが使われているコードなのかコメント化されているコードなのかがgrepの結果からだけでは分からない。
てなわけでうちでは // だけ使うことになってる。
472:デフォルトの名無しさん
07/08/22 11:30:55
>>471
だからこそ、リリース版のソースにコメントアウトされたコードを残してはいけないのです。
473:デフォルトの名無しさん
07/08/23 01:19:20
当社では、コードを修正する際に修正前のコードをコメントアウトしてソースに残しておくことが
規則で定められてるんだけど、もしかしてレア？
474:デフォルトの名無しさん
07/08/23 01:22:00
ＳＶＮとかＣＶＳとかは？
475:デフォルトの名無しさん
07/08/23 01:50:24
>>473
いや。よくある糞規則。
476:デフォルトの名無しさん
07/08/23 05:59:57
最悪だな
477:デフォルトの名無しさん
07/08/24 01:10:24
>>473ごく普通のことです…orzｷﾀﾈｰ
478:デフォルトの名無しさん
07/08/24 10:56:27
まさか、コメントアウトされた行も含めて行数で金取ってたりしないよな。
479:デフォルトの名無しさん
07/08/24 11:33:09
行数で計算して金をとってる所なんてあるの？見たこと無い。COBOLとか？
480:デフォルトの名無しさん
07/08/24 11:46:27
>>479
Cでも未だあるらしいよ。
481:デフォルトの名無しさん
07/08/24 22:18:51
目安としてステップ数はなくても、n万行のコードって今でも言うでしょ。
482:デフォルトの名無しさん
07/08/24 22:45:51
言わない
483:デフォルトの名無しさん
07/08/25 14:35:46
某上場企業のシステムのリメイクを請け負ったけど
元のがループ使わずコピペでシコシコ行数稼いでいるプログラムがあった
マジで
484:デフォルトの名無しさん
07/09/03 22:19:04
>>479
F痛
485:デフォルトの名無しさん
07/09/04 07:28:56
テンプレートとかgenericsは敵だな。型の分だけ、コード増やせない。
486:デフォルトの名無しさん
07/10/27 18:26:59
Doxygen 1.5.4 age
487:デフォルトの名無しさん
07/10/28 13:23:14
よく、日本人は罫線をやたらと使いたがるって話があって、
たしかに、excelで、罫線使いまくったドキュメントって書くのが面倒なんだけど、
かといって、日本式のそういうドキュメントしか見たことないから、罫線なしで
かっこいいドキュメントというのが想像できません。
外国で使われてるドキュメントのサンプルみたいのを見れるところってありませんかね。
488:デフォルトの名無しさん
07/10/28 20:18:16
>>487
米のミドルウェアをいくつも使ったけど、そのへんのオープンソースのよりもショボい感じ。
オープンソースのをいくつも見ればいいと思うよ。
489:デフォルトの名無しさん
07/10/29 01:30:01
HTMLヘルプで十分て気がする
表示ソフトいらないし、ファイル1個で済むし
*NIXで見れない？
知 る か
490:デフォルトの名無しさん
07/10/29 02:08:39
>489
つURLﾘﾝｸ(xchm.sourceforge.net)
491:デフォルトの名無しさん
07/10/29 12:29:28
>>487
罫線を使わないこととExcelを使わないことはイコールではないよ。
喩えて言えば、○×をやるのに周りを囲むか(囲こんな形)か、囲まないか(井こんな形)の違い。
492:デフォルトの名無しさん
07/12/08 03:09:44
doxygenで更新履歴をいじった関数に書いて、
todoリストみたいにまとめたいなと思って調べたら、
\xrefitemを使えばオリジナルの\todoができることは、わかったのですが、
関連ページ追加される項目を日付ごとにまとめて並べること方法ないでしょうか?
493:492
07/12/10 02:14:40
以下のようにしてみました。
ALIASES += "history{1}=\xrefitem histories\1 \"更新履歴(\1)\" \"更新履歴(\1)\""
日付でソートできていないし、日付ごとに別ファイルになってしまいます。orz
もっとよい方法は無いでしょうか?
494:デフォルトの名無しさん
07/12/30 02:14:53
ドキュメント管理が破たんしてる業務システムの保守をやってるんだが、
・機能ごとに、仕様書があったりなかったり
・管理がずさんで、どのファイルが本物の仕様書かわからなかったり
・仕様書が現状の実装と同期がとれてなさそうだったり
てな具合。
で、どうにかせにゃアカンってことで、取り急ぎコード修正・保守作業に
最低限必要なドキュメントだけ、リバースエンジニアリングして書き起こしてる
とこなんだが、作った後の維持管理って、みんなどんな感じでやってる？
495:デフォルトの名無しさん
07/12/30 11:15:07
ソースと同じくCVS管理
496:デフォルトの名無しさん
07/12/30 17:27:36
市役所の情報システム部門に勤務している人って居る？
497:デフォルトの名無しさん
08/01/02 20:27:53
市役所のシステム部門つっても、市職員がいる「○○市情報××課」みたいな
市役所ネイティブの部署と、運用を委託されてる会社の人が常駐している実務
部隊の２通り取り方があるわけだがどっち？
498:デフォルトの名無しさん
08/01/09 12:59:45
DOXYGENだが、1.5.2以降、内部ユニコード処理になって、入力ファイルと
出力ファイルのエンコード指定ができるようになっているのはいいんだ
けど、言語とエンコードの指定に関係なく生成されたHTMLのヘッダ部分
は、「charset=UTF-8"」なんだが、ガイシュツ？
ブラウザ側のエンコード自動識別のおかげでHTMLドキュメントはうまく
表示できるが、HTML Help CompilerでHTML Helpファイルに変換すると、
インデックス部分の日本語が化ける。
499:デフォルトの名無しさん
08/01/09 16:53:47
生成されたindex.hhcのエンコーディングをUTF-8からCP932(ShiftJIS)に変換して、
hhc.exe index.hhpでおｋ
500:498
08/01/09 19:45:11
>>499
それじゃあ、ツールを使って自動化する意味ないじゃん。
他にも、index.hhpでのフォント指定やら変で、特に1.5.x以降を使う
メリットが見当たらないので、結局1.4.7に戻した。1.4.7は、Japanese
選択しとくと、「charset="SHIFT_JIS"」になる。
HTML Help をコンパイルする前にフォントを変更しても、Doxygenで生成
されるソースコードのページのフォントが変なんだよね。どうもアルファ
ベット部分だけ、無条件にArialになってるっぽい。
501:499
08/01/10 02:54:40
自分はHTMLとPDFを生成できるようにnmake用のMakefile作って自動化してるんだが。
ツール側の対応に頼るのもいいけどさ。
502:デフォルトの名無しさん
08/01/10 06:10:22
すいません、あるWindowsアプリ(制御系)のドキュメントを
作成するよう指示がありました。
ちなみに開発環境はTurboC++。
C++の知識レベルは、入門書１冊読んだ程度。（アプリ開発経験なし）
Doxygen使ってみたのですが、Doxygen対応コメントで作成されてないので
クラス階層とか関数呼出などの図ではイメージできるのですが、
コメントがないので、やってることがさっぱりわかりません。
そういう場合は、やはり、ソース解読しながら、
Doxygen対応コメントをひたすら打ち込むことから始めるべき
なのでしょうか？
503:デフォルトの名無しさん
08/01/10 07:58:38
アプリのなんだからDoxygen関係ないじゃん
504:デフォルトの名無しさん
08/01/11 14:48:40
Doxygen用のコメントを作るには、ある程度解析が必要だから方針としては悪くないと思うよ。
でも、そこで要求されている「アプリのドキュメント」はDoxygenの出力でいいの?
通常はその括りだと基本仕様か機能仕様に類する資料が必要になってくると思うのだけど。
505:デフォルトの名無しさん
08/02/10 21:43:34
Doxygen 1.5.5 release age
506:デフォルトの名無しさん
08/02/11 11:45:18
Doxygen 1.5.6 release age
507:デフォルトの名無しさん
08/02/11 12:09:51
ちょっとまて
ここはDoxygenスレじゃないんだぜ
508:デフォルトの名無しさん
08/02/12 14:02:50
だからといってDoxygen等の各ツール専用スレを建てると
このスレもそのスレも今まで以上に過疎るからやめてほしいぜ
509:デフォルトの名無しさん
08/02/12 14:42:19
いや個々のツールの使い方はかなり無関係だろこのスレ
510:デフォルトの名無しさん
08/02/12 14:47:10
保守代わりってことでいいと思う
511:デフォルトの名無しさん
08/02/12 15:06:37
一ヶ月も放置されてたスレに、自分の意にそぐわないレスが二つ付いただけで
噛み付く奴って何なの？
512:デフォルトの名無しさん
08/02/12 15:33:25
問題は時系列ではなく内容である
「1ヶ月ぶりのレスだから何書いても許す」というほうが不条理
513:デフォルトの名無しさん
08/02/12 15:35:41
不条理もへったくれもないだろ。スレ違いと言うほど外れた内容じゃないんだから。
敢えて>509の言うように「個々のツールの使い方」は無関係だとしても、「個々のツールの情報」は無関係じゃないだろ。
514:デフォルトの名無しさん
08/02/12 15:46:47
>>512
何書いても許すなんて言ってないだろ、ボケ
「お前の意に沿わないレス」で噛み付くなって言ってんだ
515:デフォルトの名無しさん
08/02/12 16:05:15
お前の意に沿わない「お前の意に沿わないレス」へのレスに
噛み付くなともいへり。
516:デフォルトの名無しさん
08/02/12 16:06:10
すまん、あまり面白くなかった。
517:デフォルトの名無しさん
08/02/12 16:15:09
よし、いいぞもっとやれ、もっと罵りあえ！
いいですか、↑これがどうしようもないレスという物の見本です
518:デフォルトの名無しさん
08/02/12 16:17:58
まあ久しぶりににぎわってよかった。
↑これはどうかな。優等生過ぎてどうしようもない？
519:デフォルトの名無しさん
08/02/12 22:50:57
ﾄﾞｷｭﾒﾝﾄ書くのﾒﾝﾄﾞｸｾｪ・・・
そもそも何を書いていいのか分からんのだよ
520:デフォルトの名無しさん
08/02/12 23:44:47
>>519
大丈夫だ。どうせ誰も見ない。
ぐらいの気持ちで書いてまつ。
本当に皆が必要な内容ならそんな悩まなくても書けるよ。
521:デフォルトの名無しさん
08/02/13 01:27:10
「～したら期待したとおりにうごかねーぞｺﾞﾙｧ」ときた時に
「ドキュメントは読みましたか？ﾌﾌﾝ」とするために書く。
522:デフォルトの名無しさん
08/02/13 23:08:46
ソースコードにドキュメント付けするときには、
とりあえず日付を真っ先に書くようにしている。
ほかの文章は後からでも書けるけど、
こればっかりは後から思い出そうとしても思い出せない。
523:デフォルトの名無しさん
08/02/15 15:13:16
書いてすぐコミットしようよ・・・
524:デフォルトの名無しさん
08/02/16 12:59:06
>>522
ついでに天気とその日の主な事件も書いとけ
525:デフォルトの名無しさん
08/02/26 20:56:32
source code に含まれないドキュメントに数学記号使った数式を
書いたら怒られたんだが, なぜ?
526:デフォルトの名無しさん
08/02/26 23:47:14
>>525
理由も聞かなかったのか？馬鹿
527:デフォルトの名無しさん
08/02/27 00:17:20
>>526 意味がわからんとゆわれた
528:デフォルトの名無しさん
08/02/27 00:26:10
プログラマなら常識ですと言ってやりたいなｗｗｗｗ
529:デフォルトの名無しさん
08/02/27 00:26:46
>>527の意味もわからんわ馬鹿
530:デフォルトの名無しさん
08/02/27 15:40:49
>>437
俺も重複を避ける為にそう思った。
が、この文法では、@param属性(入力,出力、入出力)が付けられない。これは痛い。
従って、@paramを使わざるをえなかった。
//445
ダメだよ、それじゃ。パッと見でもおかしいし、実際 変な表示になるよ。
531:デフォルトの名無しさん
08/03/05 23:50:08
マニュアル・手順書を作るのに、使うのはWord？Excel？
俺はExcel派。
Word使うヤツの気が知れない。
要するに、あとで文章直すときに改行がExcelだと
大変だってだけの話でしょ？
レイアウトは断然Excel優位だよね。
532:デフォルトの名無しさん
08/03/05 23:52:51
まだEXCEL使い奴いるんだな
533:デフォルトの名無しさん
08/03/06 09:04:30
つられませんから。
でもスタイル指定しないWordはひょっとしたら
確かにExcelよりクソかもしれない。
534:デフォルトの名無しさん
08/03/06 16:21:43
まあ、Excelの方が向いてるドキュメントはあるわな。
535:デフォルトの名無しさん
08/03/07 01:26:50
>>531
> マニュアル・手順書
にかぎるんだったら, エディタで書いた平テキスト
エンドユーザー向けのマニュアルは別部門が作る
図面ほしいって言われたら、CAD 図面
# 新規ハード使う組み込み系の仕事がほとんどだが
536:デフォルトの名無しさん
08/03/12 18:34:18
ここはdoxygenスレじゃない事は分かっているのですが・・・ちょっと質問。
関数仕様書を作るのにdoxygenを使おうとしています。 ver1.5.5を使っている
のですが、HTML出力は上手くいくものの、rtf出力になるとUTF-8でエンコード
されていて、テキストエディタでは日本語が読めるのですが、Wordやワードパッド
では文字化けして読めません。これではRTF出力する意味がありません。
DoxyWizardでは出力、入力ともShift-JISに設定しているのですが・・・(当然、
ソースのコメントはShift-JISです)
一体何がいけないのでしょうか？
537:デフォルトの名無しさん
08/03/12 21:54:59
SHIFT-JIS
↓
SHIFT_JIS
538:536
08/03/13 09:27:00
SHIFT_JISにはなっていました。エンコード設定の所にカーソル合わせると
「gnuのlibiconv使ってるからそこのページ見ろや」みたいな表示が出るので
そこを見てコピペしたからだと思います。
HTMLはちゃんと表示出来るのにRTFがダメなのが良く分かりません。
539:デフォルトの名無しさん
08/03/13 13:50:29
CP932は試した？
540:536
08/03/14 18:08:47
CP932でもダメのようです。
どうも、エンコード方式を指定するバージョンでは全てダメのようで。
具体的には1.5.2からはダメ。
仕方ないので1.5.1以前を使おうかと思います。ソースいじってなんとかする
スキルはないし。
あと、ついでにもう気づいた事。@paramコマンドで[in][out]表示が出来ますが、
HTMLでは問題ないものの、RTFでは何故か表示できません。
なぜRTFにこだわるかと言うと、提出物としてはHTMLよりもWord文書の方が良い
のではないかという事です。RTFならそのままwordで読めるし、DOCに直すにしても
ほとんど手直しの必要がないですからね。
まぁ、Word出力するなら商用ツール使えって事なのかなぁ・・・でも、ウチの会社
そんなに余裕ないし。
541:デフォルトの名無しさん
08/03/14 20:30:26
defaultcharsetと合ってないor設定されていないんじゃないかな
542:デフォルトの名無しさん
08/03/24 11:25:04
>>536
うちじゃどうしても日本語が必要なときはTeXで出して、pdfに落として提出した。
そうでないときは、全部英語にしておいた。
そうか、1.5.1ならRTFに日本語を出せたのか……
543:デフォルトの名無しさん
08/04/07 23:38:23
ソースにdoxygenのコメントのテンプレートを挿入してくれるツールって無いですか？
たとえば
int f(int x)
{
…
}
というソースがあったら
/*!
*
* @param x
* @return
*/
int func(int x)
{
…
}
のような感じでコメントを挿入してくれるとありがたいです。
544:デフォルトの名無しさん
08/04/12 21:56:16
>>543
よし、売ろう
545:デフォルトの名無しさん
08/04/13 16:41:20
>>543
Visual Studioでの開発ならマクロ組めば出来るんじゃないかな
546:デフォルトの名無しさん
08/04/28 19:31:50
ネットワークプロトコル説明するのに、状態遷移図書いて提出したら
「意味がわからん！！！ 書き直してこい！！！」
と言われてしまったんだが、おまえらどうやって説明してますか？
# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
547:デフォルトの名無しさん
08/04/28 19:34:27
>>546
＞# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
説明文をだらだらと長く書きすぎたんじゃない？
548:デフォルトの名無しさん
08/04/28 19:42:13
だったら図だけで分かってほしかったよorz
これじゃわからんって言うから、書き足していったらこうなった
どう説明すりゃいいんだ？
縦線ひいて斜め矢印か？
例外だらけになるやないか！！！
549:デフォルトの名無しさん
08/04/28 19:46:17
>>548
怒られたのに何がダメだったのか聞いてはないの？
550:デフォルトの名無しさん
08/04/28 19:50:19
>>548
箇条書きにした？
551:デフォルトの名無しさん
08/04/28 19:51:26
>>549
もっと詳しく書けっていったから詳しく書いたんだが、ついでに数式まで交えて…
「例をだせや！！！」っても、「はじめてなんでありません」と…
552:デフォルトの名無しさん
08/04/28 19:52:27
>>545
そういえば、VSってソース解析する上にマクロからアクセスできるんだったな。
ドキュメント自動生成マクロなんかあってもよさそうなのにな。
何とか工房がそうなのか？
553:デフォルトの名無しさん
08/04/28 20:10:39
>>551
相手が理解できない点を、推測じゃなくて、ちゃんとヒアリングするのは無理なのか?
あと、説明するときは、いきなり本物じゃなくて、ミニマムセットで理解できるかどうか確認するとか。
そこらへんにギャップがあると、「それじゃわからん」vs「ではどう書けと」の対決になるような希ガス。
554:デフォルトの名無しさん
08/04/28 21:32:33
プロトコルなんだから、シーケンス図？（自分対相手でメッセージを線で表現した奴）も
必要なんじゃない？
555:デフォルトの名無しさん
08/04/28 22:06:01
自分<-- メッセージ -->相手
こうかｗ
556:デフォルトの名無しさん
08/04/28 23:24:10
通信プロトコルならシーケンス図がいいんじゃないか？
状態遷移図と突き合わせできるように書けばOK
557:デフォルトの名無しさん
08/04/28 23:33:37
>>556
しかし、シーケンス図だと条件分岐がすごく書きにくくない?
558:デフォルトの名無しさん
08/04/29 01:20:36
パターン別に何種類か書いたらよかろうが