良いドキュメント・マニュアル・仕様書を書くスレ

[表示 : 全て最新50 1-99 101- 201- 301- 401- 501- 601- 2chのread.cgiへ]
Update time : 11/06 07:03 / Filesize : 155 KB / Number-of Response : 622
[このスレッドの書き込みを削除する]
[＋板最近立ったスレ＆熱いスレ一覧 : ＋板最近立ったスレ／記者別一覧] [類似スレッド一覧]


↑キャッシュ検索、類似スレ動作を修正しました、ご迷惑をお掛けしました

1 名前：デフォルトの名無しさん [03/10/05 23:34]: おまえら、自分で作ったプログラムについての、わかりやすく的確な
ドキュメントを書ける自信はあるか？
仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、
マニュアルや、仕様書などのドキュメントを書く機会は必ずある。

プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない
プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。
ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。
だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？

いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、
実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い)
読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。
プログラムに対するドキュメントを、ちゃんとした１作品として、
後世に残せるよう努力すべきだろう。

今一度問う。
おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？
392 名前：こんなもんかな mailto:sage [2007/03/13(火) 10:29:20 ]: 仕様
速記に適し、それなりの耐久性を有すること。
ある程度の耐候性があればインクの種類は問わないが、掠れ難いこと。
393 名前：デフォルトの名無しさん mailto:sage [2007/03/13(火) 10:52:47 ]: [要求]
字が書けること
394 名前：デフォルトの名無しさん mailto:sage [2007/03/13(火) 23:51:25 ]: >>392
そっちのが要求じゃないの

あっこれマジレスってやつかっ？
395 名前：デフォルトの名無しさん mailto:sage [2007/03/14(水) 00:16:56 ]: 「要件」は何？
396 名前：デフォルトの名無しさん mailto:sage [2007/03/14(水) 00:48:48 ]: 要件定義書 ver0.00

- 普通紙に字が書けること
- インクの補充が容易であること
- 出来うる限りメンテナンスフリーであること

以上の要求を実現する筆記用具を開発することにより、ユーザーの利便性を高め
生産性の向上に（以下省略

＞以上の要求を実現する筆記用具を開発することにより、ユーザーの利便性を高め
＞生産性の向上に（以下省略
↑この辺が要件。
397 名前：デフォルトの名無しさん mailto:sage [2007/03/14(水) 01:06:54 ]: ttp://www.atmarkit.co.jp/farc/rensai/lookingfor04/lookingfor04a.html

少なくとも日本IBMでは区別してるようだな。
IEEEでは単にSoftware/System Requirements Speciticationであって、
区別してないようだな。
398 名前：デフォルトの名無しさん mailto:sage [2007/03/14(水) 01:19:00 ]: 俺もIだけど、要求しか使わないよ。
上の例で挙げられているような仕様書は、
今どきコボラーくらいしか書かないんじゃないかな。
399 名前：デフォルトの名無しさん mailto:sage [2007/03/14(水) 04:30:05 ]: 要望と要求と要件は微妙に違うという意見もある

要望は客が単に思ってること
要求はシステム上不可欠なこと
要件は実装するシステム機能

ま、いちいち分類したところで、結局ドキュメントを書かないもれには関係ない話だｗ
400 名前：デフォルトの名無しさん mailto:sage [2007/03/15(木) 00:34:54 ]: 要件とは顧客の要望や要求を日本語に文章化したものではないかと思います。。。

その意味じゃ>>396の言ってる事がしっくりくるｗ
401 名前：デフォルトの名無しさん mailto:sage [2007/03/15(木) 17:05:37 ]: management textでいうプロジェクトリーダーの理解＝要件
ってこと？
402 名前：デフォルトの名無しさん [2007/03/18(日) 15:15:13 ]: プログラム単体レベルで考えると、破綻する。
システム全体を見据え、ドキュメントを体系化すべし。
富士通だと、SDAS
ttp://img.jp.fujitsu.com/downloads/jp/jmag/vol57-1/paper01.pdf

NEC、日立も似たようなもん持ってる。（どれが良いとかはシラン）
孫会社、下請けは知らないかもしれないが、本尊の動きくらい知っときなょ。
403 名前：デフォルトの名無しさん [2007/03/18(日) 21:26:20 ]: 俺の考えは、

マニュアル　→　専門のテクニカルライターを使う
設計書　　　→　システム全体が見渡せるもの／外部仕様はしっかり書く。
　　　　　　　　内部仕様はほどほど。（結局ソースが正になるから）

ドキュメントが無いソフトは糞とかいうけど、
ドキュメントが無いと保守できないソフトこそ糞だと思う今日この頃だよ。
404 名前：デフォルトの名無しさん mailto:sage [2007/03/18(日) 23:12:23 ]: 全体の概要とか外部仕様、内部仕様を区別せず、
一口にドキュメントの是非を問うから議論が分かれる気が。

>>403 が言うとおり、
システム全体像・外部仕様はしっかり、
内部仕様はソースが正、doxygen とかで自動生成
って言えば、あんまり反対する人いないと思うんだけど。
405 名前：デフォルトの名無しさん mailto:sage [2007/03/18(日) 23:15:45 ]: マーケティング部門向けの仕様書って
開発用と別に書いて渡してますか？
406 名前：デフォルトの名無しさん mailto:sage [2007/03/19(月) 00:49:55 ]: >>404
内部仕様書でも、分業単位の分まではきっしり作っておこう
407 名前：デフォルトの名無しさん mailto:sage [2007/03/19(月) 04:40:13 ]: >>403
上場企業だと、内部統制の関係で全てキッチリ必要
408 名前：デフォルトの名無しさん [2007/03/27(火) 23:59:41 ]: unmanagedとmanagedのコードが混在したアセンブリのドキュメントってdoxygenで出力できますか？
CVSに入ってるdoxygenだとCPP_CLI_SUPPORTという設定が使えるみたいなんだけど
409 名前：デフォルトの名無しさん mailto:sage [2007/03/28(水) 09:19:09 ]: >>407
上場企業というより、メーカー系の企業だな。
やつらは工場で作るものとソフトウェアを同じ体系にまとめようとするからムリがある。
上場企業でもソフトハウス系はそんなことない。
410 名前：デフォルトの名無しさん mailto:sage [2007/03/28(水) 12:50:41 ]: >>409
でも、工場で作るものと同じ仕様で仕様書を作っておくと
何年後でも開発者が死んだあとでもメンテが出来たりするので
あなどれないんだよな
411 名前：デフォルトの名無しさん mailto:sage [2007/03/28(水) 18:55:58 ]: 小さな会社が手がけるレベルの開発じゃそこまでライフサイクル長くない…
412 名前：デフォルトの名無しさん mailto:sage [2007/03/29(木) 09:16:07 ]: あって役にたつのは、外部仕様書と内部実装の理解を助けるための簡単なドキュメントだな。
それ以上細かい内部仕様書は糞。
思うに、本当の内部仕様書ってのはソースコード自身だと思う。
413 名前：デフォルトの名無しさん mailto:sage [2007/03/29(木) 11:35:18 ]: >>412
それじゃバグがあっても仕様通りぢゃあないか
414 名前：デフォルトの名無しさん mailto:sage [2007/03/29(木) 11:50:55 ]: そうそう、大抵納品後数年経ってから発覚するような(必ずしもバグでない)不具合があったときに
一番役立つのがソースコードとソース内にきちんと書かれたコメントなんだよね。
尤も、それらがきちんと書かれていないコードに限って後から不具合が露見するんだが。
で、ついでに言えばそういうプロジェクトは大抵仕様書に仕様変更がきちんと反映されていないから仕様書は手掛かりにしからない罠。
415 名前：デフォルトの名無しさん mailto:sage [2007/03/29(木) 12:14:21 ]: 勝手に転載

