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

                                                                  HG(ANNOTATE)