HG(LOG)                                                                HG(LOG)

نام (NAME)
       hg log - نمایش تاریخچه بازبینی‌های کل مخزن یا فایل‌ها

خلاصه دستور (SYNOPSIS)
       hg log [OPTION]... [FILE]

توضیحات (DESCRIPTION)
       تاریخچه بازبینی‌های فایل‌های مشخص‌شده یا کل پروژه را چاپ می‌کند.

       اگر بازه‌ای برای بازبینی مشخص نشده باشد، مقدار پیش‌فرض tip:0 است مگر آنکه
       --follow تنظیم شده باشد.

       تاریخچه فایل بدون دنبال کردن سابقه تغییر نام یا رونوشت فایل‌ها نمایش
       داده می‌شود.  برای دنبال کردن تاریخچه در میان تغییر نام‌ها و رونوشت‌ها، از
       -f/--follow به همراه یک نام فایل استفاده کنید. استفاده از --follow بدون
       نام فایل، تنها نیاکان بازبینی‌های آغازین را نشان می‌دهد. بازبینی‌های
       آغازین را می‌توان با -r/--rev مشخص کرد، که مقدار پیش‌فرض آن والد
       دایرکتوری کاری است.

       به طور پیش‌فرض این دستور شماره بازبینی و شناسه changeset، برچسب‌ها
       (tags)، والدین غیربدیهی، کاربر، تاریخ و زمان، و خلاصه‌ای از هر کامیت را
       چاپ می‌کند.  هنگامی که سوییچ -v/--verbose استفاده شود، فهرست فایل‌های
       تغییریافته و پیام کامل کامیت نمایش داده می‌شوند.

       با گزینه --graph بازبینی‌ها به صورت یک گراف جهت‌دار بدون دور (DAG) با هنر
       ASCII نمایش داده می‌شوند که تازه‌ترین changeset در بالای آن قرار دارد.
       کاراکتر 'o' یک changeset است، '@' والد دایرکتوری کاری است، '%' یک
       changeset درگیر در تداخل ادغام حل‌نشده است، '_' یک شاخه را می‌بندد، 'x'
       منسوخ است، '*' ناپایدار است، و '+' نشان‌دهنده یک انشعاب (fork) است که در
       آن changeset خطوط پایین‌تر، والد ادغام 'o' در همان خط می‌باشد.  مسیرها در
       DAG با کاراکترهای '|'، '/' و مانند آن‌ها نشان داده می‌شوند. کاراکتر ':'
       به جای '|' نشان می‌دهد که یک یا چند بازبینی در یک مسیر حذف شده‌اند.

       از گزینه‌های -L/--line-range FILE,M:N برای دنبال کردن تاریخچه خطوط M تا
       N در FILE استفاده کنید. با گزینه -p/--patch تنها قطعات diff اثرگذار بر
       بازه خطوط مشخص‌شده نمایش داده خواهند شد. این گزینه نیازمند --follow است؛
       و می‌توان آن را چندین بار مشخص کرد. در حال حاضر، این گزینه با --graph
       سازگار نیست. این گزینه آزمایشی است.

       نکته   دستور hg log --patch ممکن است خروجی diff غیرمنتظره‌ای برای
              changesetهای ادغام تولید کند، زیرا فقط changeset ادغام را با
              والد نخست آن مقایسه می‌کند. همچنین، تنها فایل‌هایی در :files ظاهر
              می‌شوند که با هر دو والد متفاوت باشند.

       نکته   به دلایل کارایی، hg log FILE ممکن است تغییرات تکراری ایجادشده در
              شاخه‌ها را نادیده بگیرد و موارد حذف یا تغییر حالت (mode changes)
              را نمایش ندهد. برای دیدن تمام این تغییرات، از سوییچ --removed
              استفاده کنید.

       نکته   تاریخچه حاصل از گزینه‌های -L/--line-range به گزینه‌های diff بستگی
              دارد؛ به عنوان مثال اگر فاصله‌های خالی (white-spaces) نادیده
              گرفته شوند، تغییرات مربوطه‌ای که فقط شامل فاصله‌های خالی در بازه
              خطوط مشخص‌شده هستند فهرست نخواهند شد.

       چند مثال:

       • مجموعه‌های تغییرات با توضیحات کامل و فهرست فایل‌ها:

         hg log -v

       • مجموعه‌های تغییرات نیاکان دایرکتوری کاری:

         hg log -f

       • ۱۰ کامیت آخر در شاخه فعلی:

         hg log -l 10 -b .

       • مجموعه‌های تغییراتی که تمامی اصلاحات یک فایل، از جمله موارد حذفی را
         نمایش می‌دهند:

         hg log --removed file.c

       • تمام مجموعه‌های تغییراتی که به یک دایرکتوری مربوط می‌شوند، همراه با
         diffها، به استثنای ادغام‌ها:

         hg log -Mp lib/

       • تمام شماره‌های بازبینی منطبق با یک کلیدواژه:

         hg log -k bug --template "{rev}\n"

       • شناسه هش کامل والد دایرکتوری کاری:

         hg log -r . --template "{node}\n"

       • فهرست کردن قالب‌های لاگ موجود:

         hg log -T list

       • بررسی اینکه آیا یک changeset مشخص در یک انتشار برچسب‌خورده وجود دارد
         یا خیر:

         hg log -r "a21ccf and ancestor(1.9)"

       • یافتن تمام مجموعه‌های تغییرات توسط یک کاربر در یک بازه زمانی مشخص:

         hg log -k alice -d "may 2008 to jul 2008"

       • خلاصه تمام مجموعه‌های تغییرات پس از آخرین برچسب:

         hg log -r "last(tagged())::" --template "{desc|firstline}\n"

       • مجموعه‌های تغییرات مؤثر بر خطوط ۱۳ تا ۲۳ در file.c:

         hg log -L file.c,13:23

       • مجموعه‌های تغییرات مؤثر بر خطوط ۱۳ تا ۲۳ در file.c و خطوط ۲ تا ۶ در
         main.c به همراه وصله (patch):

         hg log -L file.c,13:23 -L main.c,2:6 -p

         برای فهرستی از قالب‌های معتبر برای -d/--date، به hg help dates مراجعه
         کنید.

         برای اطلاعات بیشتر در مورد مشخص کردن و مرتب‌سازی بازبینی‌ها، به hg help
         revisions مراجعه کنید.

         برای اطلاعات بیشتر درباره سبک‌های از پیش بسته‌بندی‌شده و مشخص کردن
         قالب‌های سفارشی، به hg help templates مراجعه کنید. قالب پیش‌فرضی که
         توسط دستور log استفاده می‌شود را می‌توان از طریق تنظیم پیکربندی
         command-templates.log سفارشی‌سازی کرد.

         در صورت موفقیت، 0 را برمی‌گرداند.

