問題タブ [comments]

ページの上部近くに HTML コメントを挿入する生成されたページがあります。コメントの中には *nix スタイルのコマンドがあります。

このコメントはページを完全に壊します。これが発生する原因となるコメントの何が問題なのですか? また、なぜそうなるのでしょうか?

現在、ラテックスと TexnicCenter を使用して学士論文を書いています。生成した pdf ファイルを人々に送信できるようにしたいのですが、彼らはコメントを書くことができるはずです。デフォルトではコメントが許可されていないようですが、これを変更するにはどうすればよいですか?

私はpdflatexとacrobat reader 9でPDFに直接使用して、ファイルを読んでコメントしています

この質問はおそらく、C のような複数行コメントを持つ他の言語にも同じように当てはまるでしょう。これが私が遭遇している問題です。私は Eclipse で Java コードを扱っていますが、コードのブロックをコメントアウトしたいと考えていました。ただし、文字シーケンス「*/」を含む文字列があり、文字列内にあるにもかかわらず、Eclipse はコメントをそこで終了する必要があると判断します。大量のエラーが発生し、ビルドに失敗します。

Java 仕様は、私の複数行コメントの Eclipse の解釈と一致しますか? JavaやEclipseがこの種のことを説明すると思います。

クラス ドキュメントをソース コードから自動的に生成できるように、C# コードにコメントを付けるための標準的な規則 (phpdoc や python の docstring など) はありますか?

特定のブログ投稿のコメント数を確認する最も効率的な方法は何ですか? 新しい Web アプリのデータを保存したいと考えています。パーマリンク URl と RSS フィードのリストがあります。

ユーザーが入力したクエリを使用してDBUnitXMLデータセットを生成する簡単なツールを作成しました。XMLに入力された各クエリをコメントとして含めたいのですが、XMLファイルを生成するDBUnit APIは、必要な場所（生成されるデータの上）にコメントを挿入することをサポートしていないため、上部または下部にすべてのクエリを付けてコメントします。

だから私の質問：どちらかの場所に配置することは有効なXMLですか？たとえば、XML宣言の上：

またはルートノードの下：

私は最初にXML宣言の上で試す予定ですが、ウィキペディアからの主張にもかかわらず、それが有効なXMLであるかどうかについては疑問があります。

コメントは、要素のコンテンツがテキストまたは#PCDATAの場合はテキストを含め、ツリーのどこにでも配置できます。

これが機能する場合は投稿する予定ですが、それが公式のXML標準であるかどうかを知っておくと便利です。

更新：私のテストの結果については、以下の私の応答を参照してください。

API ドキュメント (「パブリック関数の javadoc」など) で、従来のドキュメントと同様に「値の制限」の説明をよく目にしますか?

注：コード内のコメントについて話しているのではありません

「値の制限」とは、次のことを意味します。

• パラメーターは null 値 (または空の文字列、または...) をサポートできますか?
• 「戻り値」はnullになる可能性がありますか、それともnullにならないことが保証されていますか（または「空」になる可能性がありますか...）？

サンプル：

私がよく目にするのは（ソースコードにアクセスできない場合）次のとおりです。

私が見たいのは次のとおりです。

私のポイントは次のとおりです。

getReaderNames() 関数を含むライブラリを使用する場合、多くの場合、その機能を推測するために API ドキュメントを読む必要さえありません。しかし、私はそれを使用する方法を確認する必要があります。

この関数を使用するときの私の唯一の懸念は、パラメーターと戻り値に関して何を期待する必要があるかということです。パラメータを安全に設定し、戻り値を安全にテストするために知っておく必要があるのはこれだけですが、API ドキュメントでそのような情報を目にすることはほとんどありません...

編集：

これは、チェックされた例外またはチェックされていない例外の使用に影響を与える可能性があります。

どう思いますか ？値制限とAPI、それらは一緒に属しますか?

Emacs : C-U (79) #» きれいな 79 文字の長さの仕切り

VIM : 79-i-#» 上記参照

テキストメイト：????

それとも、Ruby 呼び出しを行うか、どこかにスニペットがあると想定しているだけですか?

異なるプロジェクトで VB と C# が混在するソリューションで VS2005 を使用しています。

私はこのソリューションをいくつかの異なるコンピューターで使用しており、/// (c#) と ''' (VB) の両方を含む XML コメントは数か月間問題ありませんでした。

突然、メインの開発マシンで VB が動作しなくなりました。それらはまだ C# で動作します。

彼らは他のプロジェクトでも (VB で) 働いています。この 1 つのソリューション内のすべての VB プロジェクトです。

誰にもアイデアはありますか？

数週間または数か月間 VB コードの多くを変更していないため、動作が停止した時期を正確に特定することはできません。

Twitter の更新によって基本的にブログ投稿が作成され、コメント スレッドが作成されるブログを作成したいと考えています。現在、これを行うブログ ソフトウェアがない場合 (いくつか検索しましたが、コメントの側面が見つかりませんでした)、これを行うための最も簡単なアプローチとブログ ソフトウェアの開始は何でしょうか?

これに対する別のアプローチとして、私の Twitter フィードをタイトル テキストで自動更新できるブログ インターフェースが考えられます。

解決策が何であれ、現在 Twitter の Web インターフェイスを使用して Twitter フィードを更新するのとほぼ同じように、完全に自動化されていることを望んでいます。注: デフォルトのブログ Web 管理インターフェースを介した「通常の」ブログ投稿にも関心があります。