.TH MSGMERGE 1 "January 2026" "GNU gettext-tools 1.0" "دستورات کاربر"
.SH "نام (NAME)"
msgmerge \- ادغام کاتالوگ پیام و فایل الگو
.SH "خلاصه دستور (SYNOPSIS)"
.B msgmerge
[\fI\,گزینه\/\fR] \fI\,def.po ref.pot\/\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دو فایل .po به سبک Uniforum را با یکدیگر ادغام می‌کند. فایل def.po یک فایل PO موجود با ترجمه‌ها است که تا زمانی که هنوز همخوانی داشته باشند، به فایل تازه ایجادشده منتقل می‌شوند؛ توضیحات (کامنت‌ها) حفظ خواهند شد، اما توضیحات استخراج‌شده و موقعیت فایل‌ها نادیده گرفته می‌شوند. فایل ref.pot آخرین فایل PO ایجادشده با ارجاعات منبع به‌روزشده اما ترجمه‌های قدیمی است، یا یک فایل الگوی PO (معمولاً ایجادشده توسط xgettext)؛ هرگونه ترجمه یا توضیح در این فایل دور ریخته می‌شود، با این حال توضیحات نقطه‌دار (dot comments) و موقعیت فایل‌ها حفظ خواهند شد. در جاهایی که تطابق دقیقی یافت نشود، از تطبیق فازی (fuzzy matching) برای ایجاد نتایج بهتر استفاده می‌شود.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.SS "محل فایل ورودی:"
.TP
def.po
ترجمه‌های مرتبط با منابع قدیمی
.TP
ref.pot
ارجاعات به منابع جدید
.TP
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
افزودن DIRECTORY به فهرست جستجوی فایل‌های ورودی
.TP
\fB\-C\fR, \fB\-\-compendium\fR=\fI\,FILE\/\fR
کتابخانه اضافی از ترجمه‌های پیام؛
می‌تواند بیش از یک بار مشخص شود
.SS "حالت عملیات:"
.TP
\fB\-U\fR, \fB\-\-update\fR
به‌روزرسانی def.po؛
در صورتی که def.po از قبل به‌روز باشد کاری انجام نمی‌دهد
.SS "محل فایل خروجی:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
نوشتن خروجی در فایل مشخص‌شده
.PP
اگر فایل خروجی مشخص نشود یا \- باشد، نتایج در خروجی استاندارد نوشته می‌شوند.
.PP
محل فایل خروجی در حالت به‌روزرسانی (update):
نتیجه در همان فایل def.po بازنویسی می‌شود.
.TP
\fB\-\-backup\fR=\fI\,CONTROL\/\fR
تهیه یک نسخه پشتیبان از def.po
.TP
\fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
بازنویسی پسوند معمول پشتیبان
.PP
روش کنترل نسخه ممکن است از طریق گزینهٔ \fB\-\-backup\fR یا از طریق متغیر محیطی VERSION_CONTROL انتخاب شود. مقادیر مجاز عبارتند از:
.TP
none, off
هرگز نسخه پشتیبان تهیه نشود (حتی اگر \fB\-\-backup\fR داده شده باشد)
.TP
numbered, t
ایجاد نسخه‌های پشتیبان شماره‌دار
.TP
existing, nil
اگر نسخه‌های شماره‌دار وجود داشته باشند شماره‌دار، در غیر این صورت ساده
.TP
simple, never
همیشه نسخه‌های پشتیبان ساده ایجاد شود
.PP
پسوند پشتیبان '~' است، مگر اینکه با \fB\-\-suffix\fR یا متغیر محیطی SIMPLE_BACKUP_SUFFIX تنظیم شده باشد.
.SS "تغییردهنده‌های عملیات:"
.TP
\fB\-m\fR, \fB\-\-multi\-domain\fR
اعمال ref.pot به هر یک از دامنه‌ها در def.po
.TP
\fB\-\-for\-msgfmt\fR
تولید خروجی برای 'msgfmt'، نه برای مترجم
.TP
\fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
عدم استفاده از تطبیق فازی
.TP
\fB\-\-previous\fR
حفظ msgidهای قبلی پیام‌های ترجمه‌شده
.SS "نحو فایل ورودی:"
.TP
\fB\-P\fR, \fB\-\-properties\-input\fR
فایل‌های ورودی در نحو .properties جاوا هستند
.TP
\fB\-\-stringtable\-input\fR
فایل‌های ورودی در نحو .strings مربوط به NeXTstep/GNUstep هستند
.SS "جزئیات خروجی:"
.TP
\fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
تنظیم فیلد 'Language' در مدخل سرایند
.TP
\fB\-\-color\fR
استفاده همیشگی از رنگ‌ها و سایر ویژگی‌های متنی
.TP
\fB\-\-color\fR=\fI\,WHEN\/\fR
استفاده از رنگ‌ها و سایر ویژگی‌های متنی طبق WHEN.
مقدار WHEN می‌تواند 'always'، 'never'، 'auto' یا 'html' باشد.
.TP
\fB\-\-style\fR=\fI\,STYLEFILE\/\fR
مشخص کردن فایل شیوه‌نامه (style rule) سی‌اس‌اس برای \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
سبک خروجی با تورفتگی (indent)
.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\-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
نمایش اطلاعات نسخه و خروج
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح پرگویی (verbosity)
.TP
\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
فرونشاندن نشانگرهای پیشرفت
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Peter Miller و Bruno Haible.
.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 msgmerge
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B msgmerge
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info msgmerge
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.