گزینه‌ها (OPTIONS)
       -f, --follow
              دنبال کردن تاریخچه changeset، یا تاریخچه فایل در میان رونوشت‌ها و
              تغییر نام‌ها

       --follow-first
              تنها دنبال کردن والد نخست changesetهای ادغام (منسوخ‌شده)

       -d,--date <DATE>
              نمایش بازبینی‌های منطبق با مشخصات تاریخ

       -C, --copies
              نمایش فایل‌های رونوشت‌شده

       -k,--keyword <TEXT[+]>
              انجام جستجوی غیرحساس به بزرگی و کوچکی حروف برای یک متن مشخص

       -r,--rev <REV[+]>
              بازبینی‌ها برای انتخاب یا دنبال کردن از آن‌ها

       -L,--line-range <FILE,RANGE[+]>
              دنبال کردن بازه خطوط فایل مشخص‌شده (آزمایشی)

       --removed
              شامل کردن بازبینی‌هایی که در آن‌ها فایل‌ها حذف شده‌اند

       -m, --only-merges
              نمایش تنها ادغام‌ها (منسوخ‌شده) (به جای آن از -r "merge()" استفاده
              کنید)

       -u,--user <USER[+]>
              بازبینی‌های کامیت‌شده توسط کاربر

       --only-branch <BRANCH[+]>
              نمایش تنها changesetهای درون شاخه نام‌گذاری‌شده مشخص (منسوخ‌شده)

       -b,--branch <BRANCH[+]>
              نمایش changesetهای درون شاخه نام‌گذاری‌شده مشخص

       -B,--bookmark <BOOKMARK[+]>
              نمایش changesetهای درون نشانک مشخص

       -P,--prune <REV[+]>
              عدم نمایش بازبینی یا هر یک از نیاکان آن

       -p, --patch
              نمایش وصله (patch)

       -g, --git
              استفاده از قالب diff گسترش‌یافته git

       -l,--limit <NUM>
              محدود کردن تعداد تغییرات نمایش‌داده‌شده

       -M, --no-merges
              عدم نمایش ادغام‌ها

       --stat خروجی خلاصه تغییرات به سبک diffstat

       -G, --graph
              نمایش DAG بازبینی‌ها

       --style <STYLE>
              نمایش با استفاده از فایل نگاشت قالب (منسوخ‌شده)

       -T,--template <TEMPLATE>
              نمایش با قالب

       -I,--include <PATTERN[+]>
              شامل کردن نام‌های منطبق با الگوهای مشخص‌شده

       -X,--exclude <PATTERN[+]>
              مستثنی کردن نام‌های منطبق با الگوهای مشخص‌شده

              گزینه‌های مشخص‌شده با علامت [+] را می‌توان چندین بار تعیین کرد

نام‌های مستعار (ALIASES)
       history

                                                                       HG(LOG)