IDENT(1) General Commands Manual IDENT(1)

ident - شناسایی رشته‌های کلیدواژه RCS در فایل‌ها

ident [ -q ] [ -V ] [ فایل ... ]

دستور ident تمام نمونه‌های الگوی $keyword: text $ را در فایل‌های مشخص‌شده، یا در صورت مشخص نشدن هیچ فایلی، در ورودی استاندارد جستجو می‌کند.

این الگوها معمولاً به طور خودکار توسط دستور co(1) از مجموعه RCS درج می‌شوند، اما می‌توان آن‌ها را به صورت دستی نیز درج کرد. گزینه -q از نمایش هشدارهایی که در صورت عدم وجود الگو در یک فایل صادر می‌شوند جلوگیری می‌کند. گزینه -V شماره نسخه RCS را چاپ می‌کند.

دستور ident روی فایل‌های متنی و همچنین فایل‌های شیء (object files) و دامپ‌ها کار می‌کند. برای مثال، اگر برنامه C در f.c شامل

#include <stdio.h>
static char const rcsid[] =
"$Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $";
int main() { return printf("%s\n", rcsid) == EOF; }

باشد و f.c به f.o کامپایل شود، آن‌گاه دستور

ident f.c f.o

خروجی زیر را تولید خواهد کرد:

f.c:
    $Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $
f.o:
    $Id: f.c,v 5.4 1993/11/09 17:40:15 eggert Exp $

اگر یک برنامه C رشته‌ای مانند rcsid در بالا را تعریف کند اما از آن استفاده نکند، ممکن است lint(1) ایراد بگیرد و برخی کامپایلرهای C این رشته را طی بهینه‌سازی حذف کنند. مطمئن‌ترین راه‌حل این است که برنامه از رشته rcsid استفاده کند، همان‌طور که در مثال بالا نشان داده شده است.

دستور ident تمامی نمونه‌های الگوی $keyword: text $ را می‌یابد، حتی اگر keyword در عمل کلیدواژه‌ای پشتیبانی‌شده توسط RCS نباشد. این به شما اطلاعاتی درباره کلیدواژه‌های غیراستاندارد مانند $XConsortium$ می‌دهد.

الگو به طور معمول نیازمند یک دو‌نقطه و یک فاصله بلافاصله پس از کلیدواژه و یک فاصله بلافاصله پیش از $ پایانی است، اما برای سازگاری با Subversion 1.2 (و نسخه‌های بعدی)، ident همچنین الگوی $keyword:: text $ (یعنی دو دو‌نقطه و یک فاصله) و الگوی $keyword:: text #$ (مشابهاً با یک علامت هش پیش از $ پایانی) را تشخیص می‌دهد. این‌ها ساختار نحوی کلیدواژه‌های با عرض ثابت هستند. به طور خلاصه، سه الگوی شناخته‌شده عبارتند از:

$keyword: text $
$keyword:: text $
$keyword:: text #$

در اینجا فهرستی از کلیدواژه‌هایی که در حال حاضر توسط co(1) پشتیبانی می‌شوند آورده شده است. همه زمان‌ها به طور پیش‌فرض در قالب زمان هماهنگ جهانی (UTC، که گاهی GMT نیز نامیده می‌شود) ارائه می‌شوند؛ اما اگر فایل‌ها با گزینه -zzone دستور co واکشی شده باشند، زمان‌ها همراه با یک شناسه عددی منطقه زمانی در انتها ارائه می‌شوند.

$Author$
نام کاربری فردی که بازبینی را ثبت کرده است.
$Date$
تاریخ و زمانی که بازبینی ثبت شده است.
$Header$
یک سربرگ استاندارد حاوی نام کامل RCS file، شماره بازبینی، تاریخ و زمان، نویسنده، وضعیت و قفل‌کننده (در صورت قفل بودن).
$Id$
مشابه $Header$، با این تفاوت که نام RCS file بدون مؤلفه‌های دایرکتوری است.
$Locker$
نام کاربری فردی که بازبینی را قفل کرده است (در صورت عدم قفل بودن، خالی است).
$Log$
پیام گزارش ثبت‌شده در حین تحویل بازبینی. برای اهداف ident، این معادل با $RCSfile$ است.
$Name$
نام نمادین استفاده‌شده برای واکشی بازبینی، در صورت وجود.
$RCSfile$
نام RCS file بدون مؤلفه‌های دایرکتوری.
$Revision$
شماره بازبینی اختصاص‌یافته به نسخه.
$Source$
نام کامل RCS file.
$State$
وضعیت اختصاص‌یافته به بازبینی با گزینه -s دستور rcs(1) یا ci(1).

دستور co(1) برای حفظ شکل استاندارد رشته‌های کلیدواژه، نویسه‌های زیر را در مقادیر کلیدواژه به صورت توالی گریز (escape sequence) نمایش می‌دهد:

char	escape sequence
tab	\t
newline	\n
space	\040
$	\044
\	\\

نویسنده: Walter F. Tichy.
بازبینی صفحه راهنما: 5.10.1؛ تاریخ انتشار: 2022-02-03.
حق نشر © 2010-2022 Thien-Thi Nguyen.
حق نشر © 1990, 1992, 1993 Paul Eggert.
حق نشر © 1982, 1988, 1989 Walter F. Tichy.

ci(1), co(1), rcs(1), rcsdiff(1), rcsmerge(1), rlog(1), rcsfile(5).

Walter F. Tichy, RCS--A System for Version Control, Software--Practice & Experience 15, 7 (July 1985), 637-654.

مستندات کامل RCS به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info(1) و RCS به درستی بر روی سامانه شما نصب شده باشند، دستور

info rcs

باید دسترسی به راهنمای کامل را برای شما فراهم کند. علاوه بر این، صفحه خانگی RCS در نشانی:

http://www.gnu.org/software/rcs

حاوی اخبار و پیوندهایی به آخرین انتشار، پایگاه توسعه و موارد دیگر است.

2022-02-03 GNU RCS 5.10.1