.\" $FreeBSD: doc/ja_JP.eucJP/man/man1/ident.1,v 1.7 2001/05/14 01:07:24 horikawa Exp $
.de Id
.ds Rv \\$3
.ds Dt \\$4
.ds iD \\$3 \\$4 \\$5 \\$6 \\$7
..
.Id %FreeBSD: src/gnu/usr.bin/rcs/ident/ident.1,v 1.5 1999/08/27 23:36:42 peter Exp %
.ds r \&\s-1RCS\s0
.ds u \&\s-1UTC\s0
.if n .ds - \%--
.if t .ds - \(em
.TH IDENT 1 \*(Dt GNU
.SH 名称
ident \- ファイル内の RCS キーワードを読み出す
.SH 書式
.B ident
[
.B \-q
] [
.B \-V
] [
.I file
\&.\|.\|. ]
.SH 解説
.B ident
は、指定されたファイルがあればそのファイルから、指定がない場合には標準入力から、
.BI $ keyword : "\ text\ " $
なるパターンを検索します。
.PP
これらのパターンは、通常 \*r の
.BR co (1)
コマンドにより自動的に挿入されますが、
手作業で入れることも可能です。オプション
.B \-q
を指定すると、ファイル中に
キーワードが発見できなくても警告メッセージを出力しません。
.B \-V
を指定すると、
.BR ident
のバージョン番号を表示します。
.PP
.B ident
は、テキストファイルと同様にオブジェクトファイルやダンプファイルにも使
用することができます。
たとえば、以下の C 言語プログラム
.B f.c
で、
.IP
.ft 3
#include <stdio.h>
.br
static char const rcsid[] =
.br
  \&"$\&Id: f.c,v \*(iD $\&";
.br
int main() { return printf(\&"%s\en\&", rcsid) == EOF; }
.ft P
.LP
.B f.c
が
.B f.o
にコンパイルされているなら、以下のコマンド
.IP
.B "ident  f.c  f.o"
.LP
は、次のような出力を行います。
.nf
.IP
.ft 3
f.c:
    $\&Id: f.c,v \*(iD $
f.o:
    $\&Id: f.c,v \*(iD $
.ft
.fi
.PP
C 言語プログラムで上記のような文字列
.B rcsid
が定義され、かつ使われていないとき、
.BR lint (1)
が警告を出したり、 C コンパイラによっては最適化により文字列を削除する
場合があります。もっとも、よい解決策は上のプログラム例のように文字列
.B rcsid
を使うことです。
.PP
.B ident
は、 \r* がサポートする
.I keyword
でなくても、すべての
.BI $ keyword : "\ text\ " $
パターンを表示します。
これにより、
.BR $\&XConsortium$
のような非標準の keyword についても情報が得られます。
.SH キーワード
つぎに現在、
.BR co (1)
が扱う keyword を挙げます。デフォルトでは、すべての時刻は協定世界時
(\*u しばしば \&\s-1GMT\s0と呼ばれます) で表されますが、
チェックアウトのときに、
.BR co
の
.BI \-z zone
オプションを使ったファイルについては、数字によるタイムゾーンが付加され
ます。
.TP
.B $\&Author$
そのリビジョンをチェックインしたユーザ名です。
.TP
.B $\&Date$
そのリビジョンをチェックインした日付と時刻です。
.TP
.B $\&Header$
\*r ファイルのフルパス名を含んだ標準のヘッダ、リビジョン番号、
作者、状態、およびロックされている場合にはロックした人です。
.TP
.B $\&Id$
\*r ファイルの名前がフルパスでないことを除いて、
.BR $\&Header$ ,
と同じです。
.TP
.B $\&Locker$
そのリビジョンをロックした人のユーザ名 (ロックされていない場合は空白)
です。
.TP
.B $\&Log$
チェックインのときに書かれたログメッセージです。
.BR ident
の目的としては、
.BR $\&RCSfile$
と等価です。
.TP
.B $\&Name$
リビジョンをチェックアウトするときに使うシンボル名です(ないかもしれま
せん)。
.TP
.B $\&RCSfile$
フルパスでない \*r ファイルの名前です。
.TP
.B $\&Revision$
そのリビジョンのリビジョン番号です。
.TP
.B $\&Source$
\*r ファイルのフルパス名です。
.TP
.B $\&State$
.BR rcs (1)
or
.BR ci (1)
の
.B \-s
オプションで付けられたそのリビジョンの状態です。
.PP
.BR co (1)
は以下の文字をエスケープシーケンスで表現することにより、
キーワードの文字列の形を保ちます。
.LP
.RS
.nf
.ne 6
.ta \w'newline  'u
\f2char	escape sequence\fP
tab	\f3\et\fP
newline	\f3\en\fP
space	\f3\e040
$	\e044
\e	\e\e\fP
.fi
.RE
.SH 作者
Author: Walter F. Tichy.
.br
Manual Page Revision: \*(Rv; Release Date: \*(Dt.
.br
Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
.br
Copyright \(co 1990, 1992, 1993 Paul Eggert.
.SH 関連項目
ci(1), co(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
rcsfile(5)
.br
Walter F. Tichy,
\*r\*-A System for Version Control,
.I "Software\*-Practice & Experience"
.BR 15 ,
7 (July 1985), 637-654.