979 名前：デフォルトの名無しさん [sage] 投稿日： 2007/03/29(木) 10:14:13
処理Aの仕様書
・・・Aを実行する。

１行きたー。どうしよう。
416 名前：デフォルトの名無しさん [2007/03/29(木) 23:41:27 ]: 良いDQNなんていません
417 名前：デフォルトの名無しさん [2007/04/05(木) 13:28:09 ]: Doxygen 1.5.2 age

UTF-8 ｷﾀ
418 名前：デフォルトの名無しさん mailto:sage [2007/04/14(土) 22:07:50 ]: 要件定義書とか設計書とかのフォーマットはダウンロードできるとこありますか？
書籍でも良いです
419 名前：デフォルトの名無しさん mailto:sage [2007/04/14(土) 22:33:19 ]: RFP本とUML設計本くらいしか知らない。

実務資料はふつープロジェクト外秘や社外秘だから
必要なら会社で見せてもらえ
420 名前：デフォルトの名無しさん mailto:sage [2007/04/14(土) 22:35:59 ]: ためしに設計書フォーマットでググったら、
見覚えあるプロジェクトの公開資料が出てきてびっくらこいたｗ
421 名前：デフォルトの名無しさん mailto:sage [2007/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 名前：デフォルトの名無しさん mailto:sage [2007/05/16(水) 06:57:14 ]: >>421
ソースが shift-jis だってんなら INPUT_ENCODING=Shift_JIS だろ。
423 名前：デフォルトの名無しさん mailto:sage [2007/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 名前：デフォルトの名無しさん mailto:sage [2007/05/16(水) 11:15:06 ]: INPUT_ENCODING は 1.5.2 で追加されてる。
VB 使いが言う shif-jis は cp932 が正解だろうな。
425 名前：423 mailto:sage [2007/05/16(水) 11:21:47 ]: >>424
情報THX。ちょっとリビジョン上げてくるわ。
426 名前：423 mailto:sage [2007/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 名前：デフォルトの名無しさん mailto:sage [2007/05/16(水) 23:22:19 ]: 1.5.1 と 1.5.2 の間で互換性を失ってるのは甚だ遺憾。
428 名前：421 mailto:sage [2007/05/17(木) 02:03:27 ]: 会社から書き込めないので遅くなりましたが、
>>422様の仰るとおり
INPUT_ENCODING=Shift_JIS
input-encoding=C:\vbfiltervbfilter.bat C:vbfilter\tools
にして見た所VBのソースが文字化けせず正常に出力される事が確認できました。
ありがとうございました。

と言うかこんな事に気付かない俺ってダメすぎですorz
的確な突っ込みありがとうございました。
429 名前：デフォルトの名無しさん mailto:sage [2007/05/17(木) 10:27:21 ]: つーか、それでも書き間違える(写し間違える)辺りがなんとも。
430 名前：デフォルトの名無しさん [2007/06/21(木) 11:08:45 ]: 今まで特にコメントのスタイルとか自分では決めず
コメントを書いてきたんだけど、やっぱりそれじゃ
後から見てばらばらで気持ち悪いので、何らかの
ドキュメント自動生成ツールに従った形で書こうと思っています。
doxygen / javadoc / phpdocumentor などのツールが
あるようですが、書式はそれぞれ異なるんですよね？

スレタイに doxygen / javadoc / phpdocumentor とかの文字列が
なかったから検索に手間取っちゃったよ・・・
431 名前：デフォルトの名無しさん mailto:sage [2007/06/25(月) 10:46:20 ]: DoxygenにはJavadoc互換モードがあるからどっちかにあわせておけばいいんじゃない?
#phpのは知らない。
432 名前：デフォルトの名無しさん mailto:sage [2007/06/25(月) 12:22:53 ]: >>430
その3つなら、PHPとJava使うときはそれぞれの、他はDoxygenでいいんじゃね。
433 名前：デフォルトの名無しさん mailto:sage [2007/06/25(月) 20:30:05 ]: sandcastleでC++用のものも作れるんでしょうか？
434 名前：デフォルトの名無しさん mailto:sage [2007/07/06(金) 01:22:50 ]: doxygen(Ver1.5.2)とHTML Help Workshopを使って、
Windowsヘルプを作成しているのですが、索引が
どうしても文字化けしてしまいます。
INPUT_ENCODING = Shift-JIS
DOXYFILE_ENCODING =UTF-8
と設定し、ページに関しては文字化けは解消された
のですが… 何か解決策があれば教えてください
435 名前：デフォルトの名無しさん [2007/07/28(土) 08:38:52 ]: doxygen 1.5.3 age
436 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 01:05:32 ]: >>430
doxygen ではよくこの書き方が紹介されているが、個人的にあまりおすすめしない。
/*!
@brief メソッドの説明
@param p 引数の説明
@return 戻り値の説明
*/
・複数行コメントは一括コメントアウトの邪魔になるから
・実コードで引数が変更になると Doxygen の内容も変更しなくちゃいけなくなるから
　（つまりコードと Doxygen の２重管理になる）
437 名前：436 mailto:sage [2007/08/12(日) 01:08:05 ]: じゃあどうやるかというと

//! @brief メソッドの説明
//! @return 戻り値の説明
void hoge(
p //!< p の説明
)
{ ... }
438 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 01:46:25 ]: Doxygenは警告吐くんだからちゃんとチェックすりゃいいやん。
>437のやり方だってコードとコメント両方メンテすんのはかわらん。多少近くなるが。
あと長い説明を入れにくくなるな。
439 名前：437 mailto:age [2007/08/12(日) 01:55:50 ]: >>438
> あと長い説明を入れにくくなるな。
う゛、鋭いな。
440 名前：439 mailto:sage [2007/08/12(日) 01:56:36 ]: 重ね重ねすまん、間違えて age てしまった
441 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 02:30:53 ]: おれが昔立てたスレが上がってるな。

