タグ付けされた質問 「comments」

コメントは、コンパイルされていない、プログラマが読み取り可能な注釈をコンピュータプログラムのソースコードに埋め込むために使用されるプログラミング言語の構成要素です。

10
バッチファイルではどのコメントスタイルを使用すればよいですか?
私はいくつかのバッチファイルを作成していて、このユーザーガイドに遭遇しました。それは私を示したことの一つは、ラインがでないだけで、コメントすることができますということでしたREMが、またして::。それは言う: ラベルはリダイレクトシンボルの前に処理されるため、REMコマンドを使用するよりも、ダブルコードを使用してバッチコード内のコメントを作成できます。::<remark>問題はありませんがrem <remark>、エラーが発生します。 では、なぜ私が目にするほとんどのガイドと例でこのREMコマンドを使用するのですか?い::のWindowsのすべてのバージョンで仕事を?


30
自己文書化コードとは何ですか?それは十分に文書化されたコードを置き換えることができますか?[閉まっている]
現在のところ、この質問はQ&A形式には適していません。私たちは回答が事実、参考文献、または専門知識によってサポートされることを期待しますが、この質問はおそらく議論、議論、投票、または拡張された議論を誘います。この質問を改善でき、再開できると思われる場合は、ヘルプセンターにアクセスしてください。 7年前休業。 私の同僚には、彼のコードにはコメントは不要で、「自己文書化」であると主張しています。 私は彼のコードを確認しましたが、他の人が作成したコードよりも明確ですが、自己文書化コードが完全かつ有用であり、コメント化および文書化されたコードであることにまだ同意しません。 彼の見方を理解してください。 自己文書化コードとは よくコメントされ、文書化されたコードを本当に置き換えることができますか 十分に文書化され、コメントされたコードよりも優れている状況はありますか コードがコメントなしで自己文書化できない例はありますか 多分それは私自身の制限だけかもしれませんが、それがどのように良い習慣になることができるかはわかりません。 これは議論を意図したものではありません-コメントと文書化されたコードが高い優先度である理由を挙げないでください-これを示す多くのリソースがありますが、それらは私の仲間には説得力がありません。そうでなければ彼を説得するには、彼の見方をより完全に理解する必要があると思います。必要に応じて新しい質問を開始しますが、ここでは議論しないでください。 うわぁ、素早い対応!ここで他のすべての回答と大きく異なる場合を除き、既存の回答をすべて読み、新しい回答を追加するのではなく、回答にコメントを入力してください。 また、自己文書化コードに対して異議を唱えている人たち-これは主に、自己文書化コードエバンジェリストの視点(つまり、肯定的な側面)を理解するのに役立ちます。あなたが話題に留まらない場合、他の人があなたに反対票を投じることを期待しています。

17
Pythonに複数行コメントがないのはなぜですか?
はい、三重引用符の文字列が複数行のコメントとして機能することを認識しています。例えば、 """Hello, I am a multiline comment""" そして '''Hello, I am a multiline comment''' しかし、技術的にはこれらは文字列です、そうですか? 私はググってPythonスタイルガイドを読みましたが、コメントの/ * * /タイプの複数行の正式な実装がない理由に対する技術的な答えを見つけることができませんでした。三重引用符を使用しても問題はありませんが、この設計の決定につながった原因について少し興味があります。



7
CSVファイルにコメントを付けることはできますか?
独自の行または行の終わりに、CSV形式のファイルにコメントを許可する公式の方法はありますか? 私はこれとRFC 4180でウィキペディアをチェックしてみましたが、どちらもファイル形式の一部ではないと信じるようにする何も言及していないので、私にとっては不運であり、別のReadMe.txtファイルを使用して説明する必要がありますファイル。 最後に、自分のコメントを簡単に追加できることはわかっていますが、Excelのようなものをすぐにインポートして、コンシューマーがインポートプロセスをカスタマイズする必要がないことを望んでいました。 だから、考え?


4
Xcode 5で利用できる新しいドキュメントコマンドは何ですか?[閉まっている]
閉まっている。この質問はスタックオーバーフローのガイドラインを満たしていません。現在、回答を受け付けていません。 この質問を改善してみませんか?Stack Overflowのトピックとなるように質問を更新します。 2年前休業。 この質問を改善する Xcode 5の新機能の 1つは、独自のコードを特別なコメント構文で文書化する機能です。形式はdoxygenに似ていますが、これらの機能のサブセットのみをサポートするようです。 サポートされているコマンドとサポートされていないコマンドを教えてください。 それらの使用法のいずれかがdoxygenと異なりますか?


4
Jenkinsfileにコメントを追加できますか?
Jenkinsfileでコメントは可能ですか?もしそうなら、構文は何ですか? 宣言的なパイプライン構文を使用しています。 SMTPサーバーが動作するまで、以下の「投稿」セクションをコメント化します。 pipeline { agent { label 'docker-build-slave' } environment { IMAGE = 'registry.gitlab.com/XXXXX/bible-server' DOCKER_REGISTRY_CREDENTIALS = credentials('DOCKER_REGISTRY_CREDENTIALS') } options { timeout(10) } stages { stage('Test') { steps { sh 'yarn' sh 'npm test' } } stage('Build') { when { branch '*/master' } steps { sh 'docker login -u ${DOCKER_REGISTRY_CREDENTIALS_USR} …

2
build.gradleファイルにコメントを書き込むための構文は何ですか?
このbuild.gradleファイルを見下ろして apply plugin: 'com.android.application' android { compileSdkVersion 21 buildToolsVersion "21.1.2" defaultConfig { applicationId "package.myapp" minSdkVersion 19 targetSdkVersion 21 versionCode 1 versionName "1.0" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } } dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.nineoldandroids:library:2.4.0' } このプロジェクトにこのライブラリを選択した理由についてコメントを書きたい場合はどうすればよいですか。 build.gradleファイルにコメントを書き込むための構文は何ですか?


7
複数行コマンド内のBashスクリプトでのコメント
スクリプトから次の行の各行にコメントするにはどうすればよいですか? cat ${MYSQLDUMP} | \ sed '1d' | \ tr ",;" "\n" | \ sed -e 's/[asbi]:[0-9]*[:]*//g' -e '/^[{}]/d' -e 's/""//g' -e '/^"{/d' | \ sed -n -e '/^"/p' -e '/^print_value$/,/^option_id$/p' | \ sed -e '/^option_id/d' -e '/^print_value/d' -e 's/^"\(.*\)"$/\1/' | \ tr "\n" "," | \ sed -e 's/,\([0-9]*-[0-9]*-[0-9]*\)/\n\1/g' …
164 bash  syntax  comments 


弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.