.TH MSGCAT 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgcat \- ادغام و ترکیب چند کاتالوگ پیام
.SH "خلاصه دستور (SYNOPSIS)"
.B msgcat
[\fI\,گزینه\/\fR]... [\fI\,فایل_ورودی\/\fR]...
.SH "توضیحات (DESCRIPTION)"
.PP
فایل‌های PO مشخص‌شده را به هم متصل و ادغام می‌کند.
پیام‌هایی را که بین دو یا چند فایل از فایل‌های PO مشخص‌شده مشترک هستند، پیدا می‌کند.
با استفاده از گزینهٔ
.B \-\-more\-than
می‌توان اشتراک بیشتری را پیش از چاپ پیام‌ها درخواست کرد. برعکس، می‌توان از گزینهٔ
.B \-\-less\-than
برای تعیین اشتراک کمتر پیش از چاپ پیام‌ها استفاده کرد (برای مثال،
.B \-\-less\-than=2
تنها پیام‌های یکتا را چاپ خواهد کرد). ترجمه‌ها، توضیحات (کامنت‌ها)، توضیحات استخراج‌شده و موقعیت فایل‌ها تجمیع خواهند شد، مگر اینکه گزینهٔ
.B \-\-use\-first
مشخص شده باشد که در این صورت، از نخستین فایل 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
چاپ پیام‌هایی با تعداد تعاریف بیشتر از این مقدار؛ در صورت تعیین نشدن، مقدار پیش‌فرض 0 است
.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\-t\fR, \fB\-\-to\-code\fR=\fI\,NAME\/\fR
کدگذاری برای خروجی
.TP
\fB\-\-use\-first\fR
استفاده از نخستین ترجمه موجود برای هر پیام؛ ادغام نکردن چند ترجمه با یکدیگر
.TP
\fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
تنظیم فیلد 'Language' در مدخل سرایند
.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
مرتب‌سازی خروجی بر اساس محل فایل
.SS "خروجی اطلاعاتی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Bruno Haible.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها در سامانه ردیابی اشکالات به نشانی <https://savannah.gnu.org/projects/gettext>
یا از طریق ایمیل به <bug\-gettext@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2001\-2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>
.br
این یک نرم‌افزار آزاد است: شما در ویرایش و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B msgcat
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgcat
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgcat
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.