おまえら、ドキュメントなんて書きたくなきゃ書かんでいいぞ。
例えばWindowsにはヘルプがあるだろう。
けど、WindowsのGUIは洗練されてるから、あんなの読まなくても判るよな。
判らん奴もいるが、どうせそいつらはヘルプの読み方すら判らんアホだし、
付き合うだけ無駄だろう、と。こういった無茶な主張も今や世間が味方だ。
つまりウィンドウの操作なんて、もはや一般常識なのだ。凄い時代になった。
この概念を突き進めていけば、ユーザーはプログラムの画面を見れば、
何をすべきなのか判るという事だ。洗練されたGUIによって、プログラムと、
ドキュメントは融合を果たしたわけだ。
画面見て使い方が判らないプログラムはゴミと同じ。(これはGNU製に多い)
いや、むしろ今の時代は判らないとのたまう人間の方が、立場は下なのだ。
「ドキュメント見なくても判ります」
おまえら、この言葉を吐く自信はあるか？
442 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 02:56:38 ]: >>441
GNU の作った GUI 製品って、何かあったっけ？
443 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 04:59:50 ]: >>441
> WindowsのGUIは洗練されてるから

笑うところですか？
444 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 05:11:08 ]: いちいち人に聞かないと笑うところも判らない、と。
445 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 13:51:49 ]: >>437
void hoge( //! @return 戻り値の説明
ついでにここまでやろう
446 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 13:53:32 ]: >>441
どこ立て読み？
447 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 16:57:19 ]: ＞＞４４２
ＧＴＫ＋
448 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 17:46:54 ]: >>447
それは GUI 製品とは言わんだろ。

画面見ただけで GTK+ の使い方がわかったら神だな。
449 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 21:34:45 ]: Glade
Sylpheed
450 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 22:09:55 ]: >>449
そいつらは GPL でライセンスされてるだけで GNU 製とは言わんのじゃないか？

もしかして >>1 や >>441 の言ってる GNU 製ってのは GPL でライセンスされてる
製品ってこと？それなら作者もバラバラなはずだから、ただの偏見だね。
451 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 22:44:33 ]: >>441
見ただけで処理がわかるとか
どんだけ紙プログラマなのｗ
ユーザがそんなに凄けりゃ俺たち要らない子だよね（・ω・
452 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 22:49:21 ]: GNU製ってったらGIMPは？
あれはフォトショのコピーUIな気もするが。
453 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 23:10:29 ]: つってもGIMPがもとでGTKが生まれたわけだが
今更Cでオブジェクト指向ゴッコかよ
と思わないでもない
454 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 23:44:15 ]: 仮にライブラリのインターフェースをC++にしたとして、
使う人間の方にしわ寄せがくる。DLLにしたくてもABIの問題もあるし。
COMやQTは難解すぎる。
C++はプログラマのフロントエンドとしてのみ使うべきだろう。
455 名前：デフォルトの名無しさん mailto:sage [2007/08/12(日) 23:49:25 ]: GNUか忘れたけど、OpenGLなUNIXのライブラリで、
失敗すると勝手にexitやabortするアホなのがあった。
勝手に終わらすなや。straceなかったら死んでた。
456 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 01:11:07 ]: wxD
457 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 12:02:32 ]: 話を戻そう。

>>436
＞・複数行コメントは一括コメントアウトの邪魔になるから
一括コメントアウトってなに?

ソース管理の原則からは、不使用コードは#ifで囲ってしまうべきであり/* */や//は使うべきではない。
まして、基本的にリリース時には残さないべきなので、複数行コメントを忌避する理由はないと思う。
458 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:07:06 ]: ソース「管理」の原則からは、ね。

でも実際に集中して作業してるときって /* */ 使わないか？
#if #endif より入力しやすいと思うんだが。
ついでに、古いコーディング規約が改定されずに使われる場合、
「VSS でチェックインするソースには原則として /**/ を含まないこと」
みたいな決まりが未だにまかり通る現場もあるんでは？（←ウチだけか？）

>> // は使うべきではない。
おまえんとこは１行コメントも #if なの？
459 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:11:15 ]: >>458
/**/を使ってはならないという規則で/**/でコメントアウトするのは
ナンセンスな気がするが……
もっと言うと、/**/でコメントアウトするときに障害になるから
/**/を使うなということか

あまりにナンセンスすぎて意味がよくわからないな
460 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:24:42 ]: >>459
こんな些細なネタで話を伸ばしたくないんだが。

/**/ は作業中のみ一時的な目的に使うべし、
チームメンバーに公開するソースからは /**/ 無くすべし、
当然使わないコードは消すべし、
一時的に残すなら #if ～ #endif を使うべし。
ということでまぁ折り合いがついてる。

