.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 RCSDIFF 1 "\*(Dt" "GNU RCS \*(Rv"
.SH "نام (NAME)"
rcsdiff \- مقایسه ویرایش‌های RCS
.SH "خلاصه دستور (SYNOPSIS)"
.B rcsdiff
[
.BI \-k subst
] [
.B \-q
] [
.BI \-r rev1
[
.BI \-r rev2
] ] [
.B \-T
] [
.RI "\f3\-V\fP[" n ]
] [
.BI \-x suffixes
] [
.BI \-z zone
] [
.I "diff options"
]
.I "file .\|.\|."
.SH "توضیحات (DESCRIPTION)"
دستور
.B rcsdiff
برای مقایسه دو ویرایش از هر \*o داده‌شده،
.BR diff (1)
را اجرا می‌کند.
.PP
نام‌های فایلی که با یک پسوند \*r مطابقت دارند نشان‌دهنده فایل‌های \*r هستند؛
سایر نام‌ها نشان‌دهنده فایل‌های کاری می‌باشند.
نام‌ها همان‌طور که در
.BR ci (1)
شرح داده شده است، با یکدیگر جفت می‌شوند.
.PP
گزینه
.B \-q
از نمایش خروجی‌های عیب‌یابی جلوگیری می‌کند.
با استفاده از
.BR \-r
می‌توان صفر، یک یا دو ویرایش را مشخص کرد.
گزینه
.BI \-k subst
بر جایگزینی کلمات کلیدی هنگام استخراج ویرایش‌ها تأثیر می‌گذارد، همان‌گونه که در
.BR co (1)
توضیح داده شده است؛
برای نمونه،
.B "\-kk\ \-r1.1\ \-r1.2"
هنگام مقایسه ویرایش‌های
.B 1.1
و
.BR 1.2 ،
تفاوت‌ها در مقادیر کلمات کلیدی را نادیده می‌گیرد.
برای جلوگیری از خروجی‌های اضافی ناشی از جایگزینی نام قفل‌کننده،
در صورتی که (۱) حداکثر یک گزینه ویرایش مشخص شده باشد،
(۲) هیچ گزینه
.B \-k
داده نشده باشد،
(۳)
.B \-kkv
حالت پیش‌فرض جایگزینی کلمات کلیدی باشد، و
(۴) حالت فایل کاری از طریق
.BR "co\ \-l"
ایجاد شده باشد، حالت
.B \-kkvl
فرض می‌شود.
برای جزئیات درباره
.BR \-T ،
.BR \-V ،
.B \-x
و
.BR \-z
به
.BR co (1)
مراجعه کنید.
در غیر این صورت، تمام گزینه‌های
.BR diff (1)
که برای فایل‌های معمولی به کار می‌روند، با همان معنای موجود در
.BR diff
پذیرفته می‌شوند.
.PP
اگر هر دو ویرایش
.I rev1
و
.I rev2
حذف شوند (مشخص نشوند)،
.B rcsdiff
آخرین ویرایش روی شاخه پیش‌فرض (به‌طور پیش‌فرض تنه اصلی یا trunk) را با
محتویات فایل کاری متناظر مقایسه می‌کند. این قابلیت برای تعیین تغییراتی که
پس از آخرین ثبت (checkin) ایجاد کرده‌اید بسیار مفید است.
.PP
اگر
.I rev1
داده شود ولی
.I rev2
حذف شود،
.B rcsdiff
ویرایش
.I rev1
از \*o را با محتویات فایل کاری متناظر مقایسه می‌کند.
.PP
اگر هر دو ویرایش
.I rev1
و
.I rev2
داده شوند،
.B rcsdiff
ویرایش‌های
.I rev1
و
.I rev2
از \*o را مقایسه می‌کند.
.PP
هر دو مقدار
.I rev1
و
.I rev2
می‌توانند به‌صورت عددی یا نمادین مشخص شوند.
.SH "مثال‌ها (EXAMPLES)"
دستور
.LP
.B "        rcsdiff  f.c"
.LP
آخرین ویرایش روی شاخه پیش‌فرض \*o را با محتویات فایل کاری
.BR f.c
مقایسه می‌کند.
.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
باشد (که در حال حاضر مقدار پیش‌فرض آن \(lqunlimited\(rq یا نامحدود است)، دستورها آن را در حافظه نگاشت (mmap) یا در حافظه کپی می‌کنند.
در غیر این صورت (یا اگر روش‌های سریع اولیه با شکست مواجه شوند)، دستورها به استفاده از روال‌های استاندارد ورودی/خروجی پس‌گرد (fall back) می‌کنند.
می‌توانید با تنظیم
.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)"
وضعیت خروج در صورت عدم وجود هیچ تفاوتی در طول مقایسه‌ها 0، در صورت وجود تفاوت 1، و در صورت بروز خطا یا مشکل 2 است.
.ds EY 1990, 1991, 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 diff (1),
.BR ident (1),
.BR rcs (1),
.BR rcsmerge (1),
.BR rlog (1).
.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
شامل اخبار و پیوندهایی به آخرین نسخه، پایگاه توسعه و موارد دیگر است.