次: , 前: Conventions, 上: Overview


1.7 コメント

Infoファイルや印刷されたマニュアルに現れないコメントを,Texinfoファイル に@commentコマンドを使用して書くことが可能です(省略された @cでもかまいません).そのようなコメントは,Texinfoファイルを修正 する人のためです.@comment@cに続く行の全てのテキストは コメントです.行の残りはInfoファイルにも印刷されたマニュアルにも現れませ ん.

@comment@cを行の途中にたびたび書くことも可能で, @comment@cコマンドの後のテキストのみが現れません.しか し,@settitle@setfilenameのようなコマンドは行全体に作 用します.@comment@cを,そのようなコマンドを用いている 行では使用することは不可能です.

Infoファイルや印刷されたマニュアルに現れないテキストの長い範囲を, @ignore@end ignoreコマンドを使用して書くことが可能です. 行の最初からそれぞれのコマンドを始めながら,単独行にこれらのコマンドをそ れぞれ書いてください.これら二つのコマンドの間のテキストは処理された出力 物に現れません.@ignore@end ignoreをコメントを書くため に使用することが可能です.

@ignoreや,偽の@ifset@ifclearの条件式で囲まれ ているテキストは,書式化された出力に寄与しないという意味で無視されます. しかし,TeXとmakeinfoは,ソースファイルのテキストの無視を 停止するときを知るために,無視されたテキストを解析します.つまり, 無視されているテキストに無効なTexinfoコマンドがある場合,エラーメッセー ジが発生するかもしれません.