.TH MSGGREP 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر" .SH "نام (NAME)" msggrep \- جستجوی الگو و فیلتر پیامها در کاتالوگ پیام .SH "خلاصه دستور (SYNOPSIS)" .B msggrep [\fI\,گزینه\/\fR] [\fI\,فایل_ورودی\/\fR] .SH "توضیحات (DESCRIPTION)" .PP تمام پیام‌های یک کاتالوگ ترجمه را که با یک الگوی مشخص مطابقت دارند یا متعلق به فایل‌های منبع مشخصی هستند، استخراج می‌کند. .PP آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند. .SS "محل فایل ورودی:" .TP INPUTFILE فایل PO ورودی .TP \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR افزودن DIRECTORY به فهرست جستجوی فایل‌های ورودی .PP اگر هیچ فایل ورودی مشخص نشود یا \- باشد، ورودی استاندارد خوانده می‌شود. .SS "محل فایل خروجی:" .TP \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR نوشتن خروجی در فایل مشخص‌شده .PP اگر هیچ فایل خروجی مشخص نشود یا \- باشد، نتایج در خروجی استاندارد نوشته می‌شوند. .SS "انتخاب پیام:" .IP [\-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] .PP یک پیام در صورتی انتخاب می‌شود که از یکی از فایل‌های منبع مشخص‌شده آمده باشد، یا از یکی از دامنه‌های مشخص‌شده آمده باشد، یا اگر \fB\-J\fR داده شود و سیاق (msgctxt) آن با MSGCTXT\-PATTERN مطابقت داشته باشد، یا اگر \fB\-K\fR داده شود و کلید (msgid یا msgid_plural) آن با MSGID\-PATTERN مطابقت داشته باشد، یا اگر \fB\-T\fR داده شود و ترجمهٔ (msgstr) آن با MSGSTR\-PATTERN مطابقت داشته باشد، یا اگر \fB\-C\fR داده شود و توضیحات مترجم با COMMENT\-PATTERN مطابقت داشته باشد، یا اگر \fB\-X\fR داده شود و توضیحات استخراج‌شده با EXTRACTED\-COMMENT\-PATTERN مطابقت داشته باشد، یا اگر \fB\-W\fR داده شود و پرچم‌های آن شامل WORKFLOW\-FLAG باشند، یا اگر \fB\-S\fR داده شود و پرچم‌های آن شامل STICKY\-FLAG باشند. .PP هنگامی که بیش از یک معیار انتخاب مشخص شده باشد، مجموعه پیام‌های انتخاب‌شده اجتماع پیام‌های انتخاب‌شدهٔ هر معیار خواهد بود. .PP نحو MSGCTXT\-PATTERN یا MSGID\-PATTERN یا MSGSTR\-PATTERN یا COMMENT\-PATTERN یا EXTRACTED\-COMMENT\-PATTERN: .IP [\-E | \fB\-F]\fR [\-e PATTERN | \fB\-f\fR FILE]... .PP الگوها (PATTERN) به‌طور پیش‌فرض عبارات باقاعدهٔ پایه هستند، یا عبارات باقاعدهٔ گسترش‌یافته در صورت ارائهٔ \fB\-E\fR، یا رشته‌های ثابت در صورت ارائهٔ \fB\-F\fR. .TP \fB\-N\fR, \fB\-\-location\fR=\fI\,SOURCEFILE\/\fR انتخاب پیام‌های استخراج‌شده از SOURCEFILE .TP \fB\-M\fR, \fB\-\-domain\fR=\fI\,DOMAINNAME\/\fR انتخاب پیام‌های متعلق به دامنه DOMAINNAME .TP \fB\-J\fR, \fB\-\-msgctxt\fR شروع الگوها برای msgctxt .TP \fB\-K\fR, \fB\-\-msgid\fR شروع الگوها برای msgid .TP \fB\-T\fR, \fB\-\-msgstr\fR شروع الگوها برای msgstr .TP \fB\-C\fR, \fB\-\-comment\fR شروع الگوها برای توضیحات مترجم .TP \fB\-X\fR, \fB\-\-extracted\-comment\fR شروع الگوها برای توضیحات استخراج‌شده .TP \fB\-E\fR, \fB\-\-extended\-regexp\fR الگو (PATTERN) یک عبارت باقاعده گسترش‌یافته است .TP \fB\-F\fR, \fB\-\-fixed\-strings\fR الگو (PATTERN) مجموعه‌ای از رشته‌های جداشده با خط جدید است .TP \fB\-e\fR, \fB\-\-regexp\fR=\fI\,PATTERN\/\fR استفاده از PATTERN به‌عنوان یک عبارت باقاعده .TP \fB\-f\fR, \fB\-\-file\fR=\fI\,FILE\/\fR دریافت PATTERN از FILE .TP \fB\-i\fR, \fB\-\-ignore\-case\fR نادیده گرفتن تمایز بین حروف بزرگ و کوچک .TP \fB\-W\fR, \fB\-\-workflow\-flag\fR=\fI\,FLAG\/\fR انتخاب پیام‌های دارای FLAG .TP \fB\-S\fR, \fB\-\-sticky\-flag\fR=\fI\,FLAG\/\fR انتخاب پیام‌های دارای FLAG .TP \fB\-v\fR, \fB\-\-invert\-match\fR تنها خروجی دادن پیام‌هایی که با هیچ معیار انتخابی مطابقت ندارند .SS "نحو فایل ورودی:" .TP \fB\-P\fR, \fB\-\-properties\-input\fR فایل ورودی در نحو .properties جاوا است .TP \fB\-\-stringtable\-input\fR فایل ورودی در نحو .strings مربوط به NeXTstep/GNUstep است .SS "جزئیات خروجی:" .TP \fB\-\-color\fR استفاده همیشگی از رنگ‌ها و سایر ویژگی‌های متنی .TP \fB\-\-color\fR=\fI\,WHEN\/\fR استفاده از رنگ‌ها و سایر ویژگی‌های متنی طبق \fIWHEN\fR؛ مقادیر مجاز برای WHEN عبارتند از 'always'، 'never'، 'auto' یا 'html'. .TP \fB\-\-style\fR=\fI\,STYLEFILE\/\fR مشخص کردن فایل قواعد سبک CSS برای \fB\-\-color\fR .TP \fB\-\-no\-escape\fR عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض) .TP \fB\-\-escape\fR استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته .TP \fB\-\-force\-po\fR نوشتن فایل PO حتی در صورت خالی بودن .TP \fB\-\-indent\fR سبک خروجی با تورفتگی .TP \fB\-\-no\-location\fR عدم نوشتن خطوط '#: filename:line' .TP \fB\-n\fR, \fB\-\-add\-location\fR تولید خطوط '#: filename:line' (پیش‌فرض) .TP \fB\-\-strict\fR سبک خروجی دقیق و سازگار با Uniforum .TP \fB\-p\fR, \fB\-\-properties\-output\fR نوشتن یک فایل .properties جاوا در خروجی .TP \fB\-\-stringtable\-output\fR نوشتن یک فایل .strings مربوط به NeXTstep/GNUstep در خروجی .TP \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR تنظیم عرض صفحه خروجی .TP \fB\-\-no\-wrap\fR نشکستن خطوط پیام‌های طولانی (طولانی‌تر از عرض صفحه خروجی) به چند خط .TP \fB\-\-sort\-output\fR تولید خروجی مرتب‌شده .TP \fB\-\-sort\-by\-file\fR مرتب‌سازی خروجی بر اساس محل فایل .SS "خروجی اطلاعاتی:" .TP \fB\-h\fR, \fB\-\-help\fR نمایش این راهنما و خروج .TP \fB\-V\fR, \fB\-\-version\fR نمایش اطلاعات نسخه و خروج .SH "نویسنده (AUTHOR)" نوشته‌شده توسط Bruno Haible. .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی یا از طریق ایمیل به . .SH "حق نشر (COPYRIGHT)" حق نشر \(co 2001\-2026 Free Software Foundation, Inc. .br مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر .br این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند. .SH "همچنین ببینید (SEE ALSO)" مستندات کامل برای .B msggrep به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های .B info و .B msggrep به‌درستی روی سیستم شما نصب شده باشند، دستور .IP .B info msggrep .PP باید دسترسی شما به راهنمای کامل را فراهم کند.