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

1 名前：デフォルトの名無しさん [03/10/05 23:34] おまえら、自分で作ったプログラムについての、わかりやすく的確な ドキュメントを書ける自信はあるか？ 仕事で納品したり、他人に見せるプログラムとして公開するつもりなら、 マニュアルや、仕様書などのドキュメントを書く機会は必ずある。 プログラムとドキュメントはとても関係が深い。ドキュメントが整っていない プログラムなど、ゴミと同じ。それに、ただ書けばいいって物でもない。 ドキュメントがゴミ程の役にも立たなければ、結局それはゴミなのだ。 だらだらと書いた意味不明な文章を他人に見られるのも恥ずかしいよな？ いわばドキュメントを書く技術はプログラマの必須スキルの１つなのだが、 実際は、下手糞なドキュメントが蔓延っている。(これはGNU製に多い) 読んでも無駄とか、書いても無駄とか思ってる奴、その考えを改めろ。 プログラムに対するドキュメントを、ちゃんとした１作品として、 後世に残せるよう努力すべきだろう。 今一度問う。 おまえら、わかりやすく的確なドキュメントを書ける自信はあるか？ 357 名前：デフォルトの名無しさん [2006/06/22(木) 09:09:28 ] 1.4.7 で dot を使おうとすると FreeSans.ttf が見つからんエラーになるなorz まあ、すでに bugzilla に報告済みだから次のバージョンでは何らかの対策がされることを 期待するが。 358 名前：デフォルトの名無しさん [2006/06/22(木) 10:13:30 ] 【佐賀】サムスンSDS開発のシステム不具合で市が課税ミス　昨年度はSEがデータだけ修正して誤魔化した？ news19.2ch.net/test/read.cgi/newsplus/1150936122/l50 佐賀市は１９日、市税や住民票などを管理する市独自の基幹システムでプログラムエラーが あり、国民健康保険税に課税ミスがあったと発表した。 この基幹システムは、旧市が韓国ＩＴ大手の「サムスンＳＤＳ」と約８億７千万円で共同開発し、 ０５年４月から運用を始めた。開始直後は約５０人の同社員がエラーをチェックしていた。 市情報政策課は「昨年度もエラーはあったはずだが、データを手直ししただけで、プログラム 自体を修正しなかった可能性が高い」と話している。 359 名前：デフォルトの名無しさん mailto:sage [2006/06/29(木) 23:09:03 ] www.atmarkit.co.jp/fwin2k/itpropower/admin-kun/031/adminkun031.html 360 名前：デフォルトの名無しさん mailto:sage [2006/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 名前：デフォルトの名無しさん mailto:sage [2006/07/16(日) 19:15:50 ] >>360 その 加算double ってのは何だ？ 362 名前：デフォルトの名無しさん mailto:sage [2006/07/16(日) 19:23:54 ] タイプミスです。すみません。 /// @file test.hpp /// @brief doxygenテスト /// 加算 int add(int a, int b); /// 加算 double add(double a, double b); 363 名前：デフォルトの名無しさん [2006/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 名前：デフォルトの名無しさん mailto:sage [2006/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 名前：デフォルトの名無しさん mailto:sage [2006/07/26(水) 04:08:38 ] >>360, 362 1.4.7 で問題なく出力できた。 366 名前：デフォルトの名無しさん mailto:sage [2006/07/28(金) 01:57:06 ] DQNメント 367 名前：デフォルトの名無しさん [2006/10/18(水) 11:22:21 ] Doxygen 1.5.0 age 368 名前：デフォルトの名無しさん mailto:sage [2006/10/30(月) 01:23:57 ] doxygen 使ってますが、 > Generating caller graph for function foo という行で止まってしまいます。 いつも同じ関数の処理をしている時に止まるようです。 止まってしまう関数の処理を中断して先に進ませる方法はないでしょうか？ 369 名前：デフォルトの名無しさん [2006/10/30(月) 11:19:27 ] Doxygen 1.5.1 age 370 名前：デフォルトの名無しさん [2006/10/31(火) 00:35:52 ] doxygenだと改行が無視されて せっかく綺麗に作ったコメントがぐちゃぐちゃになるんだけど なにか対策ある？ 371 名前：デフォルトの名無しさん mailto:sage [2006/10/31(火) 00:43:23 ] >>370 <pre></pre> でどう？ 場合によっては何かもっと適切な対策があるかもしれないけど。 372 名前：デフォルトの名無しさん mailto:sage [2006/11/01(水) 00:55:01 ] \n書くとか。 漏れはもう改行を気にするのはやめたけど。 373 名前：デフォルトの名無しさん mailto:sage [2006/11/01(水) 13:48:26 ] >>370 doxygenの整形に任せるのが正解。 改行が必要なほど複雑な説明を長々とコメントに書いてはいけない。 補足説明とか引数別の説明とか例外のリストとかそういうのは それようのタグがあるのでそれを使ってdoxygenに整形させる。 374 名前：デフォルトの名無しさん mailto:sage [2006/11/11(土) 11:36:25 ] 楽にドキュメントを書ける(・∀・)ｲｲ！ツールすらないことがよくわかった。 おまいら今なら作れば売れるぞw 375 名前：デフォルトの名無しさん mailto:sage [2006/11/11(土) 12:00:06 ] 脳味噌にUSBケーブル接続して脳内仕様をダイレクトに出力できるデバイスが 発明されない限り、ドキュメント作成ツールのメガヒットはありえない。 376 名前：デフォルトの名無しさん mailto:sage [2006/11/11(土) 13:26:33 ] えーそんなの出来たら おっぱいとか満載になっちゃって大変そう。 雑念払う練習しないと。 377 名前：デフォルトの名無しさん mailto:sage [2007/01/08(月) 23:42:18 ] ソースがドキュメントとか逝ってる人、勘弁してよ。 ちょっと不思議な動きしてるんですけど、 ソースのバグなんだか、仕様なんだか、わからないよ！ と、１０年以上前に誰かが作ったソースをメンテさせられることになって 鬱状態の僕は思いました。５万行もあるよ。。 みんな、doxygen使ってるか！ ちゃんと、その関数が何やりたいのとかきちんと書いてな！ あとsunのJavadocみたいに、スレッドセーフかどうかとかも書いてあるとうれしいよ！ パッケージとかモジュールとか、ソースより大きい単位でも doxygenってドキュメント書けるの？ >>374 買うから作って。 あけましておめでとう。 378 名前：デフォルトの名無しさん [2007/03/10(土) 16:46:51 ] "要求定義" "要件定義" 同じものを違う呼び方してるだけ？ 379 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 17:25:20 ] >>378 レイヤーが違う 上位が要件、下位が要求 380 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 17:53:37 ] なるほど。 これらを区別していない書籍も多いと思ったのですが、 そんなことないでしょうか？ 381 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 17:55:28 ] 多いか少ないかなんて問題なのか？ 382 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 18:40:21 ] 学習者にとっては問題です。 それぞれ英語では何という語句にあたりますか？ 383 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 20:30:09 ] >>382 要件はマターとかファクター 要求はリクエスト 384 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 20:52:38 ] requirement... 385 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 21:02:38 ] >>384 requestもrequireも語源は同じですよ re(再び) ＋ quaerere(ラテン語で求める) 再び求める ⇒ 要求、お願い requireよりrequestの方が若干丁寧です 386 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 21:49:15 ] >>378 海外では"requirements definition"。 日本の計算機屋の言語感覚が鈍かったから、「要求」と「要件」がごっちゃになってる。 「要求」の方だけ覚えときな。 387 名前：デフォルトの名無しさん [2007/03/10(土) 23:01:13 ] "要求"・・大学・研究機関で使われる "要件"・・企業で使われる だろ？ 388 名前：デフォルトの名無しさん mailto:sage [2007/03/10(土) 23:27:23 ] "要件"・・営業が使う 389 名前：デフォルトの名無しさん mailto:sage [2007/03/12(月) 01:50:03 ] うーん。　難しいんですね。 レイヤーが違うというなら、 比喩的に、ボールペンの 要求定義、要件定義はどのようになるんでしょうか。 390 名前：デフォルトの名無しさん mailto:sage [2007/03/12(月) 21:24:59 ] >>389 [要求] 先端は鋼などの硬球 運筆に応じて回転、軸内のインクが滲出 391 名前：デフォルトの名無しさん mailto:sage [2007/03/12(月) 22:01:44 ] それは仕様じゃないの 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で囲ってしまうべきであり/* */や//は使うべきではない。 まして、基本的にリリース時には残さないべきなので、複数行コメントを忌避する理由はないと思う。

---

---

[ 続きを読む ] / [ 携帯版 ]

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