diff options
Diffstat (limited to 'ja_JP.eucJP/man/man1/gctags.1')
-rw-r--r-- | ja_JP.eucJP/man/man1/gctags.1 | 236 |
1 files changed, 0 insertions, 236 deletions
diff --git a/ja_JP.eucJP/man/man1/gctags.1 b/ja_JP.eucJP/man/man1/gctags.1 deleted file mode 100644 index 57c6f57ed2..0000000000 --- a/ja_JP.eucJP/man/man1/gctags.1 +++ /dev/null @@ -1,236 +0,0 @@ -.\" Copyright (c) 1987, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)gctags.1 8.1 (Berkeley) 6/6/93 -.\" jpman %Id: gctags.1,v 1.3 1997/08/31 14:13:32 horikawa Stab % -.\" -.\" gctags.1 修正時には ctags.1 も同様に修正して下さい。 -.\" Aug 31 1997 <horikawa@jp.freebsd.org> -.Dd April 21, 1997 -.Dt GCTAGS 1 -.Os BSD 4 -.Sh 名称 -.Nm gctags -.Nd タグファイルを作成する (GLOBAL 用の特別なコマンド) -.Sh 書式 -.Nm gctags -.Op Fl BDFacderstuvwx -.Op Fl f Ar tagsfile -.Ar name ... -.Sh 解説 -.Nm -は、指定された C, Pascal, Fortran, -.Tn YACC , -lex, lisp, アセンブリのソースから、 -.Xr ex 1 -コマンド用のタグファイルを作成します。 -タグファイルは、指定されたオブジェクトが一群のファイル中の -どの場所にあるかを示すものです。 -タグファイルの各行はオブジェクトの名前、定義されているファイル、 -オブジェクトの定義を見つけるための検索パターンを含み、 -各々は空白で区切られています。 -この -.Ar tags -ファイルを用いることにより、 -.Xr ex 1 -でこれらのオブジェクトが定義されている場所をすばやく見つけることが -できます。 -.Nm -に与えられるオプションによりますが、オブジェクトは -subroutine 、 typedef 、 define 、 struct 、 enum 、 union から -構成されます。 -.Bl -tag -width Ds -.It Fl B -後方検索パターン -.Pq Li ?...? -を用います。 -.It Fl D -同じオブジェクトの名前が複数回出てくるのを許可します。 -.It Fl F -前方検索パターン -.Pq Li /.../ -を用います(デフォルト)。 -.It Fl a -既存の -.Ar tags -ファイルに追加します。 -.It Fl c -コンパクトフォーマットで表示します。 -.Fl x -オプション指定時にのみ有効です。 -.It Fl d -引数を持たない -.Li #define -に関してもタグを作成します。引数を持つ -.Li #define -は自動的にタグが作成されます。 -.It Fl e -一桁目に '}' が出てきたときに、強制的に関数の終わりと判断します -( C 言語のみ ) 。 -.It Fl f Ar tagsfile -.Ar tagsfile -で指定されたファイル名でタグファイルを生成します。 -デフォルトでは -.Ar tags -というファイル名でタグファイルを生成します。 -.It Fl r -関数定義ではなく関数参照の位置を提供します。 -カレントディレクトリに GTAGS ファイルが必要となります -( C 言語のみ ) 。 -.It Fl s -関数以外のシンボルを集めます。 -.It Fl t -typedef, struct, union, enum 宣言のタグを生成します。 -.It Fl u -.Ar tags -ファイル内の指定されたファイルに関する情報を更新します。 -すなわち、関係するファイルへのすべての参照が削除され、新しいタグ情報が -ファイルに追加されます。 -(注意: このオプションはあまりスピードのでないような実装しか -おこなわれていません。単に -.Ar tags -ファイルを再構築した方が早く終了するでしょう。) -.It Fl v -.Xr vgrind 1 -形式のファイル一覧が標準出力に出力されます。 -この一覧はオブジェクト名、ファイル名、1 ページあたり 64 行とした場合の -ページ番号から構成されます。 -出力は辞書式の順番でソートされているので、この後に -.Xr sort 1 -を通した方がよいでしょう。次のように使います。 -.Bd -literal -offset indent -gctags \-v files \&| sort \-f > index -vgrind \-x index -.Ed -.It Fl w -診断用メッセージを表示しないようにします。 -.It Fl x -.Nm -はオブジェクト名、行番号、ファイル名、その行の内容からなる一覧を作成し、 -それを標準出力に出力します。 -これはオフラインでも読みやすいように印刷できる簡単な関数一覧として -利用できます。 -.El -.Pp -.Nm \&.c -や -.Nm \&.h -で終わる名前のファイルは、 C 言語のソースファイルとみなされ、 -C の形式の関数・マクロ定義が検索されます。 -.Nm \&.y -で終わる名前のファイルは、 -.Tn YACC -のソースファイルとみなされます。 -.Nm \&.l -で終わる名前のファイルは、最初の空白でない文字が `;' か `(' か `[' で -あれば lisp のファイルであるとみなされ、そうでなければ lex のファイルと -みなされます。 -.Nm \&.s -か -.Nm \&.S -で終るファイル名のファイルはアセンブリ言語ファイルとみなされます。 -その他のファイルは、まず Pascal か Fortran の定義が含まれるか -どうかがチェックされ、含まれない場合には C 形式の定義が検索されます。 -.Pp -C 言語の場合、 -.Li main -は特別に扱われ、元のソースファイルのパス名部分と末尾の -.Nm \&.c -の部分を取り除いたファイル名に対し、その先頭に -.Ar M -を付加したものをオブジェクト名とします。 -これにより、同じディレクトリに複数のプログラムがある場合でも -.Nm gctags -を実用的に使うことができます。 -.Pp -yacc と lex のファイルには特殊なタグがあります。 -.Ar yyparse -は yacc ファイルの第二セクションの始まりを示し、 -.Ar yylex -は lex ファイルの第二セクションの始まりを示します。 -.Sh 関連ファイル -.Bl -tag -width tags -compact -.It Pa tags -デフォルトで出力されるタグファイル -.It Pa GTAGS -GLOBAL 用のタグファイル -.El -.Sh 診断 -.Nm -はエラーが発生すると非 0 を返し、それ以外では 0 を返します。 -同じ名前のオブジェクトが複数出てきてもエラーとはみなされません。 -.Sh 関連項目 -.Xr btreeop 1 , -.Xr ex 1 , -.Xr global 1 , -.Xr gtags 1 , -.Xr htags 1 , -.Xr vi 1 . -.Sh バグ -.Tn FORTRAN -と Pascal 用の -.Nm 関数(function) -、 -.Nm サブルーチン(subroutine) -、 -.Nm 手続き(procedure) -の認識にはとても単純な方法を用いています。 -ブロック構造が解釈できないので、異なるブロックに同じ名前の Pascal 手続きが -存在するとうまく動作しません。 -.Nm -は Pascal の型(type)も理解しません。 -.Pp -C か Pascal か -.Tn FORTRAN -かを判断する方法はとりあえず動いている、という程度のものです。 -.Pp -.Nm -はきちんと整形された入力に頼っています。 -また、ソースファイルに文法的な間違いがあると -簡単に混乱してしまいます。 -文法的に間違っていなくても混乱する場合があります。 -例えば、 -.Li #ifdef -を理解しないので(バグではなく仕様です)、 -.Li #ifdef -内に括弧のつりあっていないコードがあると混乱してしまいます。 -同様に、定義が複数行にわたっている場合、オブジェクトの先頭行ではなく -最終行が検索パターンにマッチします。 -複数行にわたる -.Li typedef -に関しても同様です。 -.Pp -アセンブリ言語サポートは完璧からは程遠く、 -ソースファイルから ENTRY() と ALTENTRY() を取り出すだけです。 -FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。 -.Sh 歴史 -.Nm -コマンドは FreeBSD 2.2.2 で登場しました。 |