問題タブ [comments]

これは、私が働いていた場所での質問として出てきたばかりなので、少し掘り下げたところ、答えは ExpertsExchange のものです。それでは、最初の質問者であるマンチュンにあなたを引き渡します。

組み込みシステムで使用される純粋な C で書かれたプロジェクトがあります。そのため、純粋な C を使用してコード サイズを最小限に抑えています。

プロジェクトをコンパイルするときは、コードが ANSI 標準に準拠していることを確認するために -ansi フラグを使用します。ただし、この ansi フラグを使用することの欠点は、C スタイルのコメント (/*comments */) しか使用できないことです。これは、ネストされたコメントを使用する必要があるときに頭痛の種です。

それで、私の質問は次のとおりです。ANSI チェックを同時に有効にしたまま、C++ スタイルのコメント (// コメント) を使用できるようにするには、どのスイッチ/フラグを使用できますか?

これは私の質問もかなり要約しています。

削除されたコードにコメントを付けることは良い習慣ですか? 例えば：

ピア レビュー中に私の開発者グループの誰かが、削除するコード行にコメントする必要があると指摘しました。役に立たないコメントでコードが雑然としているので、これはひどい提案だと思いました。私たちのどちらが正しいですか？

Visual Studio 2003 を使用して、コメントを「コメント アウト」して、コメントではなくなることに気付きました。これには例が必要です：

私が持っている場合：

/* と */ を // でコメント アウトでき、/* と */ 内のコードは「コメント アウト」されなくなりました (テキストはコメント以外の色に変わり、コンパイラは再びコードとして扱います)。そのようです：

これは msvc 2003 に当てはまることがわかりました。これは通常の C++ の動作ですか、それともこのコンパイラで動作するのはまぐれですか?

そのキャプションがコメントとしてほぼすべてのフィールドに広がっているレガシーコードをいくつか取得しました。「 」も登場Setter for property xyz。

好奇心から、このスタブを生成したのはどの Java ツールでしょうか?

「 C# コメント」について、学生に配布できる最高の資料はどれか知りたいです。

コードにコメントすることについて多くの議論がありますが、チェックインにコメントするのはどうでしょうか?

このブログ投稿を見つけました: http://redbitbluebit.com/subversion-check-in-comment-great-practices/

リリース ノートをまとめる担当者として、私はその作業を簡単にする方法を探しています。

<Begin_Doc>...<End_Doc>現在、ソフトウェアの顧客に公開する必要があるものに対して、独自のスキームを定義しています。しかし、内部的なものであっても、すべての変更の「理由」を知りたいです。

私はDevExpressCodeRushとRefactorを少し使っています！今週はプロで、コードを入力すると自動的にコメントを生成するコメンタープラグインを選びました。

基本的な意味（実際にはかなり良い）を選択するという仕事がどれほど優れているかについては説明したくありませんが、デフォルトの実装では疑問が生じます。

デフォルトでは、}文字を入力してブロックを閉じると、プラグインは次のようなコメントを追加します...

（つまり、開いた場所の閉じ中括弧のラベルにコメントを追加します。）

この動作が非常に役立つ場合があることはわかりますが、結果のコードは、コメントを追加すると非常に乱雑に見えると思います。

私は他の人が何であるか疑問に思いました;この種のコメントに対する見解は何でしたか。学術的な観点からだけでなく、それらについて多くの否定的なコメントを受け取った場合、同僚にそれらを与えるか、それらを取り除くかを決めることができます。

C# では#warningand#errorディレクティブを使用します。

このようにして、コンパイラは、まだやるべきことがあるということを知らせてくれます。忘れないようにコードにマークを付けるためにどのような手法を使用していますか?

私の名前とカーソルがある日付を配置するためのショートカットを知っている人はいますか

そのため、コメントを追加するときに日付を確認しません。

CnPack と GExperts がインストールされた Delphi7 を使用しています。私はそれがそれらの専門家の一人と一緒にできるべきだと思います。

典型的な Unix ツール (emacs、vim、gvim、sunstudio など) を使用して Unix 環境で作業しています。

私のプロジェクトには、すべてのメソッドに膨大なボイラープレート コメントがあります。ファイルは数千行の長さになり、実際のコードは数百行になります。私は少し誇張しているかもしれませんが、あなたはその考えを理解しています. これらのファイルを表示するときにすべてのコメントを非表示にする (削除しない) 方法を探しているので、コードをすばやく確認できます。C++ コメント '//' のみ。