コメント (プログラミング言語、マーク付け言語)

いろいろなコメント

[1] コメント

コメントの中身に意味を持たせる

[2] コメントの中身は本来完全に無視されるべきもののはずですが、意味を持たせて使われることがあり、まったく完全に無視されるとも言えない場面があります。

[3] コメントの中身が意味を持ってしまうというのにもいくつかの類型があります。

[5] A 仕様では意味がないが、 A が発展した A' では意味がある
[7] A 仕様では意味がないが、 A 言語を出力する前処理言語 (雛形言語など) では意味がある
[8] A 仕様では意味がないが、 A 言語を一部解釈して利用するシステムが利用する
[9] A 仕様において通常のコメントと特殊なコメントの機能を分けて提供している

[10] HTMLにおける事例はHTMLにおける他言語統合点を参照。

[15] conventional comment

[11] Java では通常のコメントの他に documentation comment があって、少し違う構文でドキュメント生成用の定型のコメントを書けます。 JavaDoc

[12] ちょっと似てるけど違う事例として、 Perl には通常のコメントと、それとまったく異なるドキュメント用の pod 構文があります。 pod はドキュメントとしての本来の用法の他でも、事実上の複数行コメントとして便利に使われています。勝手に乱用されているのではなく、公式にも容認された使い方です。

[14] shebang, -*- coding -*-, vim:, SPDX-License-Identifier:

[16] Received: の comment, comment 内の encoded-word

[19] mailbox

[18] User-Agent:

[17] 関連: 拡張可能性

DSSSL の注釈

[4] 注釈 := ";" *(文字 − 記録終了) ;; JISX4153:1998 [13]

メモ

[6] comments-in-computer-languages http://groups.google.co.jp/groups?selm=2976201200303.441243%40sra-tohoku.co.jp.msgid: ありとあらゆる言語における注釈の表現

[46] Acme::Comment - search.cpan.org (2007-10-06 10:49:14 +09:00 版) http://search.cpan.org/~kane/Acme-Comment/lib/Acme/Comment.pm (名無しさん)

[47] >>6 http://groups.google.co.jp/group/fj.archives.documents/msg/3253386754f27ef7?dmode=source&output=gplain