.TH HG GREP  "" "" ""
.SH "نام (NAME)"
hg grep \- جستجو برای یک الگو در فایل‌های مشخص‌شده
.\" Man page generated from reStructuredText.
.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
.ft C
hg grep [\-\-diff] [OPTION]... PATTERN [FILE]...
.ft P
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
جستجوی یک عبارت باقاعده در فایل‌های مشخص‌شده در کل مخزن، در دایرکتوری کاری یا تاریخچهٔ بازبینی‌ها.
.sp
به‌طور پیش‌فرض، grep فایل‌های مخزن را در دایرکتوری کاری جستجو می‌کند و نام فایل‌هایی را که تطابقی در آن‌ها پیدا شود چاپ می‌کند. برای مشخص کردن بازبینی‌های تاریخی به جای دایرکتوری کاری، از پرچم \-\-rev استفاده کنید.
.sp
برای جستجو در تغییرات بازبینی‌های تاریخی که شامل تغییری در وضعیت تطابق هستند (علامت «\-» برای تطابقی که به عدم تطابق تبدیل می‌شود، یا «+» برای عدم تطابقی که به تطابق تبدیل می‌شود)، از پرچم \-\-diff استفاده کنید.
.sp
مقدار PATTERN می‌تواند هر عبارت باقاعدهٔ پایتون (تقریباً سازگار با Perl) باشد.
.sp
اگر هیچ فایلی (FILE) مشخص نشود و پرچم \-\-rev داده نشود، همهٔ فایل‌های دایرکتوری کاری جستجو می‌شوند. هنگام استفاده از پرچم \-\-rev و مشخص کردن FILEها، از آرگومان \-\-follow برای دنبال کردن فایل‌های مشخص‌شده در میان تغییر نام‌ها و رونوشت‌ها استفاده کنید.
.sp
قالب (Template):
.sp
کلمات کلیدی زیر علاوه بر کلمات کلیدی و توابع رایج قالب‌ها پشتیبانی می‌شوند. همچنین \%\fBhg help templates\fP\: را ببینید.
.INDENT 0.0
.TP
.B change
.
رشته. نویسه‌ای نشان‌دهندهٔ درج \fB+\fP یا حذف \fB\-\fP. در صورت مشخص شدن \fB\-\-diff\fP در دسترس است.
.TP
.B lineno
.
عدد صحیح. شماره خط مورد منطبق.
.TP
.B path
.
رشته. مسیر مطلق فایل نسبت به ریشهٔ مخزن.
.TP
.B texts
.
فهرستی از تکه‌های متن.
.UNINDENT
.sp
و هر مدخل از \fB{texts}\fP زیرکلیدواژه‌های زیر را ارائه می‌دهد:
.INDENT 0.0
.TP
.B matched
.
بولی (Boolean). مقدار True اگر تکه متن با الگوی مشخص‌شده مطابقت داشته باشد.
.TP
.B text
.
رشته. محتوای تکه متن.
.UNINDENT
.sp
برای ساختار نحو بسط فهرست، \%\fBhg help templates.operators\fP\: را ببینید.
.sp
در صورت یافتن تطابق، مقدار 0 و در غیر این صورت مقدار 1 را برمی‌گرداند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-0,  \-\-print0
.
خاتمه دادن به فیلدها با نویسهٔ NUL
.TP
.B \-\-all
.
نام مستعار برای \-\-diff (منسوخ‌شده)
.TP
.B \-\-diff
.
جستجو در تغییرات بازبینی‌ها برای زمانی که الگو اضافه یا حذف شده است
.TP
.B \-a,  \-\-text
.
در نظر گرفتن همهٔ فایل‌ها به عنوان متن
.TP
.B \-f,  \-\-follow
.
دنبال کردن تاریخچهٔ مجموعه‌تغییرها (changeset)، یا تاریخچهٔ فایل در میان رونوشت‌ها و تغییر نام‌ها
.TP
.B \-i,  \-\-ignore\-case
.
نادیده گرفتن بزرگی و کوچکی حروف در هنگام تطبیق
.TP
.B \-l,  \-\-files\-with\-matches
.
تنها چاپ نام فایل‌ها و بازبینی‌هایی که دارای تطابق هستند
.TP
.B \-n,  \-\-line\-number
.
چاپ شماره خطوط منطبق
.TP
.BI \-r,  \-\-rev \ <REV[+]>
.
جستجوی فایل‌های تغییریافته در محدودهٔ بازبینی مشخص‌شده
.TP
.B \-\-all\-files
.
شامل کردن تمام فایل‌های مجموعه‌تغییر هنگام جستجو (منسوخ‌شده)
.TP
.B \-u,  \-\-user
.
نمایش پدیدآورنده (با \-v به صورت کامل)
.TP
.B \-d,  \-\-date
.
نمایش تاریخ (با \-q به صورت کوتاه)
.TP
.BI \-T,  \-\-template \ <TEMPLATE>
.
نمایش خروجی با استفاده از قالب
.TP
.BI \-I,  \-\-include \ <PATTERN[+]>
.
شامل کردن نام‌های منطبق با الگوهای داده‌شده
.TP
.BI \-X,  \-\-exclude \ <PATTERN[+]>
.
مستثنی کردن نام‌های منطبق با الگوهای داده‌شده
.UNINDENT
.sp
گزینه‌های علامت‌گذاری‌شده با [+] می‌توانند چندین بار مشخص شوند.
.\" Generated by docutils manpage writer.
.\" 
.