それより、
>> // は使うべきではない。
> おまえんとこは１行コメントも #if なの？
についての解答が欲しい。あんまりコメント書かない習慣ってことか？
461 名前：459 mailto:sage [2007/08/13(月) 22:34:47 ]: >>460
俺は上の人とは違う（はじめて書き込んだ）ので、上での話を
俺に聞かれても知らん。
俺のことを言えば、//を禁じるのも/**/を禁じるのもナンセンスにしか
思えない。
462 名前：デフォルトの名無しさん mailto:sage [2007/08/13(月) 22:42:06 ]: >>461
人違いスマソ
大人しく 457 からの回答を待つよ
463 名前：デフォルトの名無しさん mailto:sage [2007/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 mailto:sage [2007/08/14(火) 00:58:23 ]: >>463
が紹介したような使い方は稀だけど、無効化した理由を添えることはあるだろう。

// int i = func();
int i = func2();
// ↑×××により○○○に変更。

/* */ の入力にシフトは使わん。テンキーについてるやつを使う。
465 名前：デフォルトの名無しさん mailto:sage [2007/08/14(火) 02:00:54 ]: #if で無効化しておいて理由をコメントで添えずにコミットすることを禁止すべきだろう。
466 名前：458 mailto:sage [2007/08/14(火) 10:24:32 ]: ㌧　なるほど
467 名前：457 mailto:sage [2007/08/14(火) 11:04:13 ]: ＞ソース管理の原則からは、不使用コードは#ifで囲ってしまうべきであり/* */や//は使うべきではない。
読み難かったかな。
不使用コードをコメントアウトする目的で、/* */や//は使うべきではないということね。
その目的で//を使うと、例えばリリース前に消したくても通常のコメントと区別がつきにくいので消し損ねかねない。
#ifならgrepでの検出も簡単だろう。

って、>465が書いているね。更には、リビジョン管理しているなら残すべき理由もないはずだが。
468 名前：デフォルトの名無しさん mailto:sage [2007/08/14(火) 22:41:53 ]: a = b;
/*
c = d;
*/
e = f;

↑こうなってるときに

/*
a = b;
/*
c = d;
*/
e = f;
*/

↑あとからこんなことする馬鹿がいるからじゃね？
469 名前：デフォルトの名無しさん mailto:sage [2007/08/15(水) 03:51:34 ]: >>468
誰に向けて書いたのか知らないがそれはコンパイルエラーだから論外
470 名前：デフォルトの名無しさん [2007/08/18(土) 03:26:18 ]: >>468程度でも見難いと思う程度の脳味噌ですが…
471 名前：デフォルトの名無しさん mailto:sage [2007/08/22(水) 00:13:17 ]: /* */ とか #if #endif でコメントアウトされてると、grepでコードを引っかけたときに、
それが使われているコードなのかコメント化されているコードなのかがgrepの結果からだけでは分からない。
てなわけでうちでは // だけ使うことになってる。
472 名前：デフォルトの名無しさん mailto:sage [2007/08/22(水) 11:30:55 ]: >>471
だからこそ、リリース版のソースにコメントアウトされたコードを残してはいけないのです。
473 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:19:20 ]: 当社では、コードを修正する際に修正前のコードをコメントアウトしてソースに残しておくことが
規則で定められてるんだけど、もしかしてレア？
474 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:22:00 ]: ＳＶＮとかＣＶＳとかは？
475 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 01:50:24 ]: >>473
いや。よくある糞規則。
476 名前：デフォルトの名無しさん mailto:sage [2007/08/23(木) 05:59:57 ]: 最悪だな
477 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 01:10:24 ]: >>473ごく普通のことです…orzｷﾀﾈｰ
478 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 10:56:27 ]: まさか、コメントアウトされた行も含めて行数で金取ってたりしないよな。
479 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 11:33:09 ]: 行数で計算して金をとってる所なんてあるの？見たこと無い。COBOLとか？
480 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 11:46:27 ]: >>479
Cでも未だあるらしいよ。
481 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 22:18:51 ]: 目安としてステップ数はなくても、n万行のコードって今でも言うでしょ。
482 名前：デフォルトの名無しさん mailto:sage [2007/08/24(金) 22:45:51 ]: 言わない
483 名前：デフォルトの名無しさん mailto:sage [2007/08/25(土) 14:35:46 ]: 某上場企業のシステムのリメイクを請け負ったけど
元のがループ使わずコピペでシコシコ行数稼いでいるプログラムがあった
マジで
484 名前：デフォルトの名無しさん mailto:sage [2007/09/03(月) 22:19:04 ]: >>479
F痛
485 名前：デフォルトの名無しさん mailto:sage [2007/09/04(火) 07:28:56 ]: テンプレートとかgenericsは敵だな。型の分だけ、コード増やせない。
486 名前：デフォルトの名無しさん [2007/10/27(土) 18:26:59 ]: Doxygen 1.5.4 age
487 名前：デフォルトの名無しさん [2007/10/28(日) 13:23:14 ]: よく、日本人は罫線をやたらと使いたがるって話があって、
たしかに、excelで、罫線使いまくったドキュメントって書くのが面倒なんだけど、
かといって、日本式のそういうドキュメントしか見たことないから、罫線なしで
かっこいいドキュメントというのが想像できません。

外国で使われてるドキュメントのサンプルみたいのを見れるところってありませんかね。
488 名前：デフォルトの名無しさん mailto:sage [2007/10/28(日) 20:18:16 ]: >>487
米のミドルウェアをいくつも使ったけど、そのへんのオープンソースのよりもショボい感じ。
オープンソースのをいくつも見ればいいと思うよ。
489 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 01:30:01 ]: HTMLヘルプで十分て気がする
表示ソフトいらないし、ファイル1個で済むし
*NIXで見れない？
知　る　か
490 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 02:08:39 ]: >489
つttp://xchm.sourceforge.net/
491 名前：デフォルトの名無しさん mailto:sage [2007/10/29(月) 12:29:28 ]: >>487
罫線を使わないこととExcelを使わないことはイコールではないよ。
喩えて言えば、○×をやるのに周りを囲むか(囲こんな形)か、囲まないか(井こんな形)の違い。
492 名前：デフォルトの名無しさん mailto:sage [2007/12/08(土) 03:09:44 ]: doxygenで更新履歴をいじった関数に書いて、
todoリストみたいにまとめたいなと思って調べたら、
\xrefitemを使えばオリジナルの\todoができることは、わかったのですが、
関連ページ追加される項目を日付ごとにまとめて並べること方法ないでしょうか?
493 名前：492 mailto:sage [2007/12/10(月) 02:14:40 ]: 以下のようにしてみました。

ALIASES += "history{1}=\xrefitem histories\1 \"更新履歴(\1)\" \"更新履歴(\1)\""

日付でソートできていないし、日付ごとに別ファイルになってしまいます。orz
もっとよい方法は無いでしょうか?
494 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 02:14:53 ]: ドキュメント管理が破たんしてる業務システムの保守をやってるんだが、

・機能ごとに、仕様書があったりなかったり
・管理がずさんで、どのファイルが本物の仕様書かわからなかったり
・仕様書が現状の実装と同期がとれてなさそうだったり

てな具合。
で、どうにかせにゃアカンってことで、取り急ぎコード修正・保守作業に
最低限必要なドキュメントだけ、リバースエンジニアリングして書き起こしてる
とこなんだが、作った後の維持管理って、みんなどんな感じでやってる？
495 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 11:15:07 ]: ソースと同じくCVS管理
496 名前：デフォルトの名無しさん mailto:sage [2007/12/30(日) 17:27:36 ]: 市役所の情報システム部門に勤務している人って居る？
497 名前：デフォルトの名無しさん mailto:sage [2008/01/02(水) 20:27:53 ]: 市役所のシステム部門つっても、市職員がいる「○○市情報××課」みたいな
市役所ネイティブの部署と、運用を委託されてる会社の人が常駐している実務
部隊の２通り取り方があるわけだがどっち？
498 名前：デフォルトの名無しさん [2008/01/09(水) 12:59:45 ]: DOXYGENだが、1.5.2以降、内部ユニコード処理になって、入力ファイルと
出力ファイルのエンコード指定ができるようになっているのはいいんだ
けど、言語とエンコードの指定に関係なく生成されたHTMLのヘッダ部分
は、「charset=UTF-8"」なんだが、ガイシュツ？

