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
パターン別に何種類か書いたらよかろうが
559:デフォルトの名無しさん
08/04/29 01:28:42
組み合わせ爆発しなきゃそれでいいかもしれんが……。
560:デフォルトの名無しさん
08/04/29 12:28:52
プロトコルってのは「やりとりの規約」だかんな
やりとりに出てくるもの全てを図に入れて，なおかつどんなやり取りが行われるのかを書かないといけないんでないかい？
でもヒアリング一発ですみそう
561:デフォルトの名無しさん
08/04/29 12:46:13
rfcでも参考にして書けばいいんでない？
562:546
08/04/29 14:38:51
>>561
RFC を参考にしてではなく RFC 提出できるくらいまじめに書いた
だけど、定義してるのはプロトコルなんで
「実装する奴が理解でない！！！」
結局, フローチャート書きまくりだとか数式無しだとかじゃないと
駄目らしい
だけどさ、状態遷移図をコーディングレベルに落すのは
「あんたらの仕事じゃねぇの？？？」 >>25才位のクライアントの担当者
# つか、ステートマシンとか習わかったのか？
563:デフォルトの名無しさん
08/04/29 14:57:59
>>562
もしかして日本語がやばいんじゃないか？
564:546
08/04/29 15:12:04
>>563
おぉ、そうかもしれん ＞俺の日本語 Www
だれどさ、院出てから、10年以上この業界に巣食ってるけど、
いままでお目にかかったことがない ＞こんなクライアント
565:デフォルトの名無しさん
08/04/29 15:23:28
クライアントは何屋さん？
566:546
08/04/29 15:44:01
>>565
今まで、地方自治体外郭団体向けに事務処理ソフト作って{る|た}会社
>>564 書く直前に
「理工系の知り合いに聞いたら、うちが悪かった」
って，電話入ってきた。
まぁ、>>564 ただの愚痴だし、確に、俺も悪かった思うが………
こんなに、言語の差があるもんなのか？
567:デフォルトの名無しさん
08/04/29 16:41:31
とりあえず日本語でおｋ
568:デフォルトの名無しさん
08/04/29 16:46:09
まぁ、独自プロトコルを定義した仕様書を今まで見たことないんだろうね。
いつまでも自分流儀でやって、愚痴たれながしとけばいいよ。
569:デフォルトの名無しさん
08/04/30 00:07:17
事務処理オンリーだった会社じゃ通じなくても不思議はない。
不思議はないが不甲斐ないな、そこ。
570:デフォルトの名無しさん
08/04/30 02:15:31
>>543
VS2005ならDoxyCommentがいいんじゃね
書式もカスタマイズできるし
571:デフォルトの名無しさん
08/04/30 02:52:52
正直、ドキュメントが読めない
ＤＢの構成とか設計書とか。
「読んだら分かる」っていつも言われるんだけど、
どうしたらいいかな。
572:デフォルトの名無しさん
08/04/30 03:18:04
>>571
落ち着いてジックリ読んでみな。
573:デフォルトの名無しさん
08/04/30 10:43:42
>>566
そう言う所は、得てして「うちはどこそこの仕事をしているんだ」って妙な自負があるから
こっちが何を書いてもクレームつけるよ。謝罪の電話があっただけでもましな方かも。
# うっかりしていると、同じドキュメントを「概要」と「詳細」と「解説」の3バージョン作る羽目になったり。
574:デフォルトの名無しさん
08/04/30 13:11:38
これはいい勉強になるスレ
575:デフォルトの名無しさん
08/05/01 21:02:41
>>571
ドキュメントは読めるようになったほうがいいよ。人に
頼ることなく進む力がぐんと増える。(ドキュメントに
頼る時点で、というのは無しで)
どうしたらいいかと言われると解答に困るんだけど、
日頃から疑問に思ったことがあれば、まずドキュメントに
目を通すという習慣をつけてみたらどうだろう。
java でプログラミングしてて分からないことがあったら
まず javadoc を当たってみて、それでも分からなければ
ぐぐってみたりとか。
ツールのインストールの時も、まずは付属ドキュメント
(README, INSTALL みたいなやつ) に目を通すとか。
576:デフォルトの名無しさん
08/05/02 10:31:47
それ、「～ほうがいいよ」ってレベルじゃなくて、「～できなきゃダメ」のレベルだと思う。
577:デフォルトの名無しさん
08/05/03 13:36:57
>>546
遷移図は全体を出さずに、
ほげをするとBになります
A→B
ここでげほをするとCになります
A→B→C
ここでほれをするとAになり、やりなおしできます
A→B→C┐
←─┘
まあなんだ、たぶん図は崩れたと思うけど、インクリメンタルに
説明と共に図を成長させると理解してもらいやすい。
パワポのアニメで説明するとわかったきになるのに、
紙に出した同じ資料がわかりにくいのも同じ理由だと思う。
578:デフォルトの名無しさん
08/05/06 04:58:29
>>572
>>575
遅くなったけど、ありがとう。
疑問を持ったら人に聞くクセをなくすように
がんばります。
579:デフォルトの名無しさん
08/05/08 17:47:02
今度開発の仕事やらせてもらう事になりました。
その前に勉強として、仕様書作ってプログラム作れって上司から
言われました。
プログラムは作ったことあるんですが、仕様書なんて作ったことありません。
常識的に考えたら、基本設計書、概要設計書、コード設計書とか全部作るべきでしょうか？
580:デフォルトの名無しさん
08/05/08 20:27:21
上 司 に 聞 け
581:579
08/05/08 23:52:12
>>580
言葉足らずですみません。
仕様書って何の事か聞いたんですが、自由に作っていいって言われたんです。
自由に作れと言われたら基本的な概要、機能とか画面構成など書けば仕様書としては
成り立つんだと思うんですが、いかんせん初めての経験なのでどのように書いたらいいか
わからないんですよね。
社会人の常識として設計書の本読んで基本設計書、概要設計書
など全ての設計書を作るのが妥当なのかという質問です。
582:デフォルトの名無しさん
08/05/09 00:08:07
単なる練習プログラムなんだから概要からでいいんじゃね
583:デフォルトの名無しさん
08/05/09 03:44:01
上司乙ｗ
584:デフォルトの名無しさん
08/05/09 08:08:02
>>581
疲れたので途中で止めとくけど、こんな感じで読める読み物を作ればおけ。
ゴールの定義
・どういう背景があり（どういう歴史があり何で困っていたのか）
・何を実現したいと考えています（作ったものを使うことで得られると期待される効果のこと）
・このために何々をするものを作ることにしました
全体構造
・大きな制約条件として～がある中で（納期、コスト、現状からくる技術�%A
585:デフォルトの名無しさん
08/05/09 08:09:41
あれ？途中で切れてしまった・・・
書き直すもの疲れたので諦めるすまん>>581
586:デフォルトの名無しさん
08/05/09 09:40:43
骨組みでこの程度がわかれば良い。
・なんで作ったのか
・それを使ってどういう効果が期待できるか
・必要とする環境
・入力は何か
・出力は何か
競合するプログラムが既にある場合を除いて、
最初はどういう機能がとか、画面が云々とかは不要。
必要だといわれたら付け足していけば良いはず。
読む側にとってどうでもよさそうな事は極力避ける事。
つーか多分作ったのを後で添削するのが
意図なわけだから、あまり時間掛けると嫌われるぞ。
587:581
08/05/09 16:21:25
>>586
入力、出力ってどういう意味ですか？
A4用紙一枚にまとめるのは変でしょうか？
588:デフォルトの名無しさん
08/05/09 16:40:36
>>587
入力も出力もないプログラムは役に立たないだろう
記述が必要十分なら一文字にまとまっていても構わないぞ
589:581
08/05/09 17:00:35
>>588
もしデータベースを扱うプログラムだったら、
どのようなデータを登録して（入力）、どのような形で表示するか（出力）
簡単に言えばこのような事でしょうか？
590:デフォルトの名無しさん
08/05/09 20:04:08
電卓のイメージなら簡単だろ？
ユーザーが入力して、プログラムがそれを計算する。（出力）
591:デフォルトの名無しさん
08/05/10 01:11:34
上司から言われたことの真の目的を明確にして、その目的を達成するためのプロセスや成果物を決めたらどうだろうか？
社会人の常識とかじゃなくて、目的から考えた方がよいのでは
592:デフォルトの名無しさん
08/05/10 10:46:22
クラスの仕様の概要って、どこまでが概要ですか？
593:デフォルトの名無しさん
08/05/10 10:52:50
>>592
クラス仕様の詳細じゃない部分
594:デフォルトの名無しさん
08/05/10 11:23:40
>>592
・そのクラスの責任範囲と全体の中での役割
・超簡単なサンプル使用例
・データの流れと関与する主要APIを図示したもの（ポイントとなるクラスの場合）
これが１ページで欲しい所。
595:デフォルトの名無しさん
08/05/26 16:40:33
doxygenについて質問したいのですが、専用スレが無いようなのでこちらでさせてください。
PC:Windows XP
コンパイル方法:Visual Studio 2005のコマンドプロンプト上で、下記の命令をする
make msvc
C:\doxygen1.5.5 に doxygen1.5.5.src.tar.gz を解凍した中身を置きました。
C:\doxygen1.5.5\src のソースをいじって、コンパイルしましたがエラーが出てしまいます。
エラー内容
----
link /NOLOGO /LIBPATH:..\lib /SUBSYSTEM:console /OUT:..\bin\doxygen.exe
@C:\DOCUME~1\AA\LOCALS~1\Temp\nm2E.tmp
～
doxycfg.lib(portable.obj) : error LNK2019: 未解決の外部シンボル __imp__libiconv_open が関数 "void * __cdecl portable_iconv_open(char const *,char const *)" (?portable_iconv_open@@YAPAXPBD0@Z) で参照されました。
～
..\bin\doxygen.exe : fatal error LNK1120: 外部参照 5 が未解決です。
NMAKE : fatal error U1077: 'link' : リターン コード '0x460'
----
doxygenのソースのコンパイルは、下記以外に必要なものはありますか？
・Active perl
・GnuWin32のFlex
・Qt
・VC2005
・Microsoft Platform SDK
596:デフォルトの名無しさん
08/05/26 17:33:49
libiconvって書いてあるじゃん。
エラーメッセージぐらい読めるようになったら？
597:595
08/05/26 18:28:33
>>596
ありがとうございます。
iconv.lib,iconv.hがdoxygenのソース内に入っていたのでこれで良いのかと思っていました。
Libiconvをコンパイルしたものと差し替えたら、コンパイルが通過して下記ファイルが出来ました。
doxygen.exe
doxytag.exe
598:ura2ch.czsoftbank219174032071.bbtec.neta.net
08/05/26 18:33:08
guest/guest
599:デフォルトの名無しさん
08/05/28 23:41:27
開発の人間なら仕様書を云々言う前に
ソース内のコメントをちゃんと書け！
と思う、インフラ屋は俺だけではないはず。
特にリリース後の修正箇所に対して正確な
コメントが書かれているソースが本当に少ない。
頼むから引数のコメントくらい、まともに書いてくれ・・・・
600:デフォルトの名無しさん
08/05/30 04:18:14
変数名自体を説明にするしかない
601:デフォルトの名無しさん
08/05/30 13:08:41
システムハンガリアンを止めて、アプリケーションハンガリアンにする。
602:デフォルトの名無しさん
08/05/31 00:23:06
>>599
> 特にリリース後の修正箇所に対して正確な
> コメントが書かれているソースが本当に少ない。
これはコミットログやChangeLogの役目だろう
603:デフォルトの名無しさん
08/05/31 13:13:14
> これはコミットログやChangeLogの役目だろう
ソース内のロジックとコメントは分業してるってこと？
ロジックとそのコメント内容が一致してないから
障害対応してるときに頭からソースを読まなければ
ならないってこと。
そして、修正したPGはすでにいないことが多い・・・・
604:デフォルトの名無しさん
08/05/31 17:32:04
コメントとソースを同じくらい価値があるものだと考えるのはいいが
コメントとソースを同じように扱ってはいけないだろ
605:デフォルトの名無しさん
08/05/31 18:51:02
そこまでコメントに期待してないよ。
ただ最初にも書いたけど、表題部の
プログラム名や用途、引数説明すら
まともに書いてないソースが多すぎる
からカキコしただけだ
606:デフォルトの名無しさん
08/05/31 19:19:50
doxyの1.5.6でツリーが文字化けするのって俺だけ？
1.5.5平気なんだけど
607:デフォルトの名無しさん
08/05/31 21:19:45
４コマ漫画で８００ページの取扱い説明書
608:デフォルトの名無しさん
08/05/31 22:24:13
>>603
> 特にリリース後の修正箇所に対して正確な
> コメントが書かれているソースが本当に少ない。
これは 「こう修正しました」 っていうコメントのことでしょ？
それはまさにコミットログ等の役割
コードからは読み取れない 「こういう処理です」 っていうのがコメントの役割だと思う
609:デフォルトの名無しさん
08/06/01 01:34:08
>>608
"「こう修正しました」"は
ソース内の修正(変更)履歴のことを言ってる。
610:デフォルトの名無しさん
08/06/01 01:53:13
>>609
そりゃあSCMがない時代の苦肉の策でしょ
611:デフォルトの名無しさん
08/06/01 09:06:34
>>609
バージョン管理使おうぜ
612:デフォルトの名無しさん
08/06/01 11:47:08
>610,611
今、休出でVSS見てるけど、コミットログやChangeLogは存在しない。
各ソースのチェックインコメントは全部一緒で"○○○○更改に対する修正"・・・・
ほかに見るとこあれば教えてくれ。
（インフラ側で作ってる基盤モジュールのアップデート履歴のほうが
詳細に記載している。）
613:デフォルトの名無しさん
08/06/01 17:35:45
>>612
履歴を残そうという意識が作業者に無ければコミットログにも残るわけ無いだろ。
お前んとこのローカルな事情だな、それは。
で、一般的に履歴を残すんならどっちかというとコミットログのほうが適切という話。
614:デフォルトの名無しさん
08/06/01 17:43:21
>>612
コミットログはチェックインコメントと同じ意味
ツールが違うと用語が違う
チェックインコメントが全部一緒だと無意味だと感じませんか？
チェックインコメントは修正内容を記録するのにうってつけだと思いませんか？
615:デフォルトの名無しさん
08/06/01 17:49:07
ソースに履歴コメントされても探すのが大変だし。同時に変更したファイルの関連や前後関係も把握するのも正確に記載するのも困難。
コミットログならすぐ探し出せる。コメント漏れがあっても差分を見つけられる。
コミットログに情報がないというのは、結局コメントの入れ方、運用の問題でしょ。
616:デフォルトの名無しさん
08/06/01 19:27:14
ソースが動かないというのは、結局プログラムの書き方、プログラミングの問題でしょ
みたいな感じに見えた
617:デフォルトの名無しさん
08/06/02 15:25:20
【コメント】doxygen【コンソメ】
ｽﾚﾘﾝｸ(tech板)
618:デフォルトの名無しさん
08/07/27 04:43:22
doxygenの話題は禁止
619:デフォルトの名無しさん
08/08/23 14:10:15
URLﾘﾝｸ(www.hotdocument.net)
じゃだめかな。
620:デフォルトの名無しさん
08/08/23 18:05:57
これはひどい
621:デフォルトの名無しさん
08/11/17 15:02:59
doxygen,hotdocument,visio
どれがいいだろうか・・・
C++Builder2007なんだけど。どれ対応してるかもまだ調べてないんだ。
とりあえず・・・探すか。