نام (NAME)

rcsclean - پاک‌سازی فایل‌های کاری

خلاصه دستور (SYNOPSIS)

rcsclean [options] [ file ... ]

توضیحات (DESCRIPTION)

دستور rcsclean فایل‌هایی را که روی آن‌ها کار نمی‌شود حذف می‌کند. rcsclean -u همچنین فایل‌هایی را که روی آن‌ها کار می‌شود اما تغییری نکرده‌اند باز (قفل‌گشایی) و حذف می‌کند.

به ازای هر file داده‌شده، rcsclean فایل کاری و یک بازبینی را در RCS file متناظر مقایسه می‌کند. اگر تفاوتی بیابد، کاری انجام نمی‌دهد. در غیر این صورت، چنانچه گزینهٔ -u داده شده باشد، ابتدا قفل بازبینی را باز می‌کند و سپس فایل کاری را حذف می‌کند، مگر اینکه فایل کاری قابل نوشتن بوده و بازبینی قفل باشد. این ابزار با چاپ دستورهای متناظر rcs -u و rm -f در خروجی استاندارد، کارهای انجام‌شده را ثبت (لاگ) می‌کند.

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

شمارهٔ بازبینی‌ای که فایل کاری با آن مقایسه می‌شود می‌تواند به هر یک از گزینه‌های -n، -q، -r یا -u ضمیمه شود. اگر شمارهٔ بازبینی مشخص نشده باشد، چنانچه گزینهٔ -u داده شده باشد و فراخواننده یک بازبینی قفل‌شده داشته باشد، rcsclean از آن بازبینی استفاده می‌کند؛ در غیر این صورت rcsclean از آخرین بازبینی در شاخهٔ پیش‌فرض (معمولاً ریشه) استفاده می‌کند.

دستور rcsclean برای هدف‌های clean در makefileها مفید است. همچنین ببینید rcsdiff(1) را که تفاوت‌ها را چاپ می‌کند، و ci(1) را که در صورت تغییر نکردن فایل، به طور معمول به بازبینی پیشین بازمی‌گردد.

گزینه‌ها (OPTIONS)

-ksubst

هنگام واکشی بازبینی برای مقایسه، از شیوهٔ جایگزینی کلیدواژهٔ subst استفاده می‌کند. برای جزئیات به co(1) مراجعه کنید.

-n[rev]

در عمل هیچ فایلی را حذف نکرده و قفل هیچ بازبینی‌ای را باز نمی‌کند. استفاده از این گزینه نشان می‌دهد که rcsclean چه کاری انجام می‌داد بدون اینکه عملاً آن را انجام دهد.

-q[rev]

عملیات انجام‌شده را در خروجی استاندارد ثبت (لاگ) نمی‌کند.

-r[rev]

این گزینه به جز تعیین بازبینی برای مقایسه، تأثیر دیگری ندارد.

-T

زمان ویرایش (modification time) را روی RCS file حفظ می‌کند، حتی اگر RCS file به دلیل باز شدن قفل تغییر کند. این گزینه می‌تواند از کامپایل مجدد گسترده ناشی از وابستگی make(1) نسخهٔ دیگری از فایل کاری به RCS file جلوگیری کند. از این گزینه با احتیاط استفاده کنید؛ چرا که می‌تواند کامپایل مجدد را حتی زمانی که مورد نیاز است متوقف کند، یعنی زمانی که برداشتن قفل به معنای تغییر رشته‌های کلیدواژه در فایل کاری دیگر باشد.

-u[rev]

اگر بازبینی قفل باشد و تفاوتی یافت نشود، قفل آن را باز می‌کند.

-V

شماره نسخهٔ RCS را چاپ می‌کند.

-Vn

نسخهٔ n از RCS را شبیه‌سازی می‌کند. برای جزئیات به co(1) مراجعه کنید.

-xsuffixes

از suffixes برای مشخص کردن RCS file استفاده می‌کند. برای جزئیات به ci(1) مراجعه کنید.

-zzone

از zone به عنوان منطقهٔ زمانی برای جایگزینی کلیدواژه‌ها استفاده می‌کند؛ برای جزئیات به co(1) مراجعه کنید.

مثال‌ها (EXAMPLES)

تمام فایل‌های کاری با پسوند .c یا .h را که از زمان واکشی (checkout) تغییر نکرده‌اند حذف می‌کند.

تمام فایل‌های کاری موجود در دایرکتوری جاری را که از زمان واکشی (checkout) تغییر نکرده‌اند حذف می‌کند.

فایل‌ها (FILES)

دسترسی rcsclean به فایل‌ها تقریباً همانند ci(1) است.

محیط (ENVIRONMENT)

RCSINIT

گزینه‌هایی که به ابتدای فهرست آرگومان‌ها افزوده می‌شوند و با فاصله از یکدیگر تفکیک می‌شوند. یک بک‌اسلش فاصله‌ها را در یک گزینه نادیده می‌گیرد (اسکیپ می‌کند). گزینه‌های RCSINIT به ابتدای فهرست آرگومان‌های اکثر دستورهای RCS افزوده می‌شوند. گزینه‌های مفید RCSINIT شامل -q، -V، -x و -z می‌باشند.

RCS_MEM_LIMIT

معمولاً برای افزایش سرعت، چنانچه اندازهٔ RCS file کمتر از memory-limit باشد، دستورها آن را در حافظه نگاشت (mmap) یا کپی می‌کنند؛ این مقدار در حال حاضر به طور پیش‌فرض “unlimited” (نامحدود) است. در غیر این صورت (یا اگر روش‌های سریع اولیه با شکست مواجه شوند)، دستورها به استفاده از روال‌های ورودی/خروجی استاندارد بازمی‌گردند. می‌توانید با تنظیم RCS_MEM_LIMIT روی یک مقدار عددی lim (بر حسب کیلوبایت)، حد حافظه را تغییر دهید. مقدار خالی بدون هیچ پیامی نادیده گرفته می‌شود. به عنوان یک اثر جانبی، تعیین RCS_MEM_LIMIT از بازگشت به روال‌های کندتر جلوگیری می‌کند.

TMPDIR

نام دایرکتوری موقت. اگر تنظیم نشده باشد، متغیرهای محیطی TMP و TEMP بررسی شده و نخستین مقدار یافت‌شده در نظر گرفته می‌شود؛ اگر هیچ‌کدام تنظیم نشده باشند، یک مقدار پیش‌فرض وابسته به سیستم میزبان (معمولاً /tmp) استفاده می‌شود.

خطاها (DIAGNOSTICS)

وضعیت خروج صفر است اگر و تنها اگر تمام عملیات‌ها با موفقیت انجام شده باشند. فایل‌های کاری و RCS files ناموجود بدون هیچ پیامی نادیده گرفته می‌شوند.

شناسایی (IDENTIFICATION)

نویسنده: 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.

همچنین ببینید (SEE ALSO)

ci(1), co(1), ident(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

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

گزارش باگ‌ها (BUGS)

در نسخه‌های قدیمی‌تر Unix که عملیات مورد نیاز برای پویش دایرکتوری را ارائه نمی‌دهند، باید حداقل یک file داده شود.