MSGGREP(1) دستورات کاربر MSGGREP(1)

msggrep - جستجوی الگو و فیلتر پیامها در کاتالوگ پیام

msggrep [گزینه] [فایل_ورودی]

تمام پیام‌های یک کاتالوگ ترجمه را که با یک الگوی مشخص مطابقت دارند یا متعلق به فایل‌های منبع مشخصی هستند، استخراج می‌کند.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

فایل PO ورودی
افزودن DIRECTORY به فهرست جستجوی فایل‌های ورودی

اگر هیچ فایل ورودی مشخص نشود یا - باشد، ورودی استاندارد خوانده می‌شود.

نوشتن خروجی در فایل مشخص‌شده

اگر هیچ فایل خروجی مشخص نشود یا - باشد، نتایج در خروجی استاندارد نوشته می‌شوند.

[-N SOURCEFILE]... [-M DOMAINNAME]... [-J MSGCTXT-PATTERN] [-K MSGID-PATTERN] [-T MSGSTR-PATTERN] [-C COMMENT-PATTERN] [-X EXTRACTED-COMMENT-PATTERN] [-W WORKFLOW-FLAG] [-S STICKY-FLAG]

یک پیام در صورتی انتخاب می‌شود که از یکی از فایل‌های منبع مشخص‌شده آمده باشد، یا از یکی از دامنه‌های مشخص‌شده آمده باشد، یا اگر -J داده شود و سیاق (msgctxt) آن با MSGCTXT-PATTERN مطابقت داشته باشد، یا اگر -K داده شود و کلید (msgid یا msgid_plural) آن با MSGID-PATTERN مطابقت داشته باشد، یا اگر -T داده شود و ترجمهٔ (msgstr) آن با MSGSTR-PATTERN مطابقت داشته باشد، یا اگر -C داده شود و توضیحات مترجم با COMMENT-PATTERN مطابقت داشته باشد، یا اگر -X داده شود و توضیحات استخراج‌شده با EXTRACTED-COMMENT-PATTERN مطابقت داشته باشد، یا اگر -W داده شود و پرچم‌های آن شامل WORKFLOW-FLAG باشند، یا اگر -S داده شود و پرچم‌های آن شامل STICKY-FLAG باشند.

هنگامی که بیش از یک معیار انتخاب مشخص شده باشد، مجموعه پیام‌های انتخاب‌شده اجتماع پیام‌های انتخاب‌شدهٔ هر معیار خواهد بود.

نحو MSGCTXT-PATTERN یا MSGID-PATTERN یا MSGSTR-PATTERN یا COMMENT-PATTERN یا EXTRACTED-COMMENT-PATTERN:

[-E | -F] [-e PATTERN | -f FILE]...

الگوها (PATTERN) به‌طور پیش‌فرض عبارات باقاعدهٔ پایه هستند، یا عبارات باقاعدهٔ گسترش‌یافته در صورت ارائهٔ -E، یا رشته‌های ثابت در صورت ارائهٔ -F.

انتخاب پیام‌های استخراج‌شده از SOURCEFILE
انتخاب پیام‌های متعلق به دامنه DOMAINNAME
شروع الگوها برای msgctxt
شروع الگوها برای msgid
شروع الگوها برای msgstr
شروع الگوها برای توضیحات مترجم
شروع الگوها برای توضیحات استخراج‌شده
الگو (PATTERN) یک عبارت باقاعده گسترش‌یافته است
الگو (PATTERN) مجموعه‌ای از رشته‌های جداشده با خط جدید است
استفاده از PATTERN به‌عنوان یک عبارت باقاعده
دریافت PATTERN از FILE
نادیده گرفتن تمایز بین حروف بزرگ و کوچک
انتخاب پیام‌های دارای FLAG
انتخاب پیام‌های دارای FLAG
تنها خروجی دادن پیام‌هایی که با هیچ معیار انتخابی مطابقت ندارند

فایل ورودی در نحو .properties جاوا است
فایل ورودی در نحو .strings مربوط به NeXTstep/GNUstep است

استفاده همیشگی از رنگ‌ها و سایر ویژگی‌های متنی
استفاده از رنگ‌ها و سایر ویژگی‌های متنی طبق WHEN؛ مقادیر مجاز برای WHEN عبارتند از 'always'، 'never'، 'auto' یا 'html'.
مشخص کردن فایل قواعد سبک CSS برای --color
عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض)
استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته
نوشتن فایل PO حتی در صورت خالی بودن
سبک خروجی با تورفتگی
عدم نوشتن خطوط '#: filename:line'
تولید خطوط '#: filename:line' (پیش‌فرض)
سبک خروجی دقیق و سازگار با Uniforum
نوشتن یک فایل .properties جاوا در خروجی
نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep در خروجی
تنظیم عرض صفحه خروجی
نشکستن خطوط پیام‌های طولانی (طولانی‌تر از عرض صفحه خروجی) به چند خط
تولید خروجی مرتب‌شده
مرتب‌سازی خروجی بر اساس محل فایل

نمایش این راهنما و خروج
نمایش اطلاعات نسخه و خروج

نوشته‌شده توسط Bruno Haible.

گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی https://savannah.gnu.org/projects/gettext یا از طریق ایمیل به <bug-gettext@gnu.org>.

حق نشر © 2001-2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

مستندات کامل برای msggrep به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و msggrep به‌درستی روی سیستم شما نصب شده باشند، دستور

info msggrep

باید دسترسی شما به راهنمای کامل را فراهم کند.

January 2026 GNU gettext-tools 1.0