.TH HG LOG  "" "" ""
.SH "نام (NAME)"
hg log \- نمایش تاریخچه بازبینی‌های کل مخزن یا فایل‌ها
.\" Man page generated from reStructuredText.
.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.ft C
hg log [OPTION]... [FILE]
.ft P
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
تاریخچه بازبینی‌های فایل‌های مشخص‌شده یا کل پروژه را چاپ می‌کند.
.sp
اگر بازه‌ای برای بازبینی مشخص نشده باشد، مقدار پیش‌فرض \fBtip:0\fP است مگر آنکه
\-\-follow تنظیم شده باشد.
.sp
تاریخچه فایل بدون دنبال کردن سابقه تغییر نام یا رونوشت فایل‌ها نمایش داده می‌شود.
برای دنبال کردن تاریخچه در میان تغییر نام‌ها و رونوشت‌ها، از \-f/\-\-follow به همراه
یک نام فایل استفاده کنید. استفاده از \-\-follow بدون نام فایل، تنها نیاکان بازبینی‌های
آغازین را نشان می‌دهد. بازبینی‌های آغازین را می‌توان با \-r/\-\-rev مشخص کرد،
که مقدار پیش‌فرض آن والد دایرکتوری کاری است.
.sp
به طور پیش‌فرض این دستور شماره بازبینی و شناسه changeset، برچسب‌ها (tags)،
والدین غیربدیهی، کاربر، تاریخ و زمان، و خلاصه‌ای از هر کامیت را چاپ می‌کند.
هنگامی که سوییچ \-v/\-\-verbose استفاده شود، فهرست فایل‌های تغییریافته و پیام
کامل کامیت نمایش داده می‌شوند.
.sp
با گزینه \-\-graph بازبینی‌ها به صورت یک گراف جهت‌دار بدون دور (DAG) با هنر ASCII
نمایش داده می‌شوند که تازه‌ترین changeset در بالای آن قرار دارد.
کاراکتر \(aqo\(aq یک changeset است، \(aq@\(aq والد دایرکتوری کاری است، \(aq%\(aq یک changeset
درگیر در تداخل ادغام حل‌نشده است، \(aq_\(aq یک شاخه را می‌بندد،
\(aqx\(aq منسوخ است، \(aq*\(aq ناپایدار است، و \(aq+\(aq نشان‌دهنده یک انشعاب (fork) است که در آن
changeset خطوط پایین‌تر، والد ادغام \(aqo\(aq در همان خط می‌باشد.
مسیرها در DAG با کاراکترهای \(aq|\(aq، \(aq/\(aq و مانند آن‌ها نشان داده می‌شوند. کاراکتر \(aq:\(aq
به جای \(aq|\(aq نشان می‌دهد که یک یا چند بازبینی در یک مسیر حذف شده‌اند.
.sp
از گزینه‌های \-L/\-\-line\-range FILE,M:N برای دنبال کردن تاریخچه خطوط M تا N در
FILE استفاده کنید. با گزینه \-p/\-\-patch تنها قطعات diff اثرگذار بر بازه خطوط مشخص‌شده
نمایش داده خواهند شد. این گزینه نیازمند \-\-follow است؛ و می‌توان آن را چندین بار
مشخص کرد. در حال حاضر، این گزینه با \-\-graph سازگار نیست. این گزینه آزمایشی است.
.IP نکته
.
دستور \%\fBhg log \-\-patch\fP\: ممکن است خروجی diff غیرمنتظره‌ای برای changesetهای ادغام
تولید کند، زیرا فقط changeset ادغام را با والد نخست آن مقایسه می‌کند. همچنین،
تنها فایل‌هایی در :files ظاهر می‌شوند که با هر دو والد متفاوت باشند.
.RE
.IP نکته
.
به دلایل کارایی، \%\fBhg log FILE\fP\: ممکن است تغییرات تکراری ایجادشده در شاخه‌ها را
نادیده بگیرد و موارد حذف یا تغییر حالت (mode changes) را نمایش ندهد. برای دیدن
تمام این تغییرات، از سوییچ \-\-removed استفاده کنید.
.RE
.IP نکته
.
تاریخچه حاصل از گزینه‌های \-L/\-\-line\-range به گزینه‌های diff بستگی دارد؛ به عنوان مثال
اگر فاصله‌های خالی (white\-spaces) نادیده گرفته شوند، تغییرات مربوطه‌ای که فقط شامل فاصله‌های
خالی در بازه خطوط مشخص‌شده هستند فهرست نخواهند شد.
.RE
.sp
چند مثال:
.INDENT 0.0
.IP \(bu 2
.
مجموعه‌های تغییرات با توضیحات کامل و فهرست فایل‌ها:
.sp
.nf
.ft C
hg log \-v
.ft P
.fi
.IP \(bu 2
.
مجموعه‌های تغییرات نیاکان دایرکتوری کاری:
.sp
.nf
.ft C
hg log \-f
.ft P
.fi
.IP \(bu 2
.
۱۰ کامیت آخر در شاخه فعلی:
.sp
.nf
.ft C
hg log \-l 10 \-b .
.ft P
.fi
.IP \(bu 2
.
مجموعه‌های تغییراتی که تمامی اصلاحات یک فایل، از جمله موارد حذفی را نمایش می‌دهند:
.sp
.nf
.ft C
hg log \-\-removed file.c
.ft P
.fi
.IP \(bu 2
.
تمام مجموعه‌های تغییراتی که به یک دایرکتوری مربوط می‌شوند، همراه با diffها، به استثنای ادغام‌ها:
.sp
.nf
.ft C
hg log \-Mp lib/
.ft P
.fi
.IP \(bu 2
.
تمام شماره‌های بازبینی منطبق با یک کلیدواژه:
.sp
.nf
.ft C
hg log \-k bug \-\-template "{rev}\en"
.ft P
.fi
.IP \(bu 2
.
شناسه هش کامل والد دایرکتوری کاری:
.sp
.nf
.ft C
hg log \-r . \-\-template "{node}\en"
.ft P
.fi
.IP \(bu 2
.
فهرست کردن قالب‌های لاگ موجود:
.sp
.nf
.ft C
hg log \-T list
.ft P
.fi
.IP \(bu 2
.
بررسی اینکه آیا یک changeset مشخص در یک انتشار برچسب‌خورده وجود دارد یا خیر:
.sp
.nf
.ft C
hg log \-r "a21ccf and ancestor(1.9)"
.ft P
.fi
.IP \(bu 2
.
یافتن تمام مجموعه‌های تغییرات توسط یک کاربر در یک بازه زمانی مشخص:
.sp
.nf
.ft C
hg log \-k alice \-d "may 2008 to jul 2008"
.ft P
.fi
.IP \(bu 2
.
خلاصه تمام مجموعه‌های تغییرات پس از آخرین برچسب:
.sp
.nf
.ft C
hg log \-r "last(tagged())::" \-\-template "{desc|firstline}\en"
.ft P
.fi
.IP \(bu 2
.
مجموعه‌های تغییرات مؤثر بر خطوط ۱۳ تا ۲۳ در file.c:
.sp
.nf
.ft C
hg log \-L file.c,13:23
.ft P
.fi
.IP \(bu 2
.
مجموعه‌های تغییرات مؤثر بر خطوط ۱۳ تا ۲۳ در file.c و خطوط ۲ تا ۶ در
main.c به همراه وصله (patch):
.sp
.nf
.ft C
hg log \-L file.c,13:23 \-L main.c,2:6 \-p
.ft P
.fi
.UNINDENT
.sp
برای فهرستی از قالب‌های معتبر برای \-d/\-\-date، به \%\fBhg help dates\fP\: مراجعه کنید.
.sp
برای اطلاعات بیشتر در مورد مشخص کردن و مرتب‌سازی بازبینی‌ها، به \%\fBhg help revisions\fP\: مراجعه کنید.
.sp
برای اطلاعات بیشتر درباره سبک‌های از پیش بسته‌بندی‌شده و مشخص کردن قالب‌های سفارشی، به
\%\fBhg help templates\fP\: مراجعه کنید. قالب پیش‌فرضی که توسط دستور log استفاده می‌شود را
می‌توان از طریق تنظیم پیکربندی \fBcommand\-templates.log\fP سفارشی‌سازی کرد.
.sp
در صورت موفقیت، 0 را برمی‌گرداند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-f,  \-\-follow
.
دنبال کردن تاریخچه changeset، یا تاریخچه فایل در میان رونوشت‌ها و تغییر نام‌ها
.TP
.B \-\-follow\-first
.
تنها دنبال کردن والد نخست changesetهای ادغام (منسوخ‌شده)
.TP
.BI \-d,  \-\-date \ <DATE>
.
نمایش بازبینی‌های منطبق با مشخصات تاریخ
.TP
.B \-C,  \-\-copies
.
نمایش فایل‌های رونوشت‌شده
.TP
.BI \-k,  \-\-keyword \ <TEXT[+]>
.
انجام جستجوی غیرحساس به بزرگی و کوچکی حروف برای یک متن مشخص
.TP
.BI \-r,  \-\-rev \ <REV[+]>
.
بازبینی‌ها برای انتخاب یا دنبال کردن از آن‌ها
.TP
.BI \-L,  \-\-line\-range \ <FILE,RANGE[+]>
.
دنبال کردن بازه خطوط فایل مشخص‌شده (آزمایشی)
.TP
.B \-\-removed
.
شامل کردن بازبینی‌هایی که در آن‌ها فایل‌ها حذف شده‌اند
.TP
.B \-m,  \-\-only\-merges
.
نمایش تنها ادغام‌ها (منسوخ‌شده) (به جای آن از \-r "merge()" استفاده کنید)
.TP
.BI \-u,  \-\-user \ <USER[+]>
.
بازبینی‌های کامیت‌شده توسط کاربر
.TP
.BI \-\-only\-branch \ <BRANCH[+]>
.
نمایش تنها changesetهای درون شاخه نام‌گذاری‌شده مشخص (منسوخ‌شده)
.TP
.BI \-b,  \-\-branch \ <BRANCH[+]>
.
نمایش changesetهای درون شاخه نام‌گذاری‌شده مشخص
.TP
.BI \-B,  \-\-bookmark \ <BOOKMARK[+]>
.
نمایش changesetهای درون نشانک مشخص
.TP
.BI \-P,  \-\-prune \ <REV[+]>
.
عدم نمایش بازبینی یا هر یک از نیاکان آن
.TP
.B \-p,  \-\-patch
.
نمایش وصله (patch)
.TP
.B \-g,  \-\-git
.
استفاده از قالب diff گسترش‌یافته git
.TP
.BI \-l,  \-\-limit \ <NUM>
.
محدود کردن تعداد تغییرات نمایش‌داده‌شده
.TP
.B \-M,  \-\-no\-merges
.
عدم نمایش ادغام‌ها
.TP
.B \-\-stat
.
خروجی خلاصه تغییرات به سبک diffstat
.TP
.B \-G,  \-\-graph
.
نمایش DAG بازبینی‌ها
.TP
.BI \-\-style \ <STYLE>
.
نمایش با استفاده از فایل نگاشت قالب (منسوخ‌شده)
.TP
.BI \-T,  \-\-template \ <TEMPLATE>
.
نمایش با قالب
.TP
.BI \-I,  \-\-include \ <PATTERN[+]>
.
شامل کردن نام‌های منطبق با الگوهای مشخص‌شده
.TP
.BI \-X,  \-\-exclude \ <PATTERN[+]>
.
مستثنی کردن نام‌های منطبق با الگوهای مشخص‌شده
.UNINDENT
.sp
گزینه‌های مشخص‌شده با علامت [+] را می‌توان چندین بار تعیین کرد
.SH "نام‌های مستعار (ALIASES)"
.sp
.nf
.ft C
history
.ft P
.fi
.\" Generated by docutils manpage writer.
.\" 
.