.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 file
.if n .ds - \%--
.if t .ds - \(em
.TH RCSCLEAN 1 "\*(Dt" "GNU RCS \*(Rv"
.SH "نام (NAME)"
rcsclean \- پاک‌سازی فایل‌های کاری
.SH "خلاصه دستور (SYNOPSIS)"
.B rcsclean
.RI [ options "] [ " file " .\|.\|. ]"
.SH "توضیحات (DESCRIPTION)"
دستور
.B rcsclean
فایل‌هایی را که روی آن‌ها کار نمی‌شود حذف می‌کند.
.B "rcsclean \-u"
همچنین فایل‌هایی را که روی آن‌ها کار می‌شود اما تغییری نکرده‌اند باز (قفل‌گشایی) و حذف می‌کند.
.PP
به ازای هر
.I file
داده‌شده،
.B rcsclean
فایل کاری و یک بازبینی را در \*o متناظر مقایسه می‌کند. اگر تفاوتی بیابد، کاری انجام نمی‌دهد.
در غیر این صورت، چنانچه گزینهٔ
.B \-u
داده شده باشد، ابتدا قفل بازبینی را باز می‌کند
و سپس فایل کاری را حذف می‌کند،
مگر اینکه فایل کاری قابل نوشتن بوده و بازبینی قفل باشد.
این ابزار با چاپ دستورهای متناظر
.B "rcs \-u"
و
.B "rm \-f"
در خروجی استاندارد، کارهای انجام‌شده را ثبت (لاگ) می‌کند.
.PP
جفت‌سازی فایل‌ها مطابق با توضیحات
.BR ci (1)
انجام می‌شود.
اگر هیچ
.I file
داده نشود، تمام فایل‌های کاری موجود در دایرکتوری جاری پاک‌سازی می‌شوند.
نام‌فایل‌هایی که با پسوند \*r مطابقت دارند، بیانگر \*o هستند؛
سایر نام‌ها بیانگر فایل‌های کاری می‌باشند.
.PP
شمارهٔ بازبینی‌ای که فایل کاری با آن مقایسه می‌شود می‌تواند به هر یک از گزینه‌های
.BR \-n ،
.BR \-q ،
.BR \-r
یا
.BR \-u
ضمیمه شود.
اگر شمارهٔ بازبینی مشخص نشده باشد، چنانچه گزینهٔ
.B \-u
داده شده باشد و فراخواننده یک بازبینی قفل‌شده داشته باشد،
.B rcsclean
از آن بازبینی استفاده می‌کند؛ در غیر این صورت
.B rcsclean
از آخرین بازبینی در شاخهٔ پیش‌فرض (معمولاً ریشه) استفاده می‌کند.
.PP
دستور
.B rcsclean
برای هدف‌های
.B clean
در makefileها مفید است.
همچنین ببینید
.BR rcsdiff (1)
را که تفاوت‌ها را چاپ می‌کند، و
.BR ci (1)
را که در صورت تغییر نکردن فایل، به طور معمول به بازبینی پیشین بازمی‌گردد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-k subst
هنگام واکشی بازبینی برای مقایسه، از شیوهٔ جایگزینی کلیدواژهٔ
.I subst
استفاده می‌کند.
برای جزئیات به
.BR co (1)
مراجعه کنید.
.TP
.BR \-n [\f2rev\fP]
در عمل هیچ فایلی را حذف نکرده و قفل هیچ بازبینی‌ای را باز نمی‌کند.
استفاده از این گزینه نشان می‌دهد که
.B rcsclean
چه کاری انجام می‌داد بدون اینکه عملاً آن را انجام دهد.
.TP
.BR \-q [\f2rev\fP]
عملیات انجام‌شده را در خروجی استاندارد ثبت (لاگ) نمی‌کند.
.TP
.BR \-r [\f2rev\fP]
این گزینه به جز تعیین بازبینی برای مقایسه، تأثیر دیگری ندارد.
.TP
.B \-T
زمان ویرایش (modification time) را روی \*o حفظ می‌کند،
حتی اگر \*o به دلیل باز شدن قفل تغییر کند.
این گزینه می‌تواند از کامپایل مجدد گسترده ناشی از وابستگی
.BR make (1)
نسخهٔ دیگری از فایل کاری به \*o جلوگیری کند.
از این گزینه با احتیاط استفاده کنید؛ چرا که می‌تواند کامپایل مجدد را حتی زمانی که مورد نیاز است متوقف کند،
یعنی زمانی که برداشتن قفل به معنای تغییر رشته‌های کلیدواژه در فایل کاری دیگر باشد.
.TP
.BR \-u [\f2rev\fP]
اگر بازبینی قفل باشد و تفاوتی یافت نشود، قفل آن را باز می‌کند.
.TP
.BI \-V
شماره نسخهٔ \*r را چاپ می‌کند.
.TP
.BI \-V n
نسخهٔ
.IR n
از \*r را شبیه‌سازی می‌کند.
برای جزئیات به
.BR co (1)
مراجعه کنید.
.TP
.BI \-x "suffixes"
از
.I suffixes
برای مشخص کردن \*o استفاده می‌کند.
برای جزئیات به
.BR ci (1)
مراجعه کنید.
.TP
.BI \-z zone
از
.I zone
به عنوان منطقهٔ زمانی برای جایگزینی کلیدواژه‌ها استفاده می‌کند؛
برای جزئیات به
.BR co (1)
مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
.LP
.RS
.ft 3
rcsclean  *.c  *.h
.ft
.RE
.LP
تمام فایل‌های کاری با پسوند
.B .c
یا
.B .h
را که از زمان واکشی (checkout) تغییر نکرده‌اند حذف می‌کند.
.LP
.RS
.ft 3
rcsclean
.ft
.RE
.LP
تمام فایل‌های کاری موجود در دایرکتوری جاری را که از زمان واکشی (checkout) تغییر نکرده‌اند حذف می‌کند.
.SH "فایل‌ها (FILES)"
دسترسی
.B rcsclean
به فایل‌ها تقریباً همانند
.BR ci (1)
است.
.SH "محیط (ENVIRONMENT)"
.TP
.B \s-1RCSINIT\s0
گزینه‌هایی که به ابتدای فهرست آرگومان‌ها افزوده می‌شوند و با فاصله از یکدیگر تفکیک می‌شوند.
یک بک‌اسلش فاصله‌ها را در یک گزینه نادیده می‌گیرد (اسکیپ می‌کند).
گزینه‌های
.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
باشد، دستورها آن را در حافظه نگاشت (mmap) یا کپی می‌کنند؛
این مقدار در حال حاضر به طور پیش‌فرض \(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
بررسی شده و نخستین مقدار یافت‌شده در نظر گرفته می‌شود؛
اگر هیچ‌کدام تنظیم نشده باشند،
یک مقدار پیش‌فرض وابسته به سیستم میزبان (معمولاً
.BR /tmp\c
) استفاده می‌شود.
.SH "خطاها (DIAGNOSTICS)"
وضعیت خروج صفر است اگر و تنها اگر تمام عملیات‌ها با موفقیت انجام شده باشند.
فایل‌های کاری و \*os ناموجود بدون هیچ پیامی نادیده گرفته می‌شوند.
.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 ident (1),
.BR rcs (1),
.BR rcsdiff (1),
.BR rcsmerge (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
دارای اخبار و پیوندهایی به جدیدترین نسخه، سایت توسعه و موارد دیگر است.
.SH "گزارش باگ‌ها (BUGS)"
در نسخه‌های قدیمی‌تر Unix که عملیات مورد نیاز برای پویش دایرکتوری را ارائه نمی‌دهند، باید حداقل یک
.I file
داده شود.
.br