RCSDIFF(1) General Commands Manual RCSDIFF(1)

rcsdiff - مقایسه ویرایش‌های RCS

rcsdiff [ -ksubst ] [ -q ] [ -rrev1 [ -rrev2 ] ] [ -T ] [ -V[n] ] [ -xsuffixes ] [ -zzone ] [ diff options ] file ...

دستور rcsdiff برای مقایسه دو ویرایش از هر فایل RCS داده‌شده، diff(1) را اجرا می‌کند.

نام‌های فایلی که با یک پسوند RCS مطابقت دارند نشان‌دهنده فایل‌های RCS هستند؛ سایر نام‌ها نشان‌دهنده فایل‌های کاری می‌باشند. نام‌ها همان‌طور که در ci(1) شرح داده شده است، با یکدیگر جفت می‌شوند.

گزینه -q از نمایش خروجی‌های عیب‌یابی جلوگیری می‌کند. با استفاده از -r می‌توان صفر، یک یا دو ویرایش را مشخص کرد. گزینه -ksubst بر جایگزینی کلمات کلیدی هنگام استخراج ویرایش‌ها تأثیر می‌گذارد، همان‌گونه که در co(1) توضیح داده شده است؛ برای نمونه، -kk -r1.1 -r1.2 هنگام مقایسه ویرایش‌های 1.1 و 1.2، تفاوت‌ها در مقادیر کلمات کلیدی را نادیده می‌گیرد. برای جلوگیری از خروجی‌های اضافی ناشی از جایگزینی نام قفل‌کننده، در صورتی که (۱) حداکثر یک گزینه ویرایش مشخص شده باشد، (۲) هیچ گزینه -k داده نشده باشد، (۳) -kkv حالت پیش‌فرض جایگزینی کلمات کلیدی باشد، و (۴) حالت فایل کاری از طریق co -l ایجاد شده باشد، حالت -kkvl فرض می‌شود. برای جزئیات درباره -T، -V، -x و -z به co(1) مراجعه کنید. در غیر این صورت، تمام گزینه‌های diff(1) که برای فایل‌های معمولی به کار می‌روند، با همان معنای موجود در diff پذیرفته می‌شوند.

اگر هر دو ویرایش rev1 و rev2 حذف شوند (مشخص نشوند)، rcsdiff آخرین ویرایش روی شاخه پیش‌فرض (به‌طور پیش‌فرض تنه اصلی یا trunk) را با محتویات فایل کاری متناظر مقایسه می‌کند. این قابلیت برای تعیین تغییراتی که پس از آخرین ثبت (checkin) ایجاد کرده‌اید بسیار مفید است.

اگر rev1 داده شود ولی rev2 حذف شود، rcsdiff ویرایش rev1 از فایل RCS را با محتویات فایل کاری متناظر مقایسه می‌کند.

اگر هر دو ویرایش rev1 و rev2 داده شوند، rcsdiff ویرایش‌های rev1 و rev2 از فایل RCS را مقایسه می‌کند.

هر دو مقدار rev1 و rev2 می‌توانند به‌صورت عددی یا نمادین مشخص شوند.

دستور

rcsdiff f.c

آخرین ویرایش روی شاخه پیش‌فرض فایل RCS را با محتویات فایل کاری f.c مقایسه می‌کند.

گزینه‌هایی که به ابتدای فهرست آرگومان‌ها افزوده شده و با فاصله از یکدیگر جدا می‌شوند. علامت ممیز وارونه (backslash) فاصله‌های درون یک گزینه را گریزدهی (escape) می‌کند. گزینه‌های RCSINIT به ابتدای فهرست آرگومان‌های اکثر دستورهای RCS اضافه می‌شوند. گزینه‌های مفید RCSINIT شامل -q، -V، -x و -z هستند.
به‌طور معمول جهت افزایش سرعت، اگر اندازه فایل RCS کمتر از memory-limit باشد (که در حال حاضر مقدار پیش‌فرض آن “unlimited” یا نامحدود است)، دستورها آن را در حافظه نگاشت (mmap) یا در حافظه کپی می‌کنند. در غیر این صورت (یا اگر روش‌های سریع اولیه با شکست مواجه شوند)، دستورها به استفاده از روال‌های استاندارد ورودی/خروجی پس‌گرد (fall back) می‌کنند. می‌توانید با تنظیم RCS_MEM_LIMIT روی یک مقدار عددی lim (اندازه‌گیری‌شده به کیلوبایت)، این محدودیت حافظه را تنظیم کنید. مقدار خالی بدون خطا نادیده گرفته می‌شود. به عنوان یک اثر جانبی، تعیین کردن RCS_MEM_LIMIT مانع از پس‌گرد به روال‌های کندتر می‌شود.
نام دایرکتوری موقت. در صورت عدم تنظیم، متغیرهای محیطی TMP و TEMP به جای آن بررسی شده و نخستین مقدار یافت‌شده اعمال می‌شود؛ اگر هیچ‌کدام از آن‌ها تنظیم نشده باشند، یک مقدار پیش‌فرض وابسته به سیستم میزبان استفاده می‌شود که معمولاً /tmp است.

وضعیت خروج در صورت عدم وجود هیچ تفاوتی در طول مقایسه‌ها 0، در صورت وجود تفاوت 1، و در صورت بروز خطا یا مشکل 2 است.

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

ci(1), co(1), diff(1), ident(1), rcs(1), rcsmerge(1), rlog(1).

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