ブラウザ側のエンコード自動識別のおかげでHTMLドキュメントはうまく
表示できるが、HTML Help CompilerでHTML Helpファイルに変換すると、
インデックス部分の日本語が化ける。
499 名前：デフォルトの名無しさん mailto:sage [2008/01/09(水) 16:53:47 ]: 生成されたindex.hhcのエンコーディングをUTF-8からCP932(ShiftJIS)に変換して、
hhc.exe index.hhpでおｋ
500 名前：498 [2008/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 mailto:sage [2008/01/10(木) 02:54:40 ]: 自分はHTMLとPDFを生成できるようにnmake用のMakefile作って自動化してるんだが。
ツール側の対応に頼るのもいいけどさ。
502 名前：デフォルトの名無しさん [2008/01/10(木) 06:10:22 ]: すいません、あるWindowsアプリ(制御系)のドキュメントを
作成するよう指示がありました。
ちなみに開発環境はTurboC++。
C++の知識レベルは、入門書１冊読んだ程度。（アプリ開発経験なし）
Doxygen使ってみたのですが、Doxygen対応コメントで作成されてないので
クラス階層とか関数呼出などの図ではイメージできるのですが、
コメントがないので、やってることがさっぱりわかりません。
そういう場合は、やはり、ソース解読しながら、
Doxygen対応コメントをひたすら打ち込むことから始めるべき
なのでしょうか？
503 名前：デフォルトの名無しさん mailto:sage [2008/01/10(木) 07:58:38 ]: アプリのなんだからDoxygen関係ないじゃん
504 名前：デフォルトの名無しさん mailto:sage [2008/01/11(金) 14:48:40 ]: Doxygen用のコメントを作るには、ある程度解析が必要だから方針としては悪くないと思うよ。
でも、そこで要求されている「アプリのドキュメント」はDoxygenの出力でいいの?
通常はその括りだと基本仕様か機能仕様に類する資料が必要になってくると思うのだけど。
505 名前：デフォルトの名無しさん [2008/02/10(日) 21:43:34 ]: Doxygen 1.5.5 release age
506 名前：デフォルトの名無しさん [2008/02/11(月) 11:45:18 ]: Doxygen 1.5.6 release age
507 名前：デフォルトの名無しさん mailto:sage [2008/02/11(月) 12:09:51 ]: ちょっとまて
ここはDoxygenスレじゃないんだぜ
508 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:02:50 ]: だからといってDoxygen等の各ツール専用スレを建てると
このスレもそのスレも今まで以上に過疎るからやめてほしいぜ
509 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:42:19 ]: いや個々のツールの使い方はかなり無関係だろこのスレ
510 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 14:47:10 ]: 保守代わりってことでいいと思う
511 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:06:37 ]: 一ヶ月も放置されてたスレに、自分の意にそぐわないレスが二つ付いただけで
噛み付く奴って何なの？
512 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:33:25 ]: 問題は時系列ではなく内容である
「1ヶ月ぶりのレスだから何書いても許す」というほうが不条理
513 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:35:41 ]: 不条理もへったくれもないだろ。スレ違いと言うほど外れた内容じゃないんだから。
敢えて>509の言うように「個々のツールの使い方」は無関係だとしても、「個々のツールの情報」は無関係じゃないだろ。
514 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 15:46:47 ]: >>512
何書いても許すなんて言ってないだろ、ボケ
「お前の意に沿わないレス」で噛み付くなって言ってんだ
515 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:05:15 ]: お前の意に沿わない「お前の意に沿わないレス」へのレスに
噛み付くなともいへり。
516 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:06:10 ]: すまん、あまり面白くなかった。
517 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:15:09 ]: よし、いいぞもっとやれ、もっと罵りあえ！

いいですか、↑これがどうしようもないレスという物の見本です
518 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 16:17:58 ]: まあ久しぶりににぎわってよかった。

↑これはどうかな。優等生過ぎてどうしようもない？
519 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 22:50:57 ]: ﾄﾞｷｭﾒﾝﾄ書くのﾒﾝﾄﾞｸｾｪ・・・
そもそも何を書いていいのか分からんのだよ
520 名前：デフォルトの名無しさん mailto:sage [2008/02/12(火) 23:44:47 ]: >>519
大丈夫だ。どうせ誰も見ない。

ぐらいの気持ちで書いてまつ。
本当に皆が必要な内容ならそんな悩まなくても書けるよ。
521 名前：デフォルトの名無しさん mailto:sage [2008/02/13(水) 01:27:10 ]: 「～したら期待したとおりにうごかねーぞｺﾞﾙｧ」ときた時に
「ドキュメントは読みましたか？ﾌﾌﾝ」とするために書く。
522 名前：デフォルトの名無しさん mailto:sage [2008/02/13(水) 23:08:46 ]: ソースコードにドキュメント付けするときには、
とりあえず日付を真っ先に書くようにしている。

ほかの文章は後からでも書けるけど、
こればっかりは後から思い出そうとしても思い出せない。
523 名前：デフォルトの名無しさん mailto:sage [2008/02/15(金) 15:13:16 ]: 書いてすぐコミットしようよ・・・
524 名前：デフォルトの名無しさん mailto:sage [2008/02/16(土) 12:59:06 ]: >>522
ついでに天気とその日の主な事件も書いとけ
525 名前：デフォルトの名無しさん [2008/02/26(火) 20:56:32 ]: source code に含まれないドキュメントに数学記号使った数式を
書いたら怒られたんだが, なぜ?
526 名前：デフォルトの名無しさん mailto:sage [2008/02/26(火) 23:47:14 ]: >>525
理由も聞かなかったのか？馬鹿
527 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:17:20 ]: >>526 意味がわからんとゆわれた
528 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:26:10 ]: プログラマなら常識ですと言ってやりたいなｗｗｗｗ
529 名前：デフォルトの名無しさん mailto:sage [2008/02/27(水) 00:26:46 ]: >>527の意味もわからんわ馬鹿
530 名前：デフォルトの名無しさん [2008/02/27(水) 15:40:49 ]: >>437
俺も重複を避ける為にそう思った。
が、この文法では、@param属性(入力,出力、入出力)が付けられない。これは痛い。
従って、@paramを使わざるをえなかった。

//445
ダメだよ、それじゃ。パッと見でもおかしいし、実際変な表示になるよ。
531 名前：デフォルトの名無しさん [2008/03/05(水) 23:50:08 ]: マニュアル・手順書を作るのに、使うのはWord？Excel？

俺はExcel派。
Word使うヤツの気が知れない。

要するに、あとで文章直すときに改行がExcelだと
大変だってだけの話でしょ？

レイアウトは断然Excel優位だよね。
532 名前：デフォルトの名無しさん mailto:sage [2008/03/05(水) 23:52:51 ]: まだEXCEL使い奴いるんだな
533 名前：デフォルトの名無しさん mailto:sage [2008/03/06(木) 09:04:30 ]: つられませんから。

でもスタイル指定しないWordはひょっとしたら
確かにExcelよりクソかもしれない。
534 名前：デフォルトの名無しさん mailto:sage [2008/03/06(木) 16:21:43 ]: まあ、Excelの方が向いてるドキュメントはあるわな。
535 名前：デフォルトの名無しさん [2008/03/07(金) 01:26:50 ]: >>531
> マニュアル・手順書
にかぎるんだったら, エディタで書いた平テキスト
エンドユーザー向けのマニュアルは別部門が作る
図面ほしいって言われたら、CAD 図面

# 新規ハード使う組み込み系の仕事がほとんどだが
536 名前：デフォルトの名無しさん mailto:sage [2008/03/12(水) 18:34:18 ]: ここはdoxygenスレじゃない事は分かっているのですが・・・ちょっと質問。

