.TH MSGCOMM 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgcomm \- انطباق و یافتن پیامهای مشترک در چند کاتالوگ پیام
.SH "خلاصه دستور (SYNOPSIS)"
.B msgcomm
[\fI\,گزینه\/\fR]... [\fI\,فایل_ورودی\/\fR]...
.SH "توضیحات (DESCRIPTION)"
.PP
پیام‌هایی را که بین دو یا چند فایل از فایل‌های PO مشخص‌شده مشترک هستند، پیدا می‌کند.
با استفاده از گزینهٔ
.B \-\-more\-than
می‌توان اشتراک بیشتری را پیش از چاپ پیام‌ها درخواست کرد. برعکس، می‌توان از گزینهٔ
.B \-\-less\-than
برای تعیین اشتراک کمتر پیش از چاپ پیام‌ها استفاده کرد (برای مثال،
.B \-\-less\-than=2
تنها پیام‌های یکتا را چاپ خواهد کرد). ترجمه‌ها، توضیحات (کامنت‌ها) و توضیحات استخراج‌شده حفظ خواهند شد، اما تنها از نخستین فایل PO که آن‌ها را تعریف کرده است. موقعیت فایل‌ها از تمام فایل‌های PO تجمیع خواهد شد.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SS "محل فایل ورودی:"
.TP
\fIINPUTFILE\fR ...
فایل‌های ورودی
.TP
\fB\-f\fR, \fB\-\-files\-from\fR=\fI\,FILE\/\fR
دریافت فهرست فایل‌های ورودی از \fIFILE\fR
.TP
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
افزودن \fIDIRECTORY\fR به فهرست جستجوی فایل‌های ورودی
.PP
اگر فایل ورودی \- باشد، ورودی استاندارد خوانده می‌شود.
.SS "محل فایل خروجی:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.PP
اگر فایل خروجی تعیین نشود یا \- باشد، نتایج در خروجی استاندارد نوشته می‌شوند.
.SS "انتخاب پیام:"
.TP
\-<, \fB\-\-less\-than\fR=\fI\,NUMBER\/\fR
چاپ پیام‌هایی با تعداد تعاریف کمتر از این مقدار؛ در صورت تعیین نشدن، مقدار پیش‌فرض بی‌نهایت است
.TP
\->, \fB\-\-more\-than\fR=\fI\,NUMBER\/\fR
چاپ پیام‌هایی با تعداد تعاریف بیشتر از این مقدار؛ در صورت تعیین نشدن، مقدار پیش‌فرض 1 است
.TP
\fB\-u\fR, \fB\-\-unique\fR
کوتاه‌شدهٔ \fB\-\-less\-than\fR=\fI\,2\/\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\-e\fR, \fB\-\-no\-escape\fR
عدم استفاده از کاراکترهای اسکیپ زبان C در خروجی (پیش‌فرض)
.TP
\fB\-E\fR, \fB\-\-escape\fR
استفاده از کاراکترهای اسکیپ زبان C در خروجی، بدون کاراکترهای گسترش‌یافته
.TP
\fB\-\-force\-po\fR
نوشتن فایل PO حتی در صورت خالی بودن
.TP
\fB\-i\fR, \fB\-\-indent\fR
نوشتن فایل .po با سبک تورفتگی (indent)
.TP
\fB\-\-no\-location\fR
عدم نوشتن خطوط '#: filename:line'
.TP
\fB\-n\fR, \fB\-\-add\-location\fR
تولید خطوط '#: filename:line' (پیش‌فرض)
.TP
\fB\-\-strict\fR
نوشتن فایل .po سازگار و دقیق با استاندارد 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\-s\fR, \fB\-\-sort\-output\fR
تولید خروجی مرتب‌شده
.TP
\fB\-F\fR, \fB\-\-sort\-by\-file\fR
مرتب‌سازی خروجی بر اساس محل فایل
.TP
\fB\-\-omit\-header\fR
عدم نوشتن سرایند همراه با مدخل 'msgid ""'
.SS "خروجی اطلاعاتی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Peter Miller.
.SH "گزارش باگها (REPORTING BUGS)"
گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی <https://savannah.gnu.org/projects/gettext>
یا از طریق ایمیل به <bug\-gettext@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 1995\-2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B msgcomm
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgcomm
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgcomm
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.