.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
.if n .ds - \%--
.if t .ds - \(em
.TH RLOG 1 "\*(Dt" "GNU RCS \*(Rv"
.SH "نام (NAME)"
rlog \- چاپ پیام‌های گزارش و سایر اطلاعات دربارهٔ فایل‌های \*r
.SH "خلاصه دستور (SYNOPSIS)"
.B rlog
.RI [ " options " ] " file " .\|.\|.
.SH "توضیحات (DESCRIPTION)"
.B rlog
اطلاعات مربوط به فایل‌های \*r را چاپ می‌کند.
.PP
نام‌های فایلی که با پسوند \*r مطابقت دارند، نشان‌دهندهٔ فایل‌های \*r هستند؛
سایر نام‌ها نشان‌دهندهٔ فایل‌های کاری می‌باشند.
نام‌ها همان‌طور که در
.BR ci (1)
توضیح داده شده است جفت می‌شوند.
.PP
.B rlog
اطلاعات زیر را برای هر
\*o
چاپ می‌کند: نام \*o، نام فایل کاری، head (یعنی شمارهٔ
آخرین بازبینی روی شاخهٔ اصلی)، شاخهٔ پیش‌فرض، فهرست دسترسی، قفل‌ها،
نام‌های نمادین، پسوند، تعداد کل بازبینی‌ها،
تعداد بازبینی‌های انتخاب‌شده برای چاپ، و
متن توصیفی. سپس ورودی‌های مربوط به بازبینی‌های انتخاب‌شده به
ترتیب زمانی معکوس برای هر شاخه می‌آیند. برای هر بازبینی،
.B rlog
شمارهٔ بازبینی، پدیدآورنده، تاریخ/زمان، وضعیت، تعداد
خطوط اضافه‌شده/حذف‌شده (نسبت به بازبینی قبلی)،
قفل‌کنندهٔ بازبینی (در صورت وجود)، و پیام گزارش را چاپ می‌کند.
همهٔ زمان‌ها به‌طور پیش‌فرض در زمان هماهنگ جهانی (\*u) نمایش داده می‌شوند؛
این مورد را می‌توان با
.B \-z
تغییر داد.
بدون گزینه‌ها،
.B rlog
اطلاعات کامل را چاپ می‌کند.
گزینه‌های زیر این خروجی را محدود می‌کنند.
.nr n \w'\f3\-V\fP\f2n\fP'+2n-1/1n
.ds n \nn
.if \n(.g .if r an-tag-sep .ds n \w'\f3\-V\fP\f2n\fP'u+\n[an-tag-sep]u
.TP \*n
.B \-L
نادیده گرفتن فایل‌های \*r که هیچ قفلی روی آن‌ها تنظیم نشده است.
این گزینه در ترکیب با
.BR \-h ،
.B \-l
و
.B \-R
بسیار سودمند است.
.TP
.B \-R
تنها نام \*o را چاپ می‌کند.
این گزینه برای تبدیل نام یک فایل کاری به نام یک \*o مناسب است.
.TP
.B \-h
تنها نام \*o، نام فایل کاری، head،
شاخهٔ پیش‌فرض، فهرست دسترسی، قفل‌ها،
نام‌های نمادین، و پسوند را چاپ می‌کند.
.TP
.B \-t
همان اطلاعات
.BR \-h ،
به همراه متن توصیفی را چاپ می‌کند.
.TP
.B \-N
نام‌های نمادین را چاپ نمی‌کند.
.TP
.B \-b
اطلاعات مربوط به بازبینی‌های روی شاخهٔ پیش‌فرض (معمولاً
بالاترین شاخه روی شاخهٔ اصلی یا trunk) را چاپ می‌کند.
.TP
.BI \-d "dates"
اطلاعات مربوط به بازبینی‌هایی با تاریخ/زمان ثبت در محدوده‌های ارائه‌شده در فهرست جداشده با نقطه-ویرگولِ
.I dates
را چاپ می‌کند.
محدوده‌ای به شکل
.IB d1 < d2
یا
.IB d2 > d1
بازبینی‌هایی را انتخاب می‌کند که بین
.I d1
و
.I d2
(بدون احتساب خود آن‌ها) ثبت شده‌اند.
محدوده‌ای به شکل
.BI < d
یا
.IB d >
تمام بازبینی‌های قدیمی‌تر از
.IR d
را انتخاب می‌کند.
محدوده‌ای به شکل
.IB d <
یا
.BI > d
تمام بازبینی‌های با تاریخ جدیدتر از
.IR d
را انتخاب می‌کند.
اگر پس از
.B <
یا
.B >
نویسهٔ
.B =
بیاید، محدوده‌ها شامل مرزها (inclusive) خواهند بود، نه غیرشامل (exclusive).
محدوده‌ای به شکل
.I d
تنها آخرین بازبینی با تاریخ
.I d
یا پیش از آن را انتخاب می‌کند.
رشته‌های تاریخ/زمان
.IR d ،
.I d1
و
.I d2
در قالب آزادی هستند که در
.BR co (1)
توضیح داده شده است.
معمولاً نقل‌قول کردن (قرار دادن درون گیومه) لازم است، به‌ویژه برای
.B <
و
.BR > .
توجه داشته باشید که جداکننده یک نقطه-ویرگول است.
.TP
.BR \-l [\f2lockers\fP]
تنها اطلاعات مربوط به بازبینی‌های قفل‌شده را چاپ می‌کند.
علاوه بر این، اگر فهرست جداشده با کاما از نام‌های ورود کاربران در
.I lockers
ارائه شود،
تمام قفل‌ها به جز آن‌هایی که توسط
.I lockers
نگه‌داشته شده‌اند نادیده گرفته می‌شوند.
برای نمونه،
.B "rlog\ \-L\ \-R\ \-lwft\ RCS/*"
نام فایل‌های \*r قفل‌شده توسط کاربر
.B wft
را چاپ می‌کند.
.TP
.BR \-r [\f2revisions\fP]
اطلاعات مربوط به بازبینی‌های ارائه‌شده در فهرست جداشده با کامای
.I revisions
از بازبینی‌ها و محدوده‌ها را چاپ می‌کند.
یک محدوده به شکل
.IB rev1 : rev2
به معنی بازبینی‌های
.I rev1
تا
.I rev2
روی همان شاخه است؛
.BI : rev
به معنی بازبینی‌ها از ابتدای شاخه تا و شامل
.IR rev
است؛ و
.IB rev :
به معنی بازبینی‌ها با شروع از
.I rev
تا انتهای شاخهٔ حاوی
.IR rev
می‌باشد.
آرگومانی که نشان‌دهندهٔ یک شاخه باشد به معنی تمام
بازبینی‌های روی آن شاخه است.
محدوده‌ای از شاخه‌ها به معنی تمام بازبینی‌های
روی شاخه‌های موجود در آن محدوده است.
یک شاخه که پس از آن یک
.B .\&
بیاید، به معنی آخرین بازبینی در آن شاخه است.
استفاده از
.B \-r
به‌تنهایی بدون هیچ
.I revisions
به معنی آخرین بازبینی روی شاخهٔ پیش‌فرض (معمولاً شاخهٔ اصلی یا trunk) است.
.TP
.BI \-s states
اطلاعات مربوط به بازبینی‌هایی را چاپ می‌کند که صفت وضعیت آن‌ها با یکی از
وضعیت‌های ارائه‌شده در فهرست جداشده با کامای
.I states
مطابقت داشته باشد.
.TP
.BR \-w [\f2logins\fP]
اطلاعات مربوط به بازبینی‌های ثبت‌شده توسط کاربرانی را چاپ می‌کند که
نام‌های ورود آن‌ها در فهرست جداشده با کامای
.I logins
آمده باشد.
اگر
.I logins
حذف شود، نام ورود کاربر جاری در نظر گرفته می‌شود..TP
.B \-q
این گزینه هیچ تأثیری ندارد؛
برای سازگاری با سایر دستورها ارائه شده است.
.TP
.B \-T
این گزینه هیچ تأثیری ندارد؛
برای سازگاری با سایر دستورهای \*r وجود دارد.
.TP
.BI \-V
شماره نسخهٔ \*r را چاپ می‌کند.
.TP
.BI \-V n
هنگام تولید لاگ‌ها، نسخهٔ
.I n
از \*r را شبیه‌سازی می‌کند.
برای اطلاعات بیشتر
.BR co (1)
را ببینید.
.TP
.BI \-x "suffixes"
از
.I suffixes
برای مشخص کردن \*os استفاده می‌کند.
برای جزئیات بیشتر
.BR ci (1)
را ببینید.
.PP
دستور
.B rlog
اشتراک بازبینی‌های انتخاب‌شده با گزینه‌های
.BR \-d ،
.BR \-l ،
.BR \-s
و
.BR \-w
را در تقاطع با اجتماع بازبینی‌های انتخاب‌شده توسط
.B \-b
و
.B \-r
چاپ می‌کند.
.TP
.BI \-z zone
قالب خروجی تاریخ را مشخص می‌کند،
و منطقهٔ زمانی پیش‌فرض را برای
.I date
در گزینهٔ
.BI \-d dates
تعیین می‌نماید.
مقدار
.I zone
باید خالی، یک آفست عددی از \*u، یا رشتهٔ ویژهٔ
.B LT
برای زمان محلی باشد.
حالت پیش‌فرض یک
.I zone
خالی است
که از قالب سنتی \*r برای \*u بدون هیچ نشانه‌ای از منطقهٔ زمانی
و با استفاده از اسلش برای جداسازی بخش‌های تاریخ استفاده می‌کند؛
در غیر این صورت، زمان‌ها در قالب \*i 8601 همراه با مشخصهٔ منطقهٔ زمانی چاپ می‌شوند.
به‌عنوان مثال، اگر زمان محلی ۱۱ ژانویه ۱۹۹۰، ساعت ۲۰:۰۰ به وقت استاندارد اقیانوس آرام (Pacific Standard Time)،
هشت ساعت در غرب \*u باشد،
آنگاه زمان به صورت زیر در خروجی نمایش داده می‌شود:
.RS
.LP
.RS
.nf
.ta \w'\f3\-z+05:30\fP  'u +\w'\f31990-01-11 09:30:00+05:30\fP  'u
.ne 4
\f2option\fP	\f2time output\fP
\f3\-z\fP	\f31990/01/12 04:00:00\fP	\f2(default)\fP
\f3\-zLT\fP	\f31990-01-11 20:00:00\-08\fP
\f3\-z+05:30\fP	\f31990-01-12 09:30:00+05:30\fP
.ta 4n +4n +4n +4n
.fi
.RE
.SH "مثال‌ها (EXAMPLES)"
.LP
.nf
.B "    rlog  \-L  \-R  RCS/*"
.B "    rlog  \-L  \-h  RCS/*"
.B "    rlog  \-L  \-l  RCS/*"
.B "    rlog  RCS/*"
.fi
.LP
دستور نخست، نام تمام \*os موجود در زیردایرکتوری
.B RCS
را که دارای قفل هستند چاپ می‌کند. دستور دوم سرآیند آن فایل‌ها را چاپ می‌کند،
و دستور سوم علاوه بر سرآیندها، پیام‌های لاگ بازبینی‌های قفل‌شده را چاپ می‌نماید.
دستور آخر اطلاعات کامل را چاپ می‌کند..SH "محیط (ENVIRONMENT)"
.TP
.B \s-1RCSINIT\s0
گزینه‌هایی که با فاصله از هم جدا شده و به ابتدای فهرست آرگومان‌ها افزوده می‌شوند.
یک بک‌اسلش (backslash) فاصله‌های درون یک گزینه را گریزدهی (escape) می‌کند.
گزینه‌های
.B \s-1RCSINIT\s0
به ابتدای فهرست آرگومان‌های اکثر دستورهای \*r اضافه می‌شوند.
گزینه‌های مفید
.B \s-1RCSINIT\s0
شامل
.BR \-q ،
.BR \-V ،
.BR \-x
و
.BR \-z
هستند.
.TP
.B \s-1RCS_MEM_LIMIT\s0
به‌طور معمول برای سرعت بیشتر، چنانچه اندازهٔ \*o کمتر از
.IR memory-limit
باشد، دستورها آن را در حافظه نگاشت (memory map) کرده یا در حافظه کپی می‌کنند؛ مقدار پیش‌فرض آن در حال حاضر «نامحدود» (``unlimited'') است.
در غیر این صورت (یا اگر روش‌های سریع اولیه با شکست مواجه شوند)، دستورها به استفاده از روال‌های استاندارد ورودی/خروجی (I/O) بازمی‌گردند.
می‌توانید محدودیت حافظه را با تنظیم
.B \s-1RCS_MEM_LIMIT\s0
روی یک مقدار عددی
.IR lim
(برحسب کیلوبایت) مشخص کنید.
مقدار خالی بدون هیچ پیامی نادیده گرفته می‌شود.
به عنوان یک اثر جانبی، تعیین کردن
.B \s-1RCS_MEM_LIMIT\s0
مانع از بازگشت به روال‌های کندتر می‌شود.
.TP
.B \s-1TMPDIR\s0
نام دایرکتوری موقت.
اگر تنظیم نشده باشد، متغیرهای محیطی
.B \s-1TMP\s0
و
.B \s-1TEMP\s0
به جای آن بررسی شده و نخستین مقدار یافت‌شده اعمال می‌شود؛
اگر هیچ‌یک از آن‌ها تنظیم نشده باشند، یک مقدار پیش‌فرض وابسته به میزبان استفاده می‌شود که معمولاً
.BR /tmp
است.
.SH "خطاها (DIAGNOSTICS)"
وضعیت خروج تنها در صورتی صفر است که تمام عملیات‌ها موفقیت‌آمیز بوده باشند.
.ds EY 1990, 1991, 1992, 1993, 1994, 1995
.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 ident (1),
.BR rcs (1),
.BR rcsdiff (1),
.BR rcsmerge (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
شامل اخبار و پیوندهایی به آخرین نسخه، سایت توسعه و موارد دیگر است..SH "گزارش باگ‌ها (BUGS)"
جداکنندهٔ بازه‌های بازنگری در گزینهٔ
.B \-r
پیش‌تر به‌جای
.BR : ،
.B \-
بود؛ اما این امر زمانی که نام‌های نمادین حاوی
.B \-
باشند منجر به سردرگمی می‌شود.
برای سازگاری رو به عقب،
.B "rlog \-r"
همچنان از جداکنندهٔ قدیمی
.B \-
پشتیبانی می‌کند، اما دربارهٔ این استفادهٔ منسوخ هشدار می‌دهد.
.br