.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 RCSMERGE 1 "\*(Dt" "GNU RCS \*(Rv"
.SH "نام (NAME)"
rcsmerge \- ادغام بازبینی‌های RCS
.SH "خلاصه دستور (SYNOPSIS)"
.B rcsmerge
.RI [ گزینه‌ها ] " فایل"
.SH "توضیحات (DESCRIPTION)"
دستور
.B rcsmerge
تغییرات میان دو بازبینی از یک \*o را در فایل کاری متناظر ادغام می‌کند.
.PP
نام‌های فایلی که با یک پسوند \*r مطابقت دارند، نشان‌دهندهٔ فایل‌های \*r هستند؛
دیگر نام‌ها نشان‌دهندهٔ فایل‌های کاری می‌باشند.
جفت‌سازی نام‌ها همان‌گونه که در
.BR ci (1)
شرح داده شده، انجام می‌شود.
.PP
حداقل یک بازبینی باید با یکی از گزینه‌هایی که در ادامه شرح داده شده
(معمولاً
.BR \-r \c
) مشخص شود.
حداکثر دو بازبینی را می‌توان مشخص کرد.
اگر تنها یک بازبینی مشخص شود، آخرین بازبینی روی شاخهٔ پیش‌فرض
(معمولاً بالاترین شاخه روی تنهٔ اصلی یا trunk)
برای بازبینی دوم در نظر گرفته می‌شود.
بازبینی‌ها را می‌توان به‌صورت عددی یا نمادین مشخص کرد.
.PP
در صورت وجود تداخل،
.B rcsmerge
یک هشدار چاپ کرده و نواحی دارای هم‌پوشانی را همان‌طور که در
.BR merge (1)
شرح داده شده است، مشخص و علامت‌گذاری می‌کند.
این دستور برای اعمال تغییرات در یک بازبینی دریافت‌شده (checked-out) مفید است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-A
نمایش تداخل‌ها با استفاده از سبک
.B \-A
دستور
.BR diff3 (1)،
در صورتی که توسط
.B diff3
پشتیبانی شود.
این کار تمامی تغییراتی را که از
.I file2
به
.I file3
منتهی می‌شوند در
.I file1
ادغام کرده و پرجزئیات‌ترین خروجی را تولید می‌کند.
.TP
\f3\-E\fP، \f3\-e\fP
این گزینه‌ها سبک‌های تداخلی را مشخص می‌کنند که اطلاعات کمتری نسبت به
.B \-A
تولید می‌نمایند.
برای جزئیات بیشتر به
.BR diff3 (1)
مراجعه کنید.
حالت پیش‌فرض
.B \-E
است.
با گزینهٔ
.BR \-e ،
دستور
.B rcsmerge
دربارهٔ تداخل‌ها هشداری نمی‌دهد.
.TP
.BI \-k subst
استفاده از سبک
.I subst
برای جایگزینی کلیدواژه‌ها.
برای جزئیات به
.BR co (1)
مراجعه کنید.
برای نمونه،
.B "\-kk\ \-r1.1\ \-r1.2"
هنگام ادغام تغییرات از
.B 1.1
به
.BR 1.2 ،
تفاوت مقادیر کلیدواژه‌ها را نادیده می‌گیرد.
معمولاً ادغام فایل‌های باینری به گونه‌ای که گویا متنی هستند، کار درستی نیست؛ بنابراین در صورت استفاده از بسط
.BR \-kb ،
دستور
.B rcsmerge
از ادغام فایل‌ها خودداری می‌کند.
.TP
.BR \-p [\f2rev\fP]
ارسال نتیجه به خروجی استاندارد به جای بازنویسی روی فایل کاری.
.TP
.BR \-q [\f2rev\fP]
اجرای بی‌صدا؛ پیام‌های عیب‌یابی چاپ نمی‌شوند.
.TP
.BR \-r [\f2rev\fP]
ادغام با توجه به بازبینی
.IR rev .
در اینجا خالی بودن
.I rev
به معنای آخرین بازبینی روی شاخهٔ پیش‌فرض (معمولاً head) است.
.TP
.B \-T
این گزینه هیچ تأثیری ندارد؛
صرفاً برای سازگاری با سایر دستورهای \*r وجود دارد.
.TP
.BI \-V
چاپ شماره نسخهٔ \*r.
.TP
.BI \-V n
شبیه‌سازی نسخهٔ
.I n
از \*r.
برای جزئیات به
.BR co (1)
مراجعه کنید.
.TP
.BI \-x "suffixes"
استفاده از
.I suffixes
برای مشخص کردن فایل‌های \*r.
برای جزئیات به
.BR ci (1)
مراجعه کنید.
.TP
.BI \-z zone
استفاده از
.I zone
به عنوان منطقهٔ زمانی برای جایگزینی کلیدواژه‌ها.
برای جزئیات به
.BR co (1)
مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
فرض کنید بازبینی 2.8 از
.B f.c
را منتشر کرده‌اید.
علاوه بر این فرض کنید پس از تکمیل بازبینی منتشرنشدهٔ 3.4،
به‌روزرسانی‌هایی را برای نسخهٔ 2.8 از فرد دیگری دریافت می‌کنید.
برای ترکیب به‌روزرسانی‌های 2.8 و تغییرات خود میان 2.8 و 3.4،
به‌روزرسانی‌های مربوط به 2.8 را در فایل f.c قرار داده و دستور زیر را اجرا کنید:
.LP
.B "    rcsmerge  \-p  \-r2.8  \-r3.4  f.c  >f.merged.c"
.PP
سپس
.B f.merged.c
را بررسی کنید.
همچنین، اگر می‌خواهید به‌روزرسانی‌های 2.8 را در \*o ذخیره کنید،
آن‌ها را به عنوان بازبینی 2.8.1.1 ثبت (check in) کرده و دستور
.B "co \-j"
را اجرا نمایید:
.LP
.B "    ci  \-r2.8.1.1  f.c"
.br
.B "    co  \-r3.4  \-j2.8:2.8.1.1  f.c"
.PP
به عنوان مثالی دیگر، دستور زیر تغییرات میان بازبینی 2.4 و 2.8 را در بازبینی در حال حاضر دریافت‌شدهٔ شما در
.B f.c
لغو (undo) می‌کند.
.LP
.B "    rcsmerge  \-r2.8  \-r2.4  f.c"
.PP
به ترتیب آرگومان‌ها و این نکته که
.B f.c
بازنویسی خواهد شد، توجه داشته باشید.
.SH "محیط (ENVIRONMENT)"
.TP
.B \s-1RCSINIT\s0
گزینه‌هایی که به ابتدای فهرست آرگومان‌ها افزوده شده و با فاصله از هم جدا می‌شوند.
یک بک‌اسلش فاصله‌های درون یک گزینه را گریزدهی (escape) می‌کند.
گزینه‌های
.B \s-1RCSINIT\s0
به ابتدای فهرست آرگومان‌های بیشتر دستورهای \*r اضافه می‌شوند.
گزینه‌های مفید
.B \s-1RCSINIT\s0
شامل
.BR \-q ،
.BR \-V ،
.BR \-x
و
.B \-z
هستند.
.TP
.B \s-1RCS_MEM_LIMIT\s0
به طور معمول برای سرعت بیشتر، در صورتی که اندازهٔ \*o کمتر از
.I memory-limit
باشد، دستورها آن را در حافظه نگاشت (memory map) کرده یا درون حافظه کپی می‌کنند؛ این مقدار در حال حاضر به طور پیش‌فرض \(lqunlimited\(rq (نامحدود) است.
در غیر این صورت (یا در صورتی که روش‌های سریع اولیه با شکست مواجه شوند)،
دستورها به استفاده از روال‌های ورودی/خروجی استاندارد بازمی‌گردند.
می‌توانید با تنظیم
.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
به جای آن بررسی شده و اولین مقدار یافت‌شده استفاده می‌شود؛
اگر هیچ‌یک از آن‌ها تنظیم نشده باشند، یک مقدار پیش‌فرض وابسته به میزبان به کار می‌رود که معمولاً
.B /tmp
است.
.SH "خطاها (DIAGNOSTICS)"
وضعیت خروج در صورت نبود هیچ هم‌پوشانی 0، برای مقداری هم‌پوشانی 1، و در صورت بروز مشکل 2 است.
.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 merge (1),
.BR rcs (1),
.BR rcsdiff (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
شامل اخبار و پیوندهایی به آخرین نسخه، پایگاه توسعه و غیره است.