نام (NAME)

rlog - چاپ پیام‌های گزارش و سایر اطلاعات دربارهٔ فایل‌های RCS

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

rlog [ options ] file ...

توضیحات (DESCRIPTION)

rlog اطلاعات مربوط به فایل‌های RCS را چاپ می‌کند.

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

rlog اطلاعات زیر را برای هر فایل RCS چاپ می‌کند: نام فایل RCS، نام فایل کاری، head (یعنی شمارهٔ آخرین بازبینی روی شاخهٔ اصلی)، شاخهٔ پیش‌فرض، فهرست دسترسی، قفل‌ها، نام‌های نمادین، پسوند، تعداد کل بازبینی‌ها، تعداد بازبینی‌های انتخاب‌شده برای چاپ، و متن توصیفی. سپس ورودی‌های مربوط به بازبینی‌های انتخاب‌شده به ترتیب زمانی معکوس برای هر شاخه می‌آیند. برای هر بازبینی، rlog شمارهٔ بازبینی، پدیدآورنده، تاریخ/زمان، وضعیت، تعداد خطوط اضافه‌شده/حذف‌شده (نسبت به بازبینی قبلی)، قفل‌کنندهٔ بازبینی (در صورت وجود)، و پیام گزارش را چاپ می‌کند. همهٔ زمان‌ها به‌طور پیش‌فرض در زمان هماهنگ جهانی (UTC) نمایش داده می‌شوند؛ این مورد را می‌توان با -z تغییر داد. بدون گزینه‌ها، rlog اطلاعات کامل را چاپ می‌کند. گزینه‌های زیر این خروجی را محدود می‌کنند.