関数仕様書を作るのにdoxygenを使おうとしています。 ver1.5.5を使っている
のですが、HTML出力は上手くいくものの、rtf出力になるとUTF-8でエンコード
されていて、テキストエディタでは日本語が読めるのですが、Wordやワードパッド
では文字化けして読めません。これではRTF出力する意味がありません。

DoxyWizardでは出力、入力ともShift-JISに設定しているのですが・・・(当然、
ソースのコメントはShift-JISです)

一体何がいけないのでしょうか？
537 名前：デフォルトの名無しさん mailto:sage [2008/03/12(水) 21:54:59 ]: SHIFT-JIS
↓
SHIFT_JIS
538 名前：536 mailto:sage [2008/03/13(木) 09:27:00 ]: SHIFT_JISにはなっていました。エンコード設定の所にカーソル合わせると
「gnuのlibiconv使ってるからそこのページ見ろや」みたいな表示が出るので
そこを見てコピペしたからだと思います。

HTMLはちゃんと表示出来るのにRTFがダメなのが良く分かりません。
539 名前：デフォルトの名無しさん mailto:sage [2008/03/13(木) 13:50:29 ]: CP932は試した？
540 名前：536 mailto:sage [2008/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 名前：デフォルトの名無しさん mailto:sage [2008/03/14(金) 20:30:26 ]: defaultcharsetと合ってないor設定されていないんじゃないかな
542 名前：デフォルトの名無しさん mailto:sage [2008/03/24(月) 11:25:04 ]: >>536
うちじゃどうしても日本語が必要なときはTeXで出して、pdfに落として提出した。
そうでないときは、全部英語にしておいた。
そうか、1.5.1ならRTFに日本語を出せたのか……
543 名前：デフォルトの名無しさん mailto:sage [2008/04/07(月) 23:38:23 ]: ソースにdoxygenのコメントのテンプレートを挿入してくれるツールって無いですか？
たとえば

int f(int x)
{
…
}

というソースがあったら

/*!
*
* @param x
* @return
*/
int func(int x)
{
…
}

のような感じでコメントを挿入してくれるとありがたいです。
544 名前：デフォルトの名無しさん mailto:sage [2008/04/12(土) 21:56:16 ]: >>543
よし、売ろう
545 名前：デフォルトの名無しさん mailto:sage [2008/04/13(日) 16:41:20 ]: >>543
Visual Studioでの開発ならマクロ組めば出来るんじゃないかな
546 名前：デフォルトの名無しさん [2008/04/28(月) 19:31:50 ]: ネットワークプロトコル説明するのに、状態遷移図書いて提出したら
「意味がわからん！！！書き直してこい！！！」
と言われてしまったんだが、おまえらどうやって説明してますか？

# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
547 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:34:27 ]: >>546
＞# 一応、説明文は遷移図一枚につき5ページくらいは書いたんだが…
説明文をだらだらと長く書きすぎたんじゃない？
548 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:42:13 ]: だったら図だけで分かってほしかったよorz

これじゃわからんって言うから、書き足していったらこうなった

どう説明すりゃいいんだ？
縦線ひいて斜め矢印か？
例外だらけになるやないか！！！
549 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:46:17 ]: >>548
怒られたのに何がダメだったのか聞いてはないの？
550 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:50:19 ]: >>548
箇条書きにした？
551 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 19:51:26 ]: >>549
もっと詳しく書けっていったから詳しく書いたんだが、ついでに数式まで交えて…
「例をだせや！！！」っても、「はじめてなんでありません」と…
552 名前：デフォルトの名無しさん [2008/04/28(月) 19:52:27 ]: >>545
そういえば、VSってソース解析する上にマクロからアクセスできるんだったな。
ドキュメント自動生成マクロなんかあってもよさそうなのにな。
何とか工房がそうなのか？
553 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 20:10:39 ]: >>551
相手が理解できない点を、推測じゃなくて、ちゃんとヒアリングするのは無理なのか?
あと、説明するときは、いきなり本物じゃなくて、ミニマムセットで理解できるかどうか確認するとか。
そこらへんにギャップがあると、「それじゃわからん」vs「ではどう書けと」の対決になるような希ガス。
554 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 21:32:33 ]: プロトコルなんだから、シーケンス図？（自分対相手でメッセージを線で表現した奴）も
必要なんじゃない？
555 名前：デフォルトの名無しさん [2008/04/28(月) 22:06:01 ]: 自分<-- メッセージ -->相手

こうかｗ
556 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 23:24:10 ]: 通信プロトコルならシーケンス図がいいんじゃないか？
状態遷移図と突き合わせできるように書けばOK
557 名前：デフォルトの名無しさん mailto:sage [2008/04/28(月) 23:33:37 ]: >>556
しかし、シーケンス図だと条件分岐がすごく書きにくくない?
558 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 01:20:36 ]: パターン別に何種類か書いたらよかろうが
559 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 01:28:42 ]: 組み合わせ爆発しなきゃそれでいいかもしれんが……。
560 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 12:28:52 ]: プロトコルってのは「やりとりの規約」だかんな
やりとりに出てくるもの全てを図に入れて，なおかつどんなやり取りが行われるのかを書かないといけないんでないかい？
でもヒアリング一発ですみそう
561 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 12:46:13 ]: rfcでも参考にして書けばいいんでない？
562 名前：546 mailto:sage [2008/04/29(火) 14:38:51 ]: >>561
RFC を参考にしてではなく RFC 提出できるくらいまじめに書いた

だけど、定義してるのはプロトコルなんで
「実装する奴が理解でない！！！」

結局, フローチャート書きまくりだとか数式無しだとかじゃないと
駄目らしい

だけどさ、状態遷移図をコーディングレベルに落すのは
「あんたらの仕事じゃねぇの？？？」 >>25才位のクライアントの担当者

