28.3.2.1 ソースファイルタグの構文

以下は、もっともポピュラーな言語でタグ構文が定義される方法です:

• Cコードでは、Cの関数やtypedefはタグなので、struct、union、enumの定義もタグです。タグテーブルを作成するとき、‘--no-defines’を指定しなければ、#defineマクロ定義、#undefおよびenum定数もタグになります。同様に、‘--no-globals’を指定しなければグローバル変数もタグで、‘--no-members’を指定していなければ構造体のメンバーもタグです。‘--no-globals’、‘--no-defines’、‘--no-members’を使用することにより、タグテーブルを小さくすることができます。

  etagsに‘--declarations’オプションを与えることにより、関数定義(function definitions)に加えて、関数宣言(function declarations)と外部変数(external variables)もタグ付けできます。

• C++コードでは、Cコードのすべてのタグ構成に加えて、メンバー関数も認識されます。‘--no-members’オプションを使用しなければ、メンバー変数も認識されます。クラスの変数および関数にたいするタグは、‘class::variable’および‘class::function’という名前になります。演算子(operator)定義は‘operator+’のような名前になります。
• Javaコードでは、C++で認識されるのすべてのタグ構成に加えて、interface、extends、implementsもタグとして認識されます。クラスの変数および関数にたいするタグは、‘class.variable’および‘class.function’という名前になります。
• LaTeXドキュメントでは、\chapter、\section、\subsection、\subsubsection、\eqno、\label、\ref、\cite、\bibitem、\part、\appendix、\entry、\index、\def、\newcommand、\renewcommand、\newenvironment、\renewenvironmentにたいする引数がタグになります。

  etagsを呼び出す前に、環境変数TEXTAGSで指定することにより、他のコマンドも同様にタグにできます。この環境変数の値には、コロンで区切られたコマンド名のリストを指定します。たとえば、

  TEXTAGS="mycommand:myothercommand"
  export TEXTAGS
  

  これは、(Bourneシェルの構文の使用して)コマンド‘\mycommand’と‘\myothercommand’もタグとして定義します。

• Lispコードでは、defunで定義された任意の関数、defvarおよびdefconstで定義された任意の変数、および一般的に列0から‘(def’で始まる任意の式の最初の引数はタグです。例外として(defvar foo)という形式の式は、宣言として扱われ、‘--declarations’オプションが与えられたときだけタグになります。
• Schemeコードでは、defで定義されたすべて、または名前が‘def’で始まる構成がタグに含まれます。これらは、ファイルのトップレベルでset!でセットされる変数も含まれます。

他の言語もいくつかサポートされます:

• Adaコードでは、関数(functions)、プロシージャー(procedures)、パッケージ(packages)、タスク(tasks)、タイプ(types)がタグです。‘--packages-only’オプションを使用することにより、タグをパッケージにたいしてだけ作成できます。

  Adaでは、異なる種類のエンティティー(たとえば関数とプロシージャー)に、同じ名前を使うことができます。またパッケージ、プロシージャー、関数と似たものに、スペック(spec、たとえばinterface)およびボディー(body、たとえばimplementation)があります。欲しい定義を簡単に取り出すために、Adaのタグ名にはエンティティーのタイプを示す接尾辞がつきます:

  ‘/b’

  パッケージのボディー(package body)。

  ‘/f’

  関数(function)

  ‘/k’

  タスク(task)。

  ‘/p’

  プロシージャー(procedure)。

  ‘/s’

  パッケージのスペック(package spec)。

  ‘/t’

  タイプ(type)。

  したがって、M-x find-tag RET bidule RETは単にbiduleという任意のタグを検索しますが、M-x find-tag RET bidule/b RETは直接パッケージbiduleのボディーに移動します。

• アセンブラーコードでは、行の開始に現れ、後にコロンが続くラベルがタグです。
• BisonまたはYaccの入力ファイルでは、各構文規則で定義する非終端記号がタグです。ファイル内に含まれるCコードの部分は、Cコードとして解析します。
• Cobolコードでは、タグはパラグラフ名なので、列8から始まり、後にピリオドが続く任意の単語がタグです。
• Erlangコードでは、ファイルで定義された関数(functions)、レコード(records)、マクロ(macros)がタグです。
• Fortranコードでは、サブルーチン(subroutines)およびブロックデータ(block data)がタグです。
• Goコードでは、関数(functions)、タイプ(types)がタグです。
• HTML入力ファイルでは、title、およびh1、h2、h3ヘッダーがタグです。アンカー内のname=、およびすべてのid=もタグです。
• Lua入力ファイルでは、すべての関数(functions)がタグです。
• makefileでは、ターゲット(targets)がタグで、‘--no-globals’を指定しなければ変数(variables)もタグです。
• Objective Cコードでは、クラスにたいするObjective C定義、クラスカテゴリー(class categories)、メソッド(methods)、プロトコル(protocols)が含まれます。クラスの変数および関数にたいするタグの名前は、‘class::variable’および‘class::function’になります。
• Pascalコードでは、ファイル内で定義された関数およびプロシージャーがタグです。
• Perlコードでは、パッケージ、サブルーチン、変数がタグで、キーワードpackage、sub、use constant、my、localで定義されます。グローバル変数をタグ付けしたい場合、‘--globals’を使用します。サブルーチンにたいするタグの名前は、‘package::sub’になります。デフォルトのパッケージで定義されたサブルーチンの名前は、‘main::sub’になります。
• PHPコードでは、関数(functions)、クラス(classes)、定義(defines)がタグです。‘--no-members’オプションを使用しなければ、変数(vars)もタグです。
• PostScriptコードでは、関数がタグです。
• Prologコードでは、行頭の述語(predicates)とルール(rules)がタグです。
• Pythonコードでは、行頭のdefおよびclassはタグを生成します。
• Rubyコードでは、行の先頭にあるdef、class、moduleはタグを生成します。定数もタグを生成します。

他の書式や言語を扱うために、regexpにたいするマッチにもとづいてタグを生成することもできます(Etags Regexpsを参照してください)。