| HG(ANNOTATE) | HG(ANNOTATE) |
نام (NAME)
hg annotate - نمایش اطلاعات changeset به‌ازای هر خط برای هر فایل
خلاصه دستور (SYNOPSIS)
hg annotate [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...
توضیحات (DESCRIPTION)
تغییرات موجود در فایل‌ها را فهرست می‌کند و شناسهٔ بازبینی (revision id) مسئول هر سطر را نشان می‌دهد.
این دستور برای پی‌بردن به اینکه چه تغییری در چه زمانی و توسط چه کسی اعمال شده، مفید است.
اگر از گزینه‌های --file، --user یا --date استفاده کنید، شمارهٔ بازبینی نمایش داده نخواهد شد مگر اینکه گزینهٔ --number را نیز مشخص کرده باشید.
بدون گزینهٔ -a/--text، دستور annotate از پردازش فایل‌هایی که باینری تشخیص داده شوند خودداری می‌کند. با گزینهٔ -a، حاشیه‌نویسی فایل در هر صورت انجام می‌شود، گرچه نتایج به دست آمده احتمالاً نه مفید خواهند بود و نه مطلوب.
از گزینهٔ -L/--line-range FILE,M:N برای محدود کردن خروجی به سطرهای M تا N در فایل FILE استفاده کنید. این گزینه با --no-follow ناسازگار است و نمی‌توان آن را با آرگومان‌های الگوی فایل ترکیب کرد. هنگام ترکیب با --rev، محدوده‌های سطر به وضعیت فایل در بازبینی درخواست‌شده اشاره خواهند داشت.
قالب:
کلیدواژه‌های زیر علاوه بر کلیدواژه‌ها و توابع متداول قالب‌ها پشتیبانی می‌شوند. همچنین ببینید: hg help templates.
- lines
- فهرست سطرها به همراه داده‌های حاشیه‌نویسی (annotation).
- path
- رشته. مسیر
مطلق مخزن
برای فایل
مشخص‌شده.
همچنین هر مدخل از {lines} علاوه بر {date}، {node}، {rev}، {user} و غیره، زیرکلیدواژه‌های زیر را فراهم می‌کند:
- line
- رشته. محتوای سطر.
- lineno
- عدد صحیح. شماره سطر در آن بازبینی.
- path
- رشته. مسیر
مطلق مخزن
برای فایل
در آن
بازبینی.
برای نحو گسترش فهرست‌ها به hg help templates.operators مراجعه کنید.
در صورت موفقیت مقدار 0 را برمی‌گرداند.
گزینه‌ها (OPTIONS)
- -r,--rev <REV>
- حاشیه‌نویسی بازبینی مشخص‌شده
- --follow
- دنبال کردن کپی‌ها/تغییرنام‌ها و فهرست کردن نام فایل (منسوخ‌شده)
- --no-follow
- کپی‌ها و تغییرنام‌ها دنبال نشوند
- -a, --text
- در نظر گرفتن تمام فایل‌ها به عنوان متن
- -u, --user
- فهرست کردن پدیدآورنده (با -v به صورت کامل)
- -f, --file
- فهرست کردن نام فایل
- -d, --date
- فهرست کردن تاریخ (با -q به صورت کوتاه)
- -n, --number
- فهرست کردن شمارهٔ بازبینی (پیش‌فرض)
- -c, --changeset
- فهرست کردن changeset
- -l, --line-number
- نمایش شمارهٔ سطر در اولین حضور
- --skip <REV[+]>
- دسته‌بازبینی (revset) برای عدم نمایش (آزمایشی)
- -L,--line-range <FILE,RANGE[+]>
- دنبال کردن محدودهٔ سطرهای فایل مشخص‌شده (آزمایشی)
- -w, --ignore-all-space
- نادیده‌گرفتن فاصله‌های خالی هنگام مقایسهٔ سطرها
- -b, --ignore-space-change
- نادیده‌گرفتن تغییرات در میزان فاصله‌های خالی
- -B, --ignore-blank-lines
- نادیده‌گرفتن تغییراتی که تمام سطرهای آن‌ها خالی است
- -Z, --ignore-space-at-eol
- نادیده‌گرفتن تغییرات فاصله‌های خالی در پایان خط (EOL)
- -I,--include <PATTERN[+]>
- شامل کردن نام‌های منطبق با الگوهای مشخص‌شده
- -X,--exclude <PATTERN[+]>
- مستثنی کردن نام‌های منطبق با الگوهای مشخص‌شده
- -T,--template <TEMPLATE>
- نمایش با
استفاده از
قالب
گزینه‌های علامت‌گذاری‌شده با [+] را می‌توان چندین بار تعیین کرد
نام‌های مستعار (ALIASES)
blame