# つか、ステートマシンとか習わかったのか？
563 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 14:57:59 ]: >>562
もしかして日本語がやばいんじゃないか？
564 名前：546 mailto:sage [2008/04/29(火) 15:12:04 ]: >>563
おぉ、そうかもしれん＞俺の日本語 Www
だれどさ、院出てから、10年以上この業界に巣食ってるけど、
いままでお目にかかったことがない＞こんなクライアント
565 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 15:23:28 ]: クライアントは何屋さん？
566 名前：546 mailto:sage [2008/04/29(火) 15:44:01 ]: >>565
今まで、地方自治体外郭団体向けに事務処理ソフト作って{る|た}会社
>>564 書く直前に
「理工系の知り合いに聞いたら、うちが悪かった」
って，電話入ってきた。
まぁ、>>564 ただの愚痴だし、確に、俺も悪かった思うが………
こんなに、言語の差があるもんなのか？
567 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 16:41:31 ]: とりあえず日本語でおｋ
568 名前：デフォルトの名無しさん mailto:sage [2008/04/29(火) 16:46:09 ]: まぁ、独自プロトコルを定義した仕様書を今まで見たことないんだろうね。
いつまでも自分流儀でやって、愚痴たれながしとけばいいよ。
569 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 00:07:17 ]: 事務処理オンリーだった会社じゃ通じなくても不思議はない。
不思議はないが不甲斐ないな、そこ。
570 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 02:15:31 ]: >>543
VS2005ならDoxyCommentがいいんじゃね
書式もカスタマイズできるし
571 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 02:52:52 ]: 正直、ドキュメントが読めない
ＤＢの構成とか設計書とか。
「読んだら分かる」っていつも言われるんだけど、
どうしたらいいかな。
572 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 03:18:04 ]: >>571
落ち着いてジックリ読んでみな。
573 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 10:43:42 ]: >>566
そう言う所は、得てして「うちはどこそこの仕事をしているんだ」って妙な自負があるから
こっちが何を書いてもクレームつけるよ。謝罪の電話があっただけでもましな方かも。
# うっかりしていると、同じドキュメントを「概要」と「詳細」と「解説」の3バージョン作る羽目になったり。
574 名前：デフォルトの名無しさん mailto:sage [2008/04/30(水) 13:11:38 ]: これはいい勉強になるスレ
575 名前：デフォルトの名無しさん mailto:sage [2008/05/01(木) 21:02:41 ]: >>571
ドキュメントは読めるようになったほうがいいよ。人に
頼ることなく進む力がぐんと増える。(ドキュメントに
頼る時点で、というのは無しで)

どうしたらいいかと言われると解答に困るんだけど、
日頃から疑問に思ったことがあれば、まずドキュメントに
目を通すという習慣をつけてみたらどうだろう。

java でプログラミングしてて分からないことがあったら
まず javadoc を当たってみて、それでも分からなければ
ぐぐってみたりとか。
ツールのインストールの時も、まずは付属ドキュメント
(README, INSTALL みたいなやつ) に目を通すとか。
576 名前：デフォルトの名無しさん mailto:sage [2008/05/02(金) 10:31:47 ]: それ、「～ほうがいいよ」ってレベルじゃなくて、「～できなきゃダメ」のレベルだと思う。
577 名前：デフォルトの名無しさん mailto:sage [2008/05/03(土) 13:36:57 ]: >>546
遷移図は全体を出さずに、

　ほげをするとBになります
　A→B

　ここでげほをするとCになります
　A→B→C

　ここでほれをするとAになり、やりなおしできます
　A→B→C┐
　 ←──┘

まあなんだ、たぶん図は崩れたと思うけど、インクリメンタルに
説明と共に図を成長させると理解してもらいやすい。

パワポのアニメで説明するとわかったきになるのに、
紙に出した同じ資料がわかりにくいのも同じ理由だと思う。
578 名前：デフォルトの名無しさん mailto:sage [2008/05/06(火) 04:58:29 ]: >>572
>>575

遅くなったけど、ありがとう。
疑問を持ったら人に聞くクセをなくすように
がんばります。
579 名前：デフォルトの名無しさん [2008/05/08(木) 17:47:02 ]: 今度開発の仕事やらせてもらう事になりました。
その前に勉強として、仕様書作ってプログラム作れって上司から
言われました。
プログラムは作ったことあるんですが、仕様書なんて作ったことありません。
常識的に考えたら、基本設計書、概要設計書、コード設計書とか全部作るべきでしょうか？
580 名前：デフォルトの名無しさん mailto:sage [2008/05/08(木) 20:27:21 ]: 上　司　に　聞　け
581 名前：579 [2008/05/08(木) 23:52:12 ]: >>580
言葉足らずですみません。
仕様書って何の事か聞いたんですが、自由に作っていいって言われたんです。
自由に作れと言われたら基本的な概要、機能とか画面構成など書けば仕様書としては
成り立つんだと思うんですが、いかんせん初めての経験なのでどのように書いたらいいか
わからないんですよね。
社会人の常識として設計書の本読んで基本設計書、概要設計書
など全ての設計書を作るのが妥当なのかという質問です。
582 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 00:08:07 ]: 単なる練習プログラムなんだから概要からでいいんじゃね
583 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 03:44:01 ]: 上司乙ｗ
584 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 08:08:02 ]: >>581
疲れたので途中で止めとくけど、こんな感じで読める読み物を作ればおけ。

ゴールの定義
・どういう背景があり（どういう歴史があり何で困っていたのか）
・何を実現したいと考えています（作ったものを使うことで得られると期待される効果のこと）
・このために何々をするものを作ることにしました

全体構造
・大きな制約条件として～がある中で（納期、コスト、現状からくる技術�%A
585 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 08:09:41 ]: あれ？途中で切れてしまった・・・
書き直すもの疲れたので諦めるすまん>>581
586 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 09:40:43 ]: 骨組みでこの程度がわかれば良い。
・なんで作ったのか
・それを使ってどういう効果が期待できるか
・必要とする環境
・入力は何か
・出力は何か

競合するプログラムが既にある場合を除いて、
最初はどういう機能がとか、画面が云々とかは不要。
必要だといわれたら付け足していけば良いはず。
読む側にとってどうでもよさそうな事は極力避ける事。
つーか多分作ったのを後で添削するのが
意図なわけだから、あまり時間掛けると嫌われるぞ。
587 名前：581 [2008/05/09(金) 16:21:25 ]: >>586
入力、出力ってどういう意味ですか？
A4用紙一枚にまとめるのは変でしょうか？
588 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 16:40:36 ]: >>587
入力も出力もないプログラムは役に立たないだろう
記述が必要十分なら一文字にまとまっていても構わないぞ
589 名前：581 [2008/05/09(金) 17:00:35 ]: >>588
もしデータベースを扱うプログラムだったら、
どのようなデータを登録して（入力）、どのような形で表示するか（出力）
簡単に言えばこのような事でしょうか？
590 名前：デフォルトの名無しさん mailto:sage [2008/05/09(金) 20:04:08 ]: 電卓のイメージなら簡単だろ？
ユーザーが入力して、プログラムがそれを計算する。（出力）
591 名前：デフォルトの名無しさん mailto:sage [2008/05/10(土) 01:11:34 ]: 上司から言われたことの真の目的を明確にして、その目的を達成するためのプロセスや成果物を決めたらどうだろうか？
社会人の常識とかじゃなくて、目的から考えた方がよいのでは
592 名前：デフォルトの名無しさん [2008/05/10(土) 10:46:22 ]: クラスの仕様の概要って、どこまでが概要ですか？
593 名前：デフォルトの名無しさん mailto:sage [2008/05/10(土) 10:52:50 ]: >>592
クラス仕様の詳細じゃない部分
594 名前：デフォルトの名無しさん mailto:sage [2008/05/10(土) 11:23:40 ]: >>592
・そのクラスの責任範囲と全体の中での役割
・超簡単なサンプル使用例
・データの流れと関与する主要APIを図示したもの（ポイントとなるクラスの場合）

