.ds Rv 5.10.1
.ds Dt 2022-02-03
.ds i \&\s-1ISO\s0
.ds r \&\s-1RCS\s0
.ds u \&\s-1UTC\s0
.ds o \*r file
.ds iD 5.4 1993/11/09 17:40:15 eggert Exp
.if n .ds - \%--
.if t .ds - \(em
.TH IDENT 1 "\*(Dt" "GNU RCS \*(Rv"
.SH "نام (NAME)"
ident \- شناسایی رشته‌های کلیدواژه RCS در فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B ident
[
.B \-q
] [
.B \-V
] [
.I فایل
\&.\|.\|. ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B ident
تمام نمونه‌های الگوی
.BI $ keyword : "\ text\ " $
را در فایل‌های مشخص‌شده، یا در صورت مشخص نشدن هیچ فایلی، در ورودی استاندارد جستجو می‌کند.
.PP
این الگوها معمولاً به طور خودکار توسط دستور
.BR co (1)
از مجموعه \*r درج می‌شوند، اما می‌توان آن‌ها را به صورت دستی نیز درج کرد.
گزینه
.B \-q
از نمایش هشدارهایی که در صورت عدم وجود الگو در یک فایل صادر می‌شوند جلوگیری می‌کند.
گزینه
.B \-V
شماره نسخه \*r را چاپ می‌کند.
.PP
دستور
.B ident
روی فایل‌های متنی و همچنین فایل‌های شیء (object files) و دامپ‌ها کار می‌کند.
برای مثال، اگر برنامه 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
به
.BR 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
تمامی نمونه‌های الگوی
.BI $ keyword : "\ text\ " $
را می‌یابد، حتی اگر
.I keyword
در عمل کلیدواژه‌ای پشتیبانی‌شده توسط \*r نباشد.
این به شما اطلاعاتی درباره کلیدواژه‌های غیراستاندارد مانند
.BR $\&XConsortium$
می‌دهد.
.PP
الگو به طور معمول نیازمند یک دو‌نقطه و یک فاصله بلافاصله پس از کلیدواژه و یک فاصله بلافاصله پیش از
.BR $
پایانی است، اما برای سازگاری با Subversion 1.2 (و نسخه‌های بعدی)،
.B ident
همچنین الگوی
.BI $ keyword :: "\ text\ " $
(یعنی دو دو‌نقطه و یک فاصله)
و الگوی
.BI $ keyword :: "\ text\ #" $
(مشابهاً با یک علامت هش پیش از
.BR $
پایانی) را تشخیص می‌دهد.
این‌ها ساختار نحوی کلیدواژه‌های با عرض ثابت هستند.
به طور خلاصه، سه الگوی شناخته‌شده عبارتند از:
.IP
.BI $ keyword : "\ text\ " $
.br
.BI $ keyword :: "\ text\ " $
.br
.BI $ keyword :: "\ text\ #" $
.br
.SH "کلیدواژه‌ها (KEYWORDS)"
در اینجا فهرستی از کلیدواژه‌هایی که در حال حاضر توسط
.BR co (1)
پشتیبانی می‌شوند آورده شده است.
همه زمان‌ها به طور پیش‌فرض در قالب زمان هماهنگ جهانی (\*u، که گاهی \&\s-1GMT\s0 نیز نامیده می‌شود) ارائه می‌شوند؛ اما اگر فایل‌ها با گزینه
.BI \-z zone
دستور
.BR co
واکشی شده باشند، زمان‌ها همراه با یک شناسه عددی منطقه زمانی در انتها ارائه می‌شوند.
.TP
.B $\&Author$
نام کاربری فردی که بازبینی را ثبت کرده است.
.TP
.B $\&Date$
تاریخ و زمانی که بازبینی ثبت شده است.
.TP
.B $\&Header$
یک سربرگ استاندارد حاوی نام کامل \*o، شماره بازبینی، تاریخ و زمان، نویسنده، وضعیت و قفل‌کننده (در صورت قفل بودن).
.TP
.B $\&Id$
مشابه
.BR $\&Header$ ،
با این تفاوت که نام \*o بدون مؤلفه‌های دایرکتوری است.
.TP
.B $\&Locker$
نام کاربری فردی که بازبینی را قفل کرده است (در صورت عدم قفل بودن، خالی است).
.TP
.B $\&Log$
پیام گزارش ثبت‌شده در حین تحویل بازبینی.
برای اهداف
.BR ident ،
این معادل با
.BR $\&RCSfile$
است.
.TP
.B $\&Name$
نام نمادین استفاده‌شده برای واکشی بازبینی، در صورت وجود.
.TP
.B $\&RCSfile$
نام \*o بدون مؤلفه‌های دایرکتوری.
.TP
.B $\&Revision$
شماره بازبینی اختصاص‌یافته به نسخه.
.TP
.B $\&Source$
نام کامل \*o.
.TP
.B $\&State$
وضعیت اختصاص‌یافته به بازبینی با گزینه
.B \-s
دستور
.BR rcs (1)
یا
.BR ci (1).
.PP
دستور
.BR co (1)
برای حفظ شکل استاندارد رشته‌های کلیدواژه، نویسه‌های زیر را در مقادیر کلیدواژه به صورت توالی گریز (escape sequence) نمایش می‌دهد:
.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
.ds EY 1990, 1992, 1993
.SH "شناسایی (IDENTIFICATION)"
نویسنده: Walter F. Tichy.
.br
بازبینی صفحه راهنما: \*(Rv؛ تاریخ انتشار: \*(Dt.
.br
حق نشر \(co 2010-2022 Thien-Thi Nguyen.
.br
حق نشر \(co \*(EY Paul Eggert.
.br
حق نشر \(co 1982, 1988, 1989 Walter F. Tichy.
.br
.SH "همچنین ببینید (SEE ALSO)"
.BR ci (1),
.BR co (1),
.BR rcs (1),
.BR rcsdiff (1),
.BR rcsmerge (1),
.BR rlog (1),
.BR rcsfile (5).
.PP
Walter F. Tichy,
\*r\*-A System for Version Control,
.I "Software\*-Practice & Experience"
.BR 15 ,
7 (July 1985), 637-654.
.PP
مستندات کامل \*r به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود.
اگر برنامه‌های
.BR info (1)
و \*r به درستی بر روی سامانه شما نصب شده باشند، دستور
.IP
.B info rcs
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.
علاوه بر این، صفحه خانگی \*r در نشانی:
.IP
.B http://www.gnu.org/software/rcs
.PP
حاوی اخبار و پیوندهایی به آخرین انتشار، پایگاه توسعه و موارد دیگر است.