| HG(GREP) | HG(GREP) |
نام (NAME)
hg grep - جستجو برای یک الگو در فایل‌های مشخص‌شده
خلاصه دستور (SYNOPSIS)
hg grep [--diff] [OPTION]... PATTERN [FILE]...
توضیحات (DESCRIPTION)
جستجوی یک عبارت باقاعده در فایل‌های مشخص‌شده در کل مخزن، در دایرکتوری کاری یا تاریخچهٔ بازبینی‌ها.
به‌طور پیش‌فرض، grep فایل‌های مخزن را در دایرکتوری کاری جستجو می‌کند و نام فایل‌هایی را که تطابقی در آن‌ها پیدا شود چاپ می‌کند. برای مشخص کردن بازبینی‌های تاریخی به جای دایرکتوری کاری، از پرچم --rev استفاده کنید.
برای جستجو در تغییرات بازبینی‌های تاریخی که شامل تغییری در وضعیت تطابق هستند (علامت «-» برای تطابقی که به عدم تطابق تبدیل می‌شود، یا «+» برای عدم تطابقی که به تطابق تبدیل می‌شود)، از پرچم --diff استفاده کنید.
مقدار PATTERN می‌تواند هر عبارت باقاعدهٔ پایتون (تقریباً سازگار با Perl) باشد.
اگر هیچ فایلی (FILE) مشخص نشود و پرچم --rev داده نشود، همهٔ فایل‌های دایرکتوری کاری جستجو می‌شوند. هنگام استفاده از پرچم --rev و مشخص کردن FILEها، از آرگومان --follow برای دنبال کردن فایل‌های مشخص‌شده در میان تغییر نام‌ها و رونوشت‌ها استفاده کنید.
قالب (Template):
کلمات کلیدی زیر علاوه بر کلمات کلیدی و توابع رایج قالب‌ها پشتیبانی می‌شوند. همچنین hg help templates را ببینید.
- change
- رشته. نویسه‌ای نشان‌دهندهٔ درج + یا حذف -. در صورت مشخص شدن --diff در دسترس است.
- lineno
- عدد صحیح. شماره خط مورد منطبق.
- path
- رشته. مسیر مطلق فایل نسبت به ریشهٔ مخزن.
- texts
- فهرستی از
تکه‌های
متن.
و هر مدخل از {texts} زیرکلیدواژه‌های زیر را ارائه می‌دهد:
- matched
- بولی (Boolean). مقدار True اگر تکه متن با الگوی مشخص‌شده مطابقت داشته باشد.
- text
- رشته.
محتوای تکه
متن.
برای ساختار نحو بسط فهرست، hg help templates.operators را ببینید.
در صورت یافتن تطابق، مقدار 0 و در غیر این صورت مقدار 1 را برمی‌گرداند.
گزینه‌ها (OPTIONS)
- -0, --print0
- خاتمه دادن به فیلدها با نویسهٔ NUL
- --all
- نام مستعار برای --diff (منسوخ‌شده)
- --diff
- جستجو در تغییرات بازبینی‌ها برای زمانی که الگو اضافه یا حذف شده است
- -a, --text
- در نظر گرفتن همهٔ فایل‌ها به عنوان متن
- -f, --follow
- دنبال کردن تاریخچهٔ مجموعه‌تغییرها (changeset)، یا تاریخچهٔ فایل در میان رونوشت‌ها و تغییر نام‌ها
- -i, --ignore-case
- نادیده گرفتن بزرگی و کوچکی حروف در هنگام تطبیق
- -l, --files-with-matches
- تنها چاپ نام فایل‌ها و بازبینی‌هایی که دارای تطابق هستند
- -n, --line-number
- چاپ شماره خطوط منطبق
- -r,--rev <REV[+]>
- جستجوی فایل‌های تغییریافته در محدودهٔ بازبینی مشخص‌شده
- --all-files
- شامل کردن تمام فایل‌های مجموعه‌تغییر هنگام جستجو (منسوخ‌شده)
- -u, --user
- نمایش پدیدآورنده (با -v به صورت کامل)
- -d, --date
- نمایش تاریخ (با -q به صورت کوتاه)
- -T,--template <TEMPLATE>
- نمایش خروجی با استفاده از قالب
- -I,--include <PATTERN[+]>
- شامل کردن نام‌های منطبق با الگوهای داده‌شده
- -X,--exclude <PATTERN[+]>
- مستثنی
کردن
نام‌های
منطبق با
الگوهای
داده‌شده
گزینه‌های علامت‌گذاری‌شده با [+] می‌توانند چندین بار مشخص شوند.