これが１ページで欲しい所。
595 名前：デフォルトの名無しさん [2008/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 名前：デフォルトの名無しさん mailto:sage [2008/05/26(月) 17:33:49 ]: libiconvって書いてあるじゃん。
エラーメッセージぐらい読めるようになったら？
597 名前：595 [2008/05/26(月) 18:28:33 ]: >>596
ありがとうございます。
iconv.lib,iconv.hがdoxygenのソース内に入っていたのでこれで良いのかと思っていました。
Libiconvをコンパイルしたものと差し替えたら、コンパイルが通過して下記ファイルが出来ました。
　doxygen.exe
　doxytag.exe
598 名前：ura2ch.czsoftbank219174032071.bbtec.neta.net mailto:グロ [2008/05/26(月) 18:33:08 ]: guest/guest
599 名前：デフォルトの名無しさん [2008/05/28(水) 23:41:27 ]: 開発の人間なら仕様書を云々言う前に
ソース内のコメントをちゃんと書け！

と思う、インフラ屋は俺だけではないはず。

特にリリース後の修正箇所に対して正確な
コメントが書かれているソースが本当に少ない。

頼むから引数のコメントくらい、まともに書いてくれ・・・・
600 名前：デフォルトの名無しさん mailto:sage [2008/05/30(金) 04:18:14 ]: 変数名自体を説明にするしかない
601 名前：デフォルトの名無しさん [2008/05/30(金) 13:08:41 ]: システムハンガリアンを止めて、アプリケーションハンガリアンにする。
602 名前：デフォルトの名無しさん mailto:sage [2008/05/31(土) 00:23:06 ]: >>599
> 特にリリース後の修正箇所に対して正確な
> コメントが書かれているソースが本当に少ない。

これはコミットログやChangeLogの役目だろう
603 名前：デフォルトの名無しさん [2008/05/31(土) 13:13:14 ]: > これはコミットログやChangeLogの役目だろう
ソース内のロジックとコメントは分業してるってこと？

ロジックとそのコメント内容が一致してないから
障害対応してるときに頭からソースを読まなければ
ならないってこと。
そして、修正したPGはすでにいないことが多い・・・・
604 名前：デフォルトの名無しさん [2008/05/31(土) 17:32:04 ]: コメントとソースを同じくらい価値があるものだと考えるのはいいが
コメントとソースを同じように扱ってはいけないだろ
605 名前：デフォルトの名無しさん [2008/05/31(土) 18:51:02 ]: そこまでコメントに期待してないよ。
ただ最初にも書いたけど、表題部の
プログラム名や用途、引数説明すら
まともに書いてないソースが多すぎる
からカキコしただけだ
606 名前：デフォルトの名無しさん mailto:sage [2008/05/31(土) 19:19:50 ]: doxyの1.5.6でツリーが文字化けするのって俺だけ？
1.5.5平気なんだけど
607 名前：デフォルトの名無しさん [2008/05/31(土) 21:19:45 ]: ４コマ漫画で８００ページの取扱い説明書
608 名前：デフォルトの名無しさん mailto:sage [2008/05/31(土) 22:24:13 ]: >>603
> 特にリリース後の修正箇所に対して正確な
> コメントが書かれているソースが本当に少ない。

これは「こう修正しました」っていうコメントのことでしょ？
それはまさにコミットログ等の役割
コードからは読み取れない「こういう処理です」っていうのがコメントの役割だと思う
609 名前：デフォルトの名無しさん [2008/06/01(日) 01:34:08 ]: >>608
"「こう修正しました」"は
ソース内の修正(変更)履歴のことを言ってる。
610 名前：デフォルトの名無しさん mailto:sage [2008/06/01(日) 01:53:13 ]: >>609
そりゃあSCMがない時代の苦肉の策でしょ
611 名前：デフォルトの名無しさん mailto:sage [2008/06/01(日) 09:06:34 ]: >>609
バージョン管理使おうぜ
612 名前：デフォルトの名無しさん [2008/06/01(日) 11:47:08 ]: >610,611
今、休出でVSS見てるけど、コミットログやChangeLogは存在しない。
各ソースのチェックインコメントは全部一緒で"○○○○更改に対する修正"・・・・
ほかに見るとこあれば教えてくれ。

（インフラ側で作ってる基盤モジュールのアップデート履歴のほうが
詳細に記載している。）
613 名前：デフォルトの名無しさん mailto:sage [2008/06/01(日) 17:35:45 ]: >>612
履歴を残そうという意識が作業者に無ければコミットログにも残るわけ無いだろ。
お前んとこのローカルな事情だな、それは。

で、一般的に履歴を残すんならどっちかというとコミットログのほうが適切という話。
614 名前：デフォルトの名無しさん mailto:sage [2008/06/01(日) 17:43:21 ]: >>612
コミットログはチェックインコメントと同じ意味
ツールが違うと用語が違う
チェックインコメントが全部一緒だと無意味だと感じませんか？
チェックインコメントは修正内容を記録するのにうってつけだと思いませんか？
615 名前：デフォルトの名無しさん mailto:sage [2008/06/01(日) 17:49:07 ]: ソースに履歴コメントされても探すのが大変だし。同時に変更したファイルの関連や前後関係も把握するのも正確に記載するのも困難。
コミットログならすぐ探し出せる。コメント漏れがあっても差分を見つけられる。
コミットログに情報がないというのは、結局コメントの入れ方、運用の問題でしょ。
616 名前：デフォルトの名無しさん [2008/06/01(日) 19:27:14 ]: ソースが動かないというのは、結局プログラムの書き方、プログラミングの問題でしょ
みたいな感じに見えた
617 名前：デフォルトの名無しさん mailto:sage [2008/06/02(月) 15:25:20 ]: 【コメント】doxygen【コンソメ】
pc11.2ch.net/test/read.cgi/tech/1212144627/
618 名前：デフォルトの名無しさん [2008/07/27(日) 04:43:22 ]: doxygenの話題は禁止
619 名前：デフォルトの名無しさん [2008/08/23(土) 14:10:15 ]: www.hotdocument.net/
じゃだめかな。
620 名前：デフォルトの名無しさん mailto:sage [2008/08/23(土) 18:05:57 ]: これはひどい
621 名前：デフォルトの名無しさん [2008/11/17(月) 15:02:59 ]: doxygen,hotdocument,visio

どれがいいだろうか・・・
C++Builder2007なんだけど。どれ対応してるかもまだ調べてないんだ。

とりあえず・・・探すか。

[ 新着レスの取得/表示 (agate) ] / [ 携帯版 ]

read.cgi ver5.27 [feat.BBS2 +1.6] / e.0.2 (02/09/03) / eucaly.net products.
担当:undef