-L: نادیده گرفتن فایل‌های RCS که هیچ قفلی روی آن‌ها تنظیم نشده است. این گزینه در ترکیب با -h، -l و -R بسیار سودمند است.
-R: تنها نام فایل RCS را چاپ می‌کند. این گزینه برای تبدیل نام یک فایل کاری به نام یک فایل RCS مناسب است.
-h: تنها نام فایل RCS، نام فایل کاری، head، شاخهٔ پیش‌فرض، فهرست دسترسی، قفل‌ها، نام‌های نمادین، و پسوند را چاپ می‌کند.
-t: همان اطلاعات -h، به همراه متن توصیفی را چاپ می‌کند.
-N: نام‌های نمادین را چاپ نمی‌کند.
-b: اطلاعات مربوط به بازبینی‌های روی شاخهٔ پیش‌فرض (معمولاً بالاترین شاخه روی شاخهٔ اصلی یا trunk) را چاپ می‌کند.
-ddates: اطلاعات مربوط به بازبینی‌هایی با تاریخ/زمان ثبت در محدوده‌های ارائه‌شده در فهرست جداشده با نقطه-ویرگولِ dates را چاپ می‌کند. محدوده‌ای به شکل d1<d2 یا d2>d1 بازبینی‌هایی را انتخاب می‌کند که بین d1 و d2 (بدون احتساب خود آن‌ها) ثبت شده‌اند. محدوده‌ای به شکل <d یا d> تمام بازبینی‌های قدیمی‌تر از d را انتخاب می‌کند. محدوده‌ای به شکل d< یا >d تمام بازبینی‌های با تاریخ جدیدتر از d را انتخاب می‌کند. اگر پس از < یا > نویسهٔ = بیاید، محدوده‌ها شامل مرزها (inclusive) خواهند بود، نه غیرشامل (exclusive). محدوده‌ای به شکل d تنها آخرین بازبینی با تاریخ d یا پیش از آن را انتخاب می‌کند. رشته‌های تاریخ/زمان d، d1 و d2 در قالب آزادی هستند که در co(1) توضیح داده شده است. معمولاً نقل‌قول کردن (قرار دادن درون گیومه) لازم است، به‌ویژه برای < و >. توجه داشته باشید که جداکننده یک نقطه-ویرگول است.
-l[lockers]: تنها اطلاعات مربوط به بازبینی‌های قفل‌شده را چاپ می‌کند. علاوه بر این، اگر فهرست جداشده با کاما از نام‌های ورود کاربران در lockers ارائه شود، تمام قفل‌ها به جز آن‌هایی که توسط lockers نگه‌داشته شده‌اند نادیده گرفته می‌شوند. برای نمونه، rlog -L -R -lwft RCS/* نام فایل‌های RCS قفل‌شده توسط کاربر wft را چاپ می‌کند.
-r[revisions]: اطلاعات مربوط به بازبینی‌های ارائه‌شده در فهرست جداشده با کامای revisions از بازبینی‌ها و محدوده‌ها را چاپ می‌کند. یک محدوده به شکل rev1:rev2 به معنی بازبینی‌های rev1 تا rev2 روی همان شاخه است؛ :rev به معنی بازبینی‌ها از ابتدای شاخه تا و شامل rev است؛ و rev: به معنی بازبینی‌ها با شروع از rev تا انتهای شاخهٔ حاوی rev می‌باشد. آرگومانی که نشان‌دهندهٔ یک شاخه باشد به معنی تمام بازبینی‌های روی آن شاخه است. محدوده‌ای از شاخه‌ها به معنی تمام بازبینی‌های روی شاخه‌های موجود در آن محدوده است. یک شاخه که پس از آن یک . بیاید، به معنی آخرین بازبینی در آن شاخه است. استفاده از -r به‌تنهایی بدون هیچ revisions به معنی آخرین بازبینی روی شاخهٔ پیش‌فرض (معمولاً شاخهٔ اصلی یا trunk) است.
-sstates: اطلاعات مربوط به بازبینی‌هایی را چاپ می‌کند که صفت وضعیت آن‌ها با یکی از وضعیت‌های ارائه‌شده در فهرست جداشده با کامای states مطابقت داشته باشد.
-w[logins]: اطلاعات مربوط به بازبینی‌های ثبت‌شده توسط کاربرانی را چاپ می‌کند که نام‌های ورود آن‌ها در فهرست جداشده با کامای logins آمده باشد. اگر logins حذف شود، نام ورود کاربر جاری در نظر گرفته می‌شود..TP -q این گزینه هیچ تأثیری ندارد؛ برای سازگاری با سایر دستورها ارائه شده است.
-T: این گزینه هیچ تأثیری ندارد؛ برای سازگاری با سایر دستورهای RCS وجود دارد.
-V: شماره نسخهٔ RCS را چاپ می‌کند.
-Vn: هنگام تولید لاگ‌ها، نسخهٔ n از RCS را شبیه‌سازی می‌کند. برای اطلاعات بیشتر co(1) را ببینید.
-xsuffixes: از suffixes برای مشخص کردن فایل RCSs استفاده می‌کند. برای جزئیات بیشتر ci(1) را ببینید.

دستور rlog اشتراک بازبینی‌های انتخاب‌شده با گزینه‌های -d، -l، -s و -w را در تقاطع با اجتماع بازبینی‌های انتخاب‌شده توسط -b و -r چاپ می‌کند.

-zzone: قالب خروجی تاریخ را مشخص می‌کند، و منطقهٔ زمانی پیش‌فرض را برای date در گزینهٔ -ddates تعیین می‌نماید. مقدار zone باید خالی، یک آفست عددی از UTC، یا رشتهٔ ویژهٔ LT برای زمان محلی باشد. حالت پیش‌فرض یک zone خالی است که از قالب سنتی RCS برای UTC بدون هیچ نشانه‌ای از منطقهٔ زمانی و با استفاده از اسلش برای جداسازی بخش‌های تاریخ استفاده می‌کند؛ در غیر این صورت، زمان‌ها در قالب ISO 8601 همراه با مشخصهٔ منطقهٔ زمانی چاپ می‌شوند. به‌عنوان مثال، اگر زمان محلی ۱۱ ژانویه ۱۹۹۰، ساعت ۲۰:۰۰ به وقت استاندارد اقیانوس آرام (Pacific Standard Time)، هشت ساعت در غرب UTC باشد، آنگاه زمان به صورت زیر در خروجی نمایش داده می‌شود:

option	time output
-z	1990/01/12 04:00:00	(default)
-zLT	1990-01-11 20:00:00-08
-z+05:30	1990-01-12 09:30:00+05:30

مثال‌ها (EXAMPLES)

    rlog  -L  -R  RCS/*
    rlog  -L  -h  RCS/*
    rlog  -L  -l  RCS/*
    rlog  RCS/*

دستور نخست، نام تمام فایل RCSs موجود در زیردایرکتوری RCS را که دارای قفل هستند چاپ می‌کند. دستور دوم سرآیند آن فایل‌ها را چاپ می‌کند، و دستور سوم علاوه بر سرآیندها، پیام‌های لاگ بازبینی‌های قفل‌شده را چاپ می‌نماید. دستور آخر اطلاعات کامل را چاپ می‌کند..SH "محیط (ENVIRONMENT)"

RCSINIT: گزینه‌هایی که با فاصله از هم جدا شده و به ابتدای فهرست آرگومان‌ها افزوده می‌شوند. یک بک‌اسلش (backslash) فاصله‌های درون یک گزینه را گریزدهی (escape) می‌کند. گزینه‌های RCSINIT به ابتدای فهرست آرگومان‌های اکثر دستورهای RCS اضافه می‌شوند. گزینه‌های مفید RCSINIT شامل -q، -V، -x و -z هستند.
RCS_MEM_LIMIT: به‌طور معمول برای سرعت بیشتر، چنانچه اندازهٔ فایل RCS کمتر از memory-limit باشد، دستورها آن را در حافظه نگاشت (memory map) کرده یا در حافظه کپی می‌کنند؛ مقدار پیش‌فرض آن در حال حاضر «نامحدود» (``unlimited'') است. در غیر این صورت (یا اگر روش‌های سریع اولیه با شکست مواجه شوند)، دستورها به استفاده از روال‌های استاندارد ورودی/خروجی (I/O) بازمی‌گردند. می‌توانید محدودیت حافظه را با تنظیم RCS_MEM_LIMIT روی یک مقدار عددی lim (برحسب کیلوبایت) مشخص کنید. مقدار خالی بدون هیچ پیامی نادیده گرفته می‌شود. به عنوان یک اثر جانبی، تعیین کردن RCS_MEM_LIMIT مانع از بازگشت به روال‌های کندتر می‌شود.
TMPDIR: نام دایرکتوری موقت. اگر تنظیم نشده باشد، متغیرهای محیطی TMP و TEMP به جای آن بررسی شده و نخستین مقدار یافت‌شده اعمال می‌شود؛ اگر هیچ‌یک از آن‌ها تنظیم نشده باشند، یک مقدار پیش‌فرض وابسته به میزبان استفاده می‌شود که معمولاً /tmp است.

خطاها (DIAGNOSTICS)

وضعیت خروج تنها در صورتی صفر است که تمام عملیات‌ها موفقیت‌آمیز بوده باشند.

شناسه (IDENTIFICATION)

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

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

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

شامل اخبار و پیوندهایی به آخرین نسخه، سایت توسعه و موارد دیگر است..SH "گزارش باگ‌ها (BUGS)" جداکنندهٔ بازه‌های بازنگری در گزینهٔ -r پیش‌تر به‌جای :، - بود؛ اما این امر زمانی که نام‌های نمادین حاوی - باشند منجر به سردرگمی می‌شود. برای سازگاری رو به عقب، rlog -r همچنان از جداکنندهٔ قدیمی - پشتیبانی می‌کند، اما دربارهٔ این استفادهٔ منسوخ هشدار می‌دهد.