نام کلاس با افزودن نام محلی به نام منبع، با جداکننده خط زیر (underscore) تعیین می‌شود. گزینهٔ -d اجباری است. کلاس درون دایرکتوری مشخص‌شده نوشته می‌شود.

محل فایل خروجی در حالت C#:

-r, --resource=RESOURCE: نام منبع (resource)
-l, --locale=LOCALE: نام محلی (locale)، به‌صورت زبان یا زبان_کشور
-d DIRECTORY: دایرکتوری پایه برای فایل‌های .dll وابسته به محلی

گزینه‌های -l و -d اجباری هستند. فایل .dll درون یک زیردایرکتوری از دایرکتوری مشخص‌شده نوشته می‌شود که نام آن بستگی به محلی دارد.

محل فایل خروجی در حالت Tcl:

-l, --locale=LOCALE: نام محلی (locale)، به‌صورت زبان یا زبان_کشور
-d DIRECTORY: دایرکتوری پایه برای کاتالوگ‌های پیام .msg

گزینه‌های -l و -d اجباری هستند. فایل .msg درون دایرکتوری مشخص‌شده نوشته می‌شود.

گزینه‌های حالت Desktop Entry:

-l, --locale=LOCALE: نام محلی (locale)، به‌صورت زبان یا زبان_کشور
-o, --output-file=FILE: نوشتن خروجی در فایل مشخص‌شده
--template=TEMPLATE: یک فایل .desktop که به‌عنوان الگو استفاده می‌شود
-d DIRECTORY: دایرکتوری پایه برای فایل‌های .po
-kWORD, --keyword=WORD: جستجوی WORD به‌عنوان یک کلیدواژه اضافی
-k, --keyword: عدم استفاده از کلیدواژه‌های پیش‌فرض

گزینه‌های -l، -o و --template اجباری هستند. اگر -D مشخص شود، فایل‌های ورودی به‌جای آرگومان‌های خط فرمان از دایرکتوری خوانده می‌شوند.

گزینه‌های حالت XML:

-l, --locale=LOCALE: نام محلی (locale)، به‌صورت زبان یا زبان_کشور
-L, --language=NAME: شناسایی زبان XML مشخص‌شده
-o, --output-file=FILE: نوشتن خروجی در فایل مشخص‌شده
--template=TEMPLATE: یک فایل XML که به‌عنوان الگو استفاده می‌شود
-d DIRECTORY: دایرکتوری پایه برای فایل‌های .po
--replace-text: تولید خروجی XML با متن ترجمه‌شده به‌جای متن اصلی، نه الحاق به متن اصلی

نحو فایل ورودی:

-P, --properties-input: فایل‌های ورودی در نحو .properties جاوا هستند
--stringtable-input: فایل‌های ورودی در نحو .strings مربوط به NeXTstep/GNUstep هستند

تفسیر فایل ورودی:

-c, --check: انجام تمام بررسی‌های تعیین‌شده توسط --check-format، --check-header و --check-domain
--check-format: بررسی رشته‌های قالب وابسته به زبان
--check-header: بررسی وجود و محتویات مدخل سرایند
--check-domain: بررسی تداخل میان دستورالعمل‌های domain و گزینهٔ --output-file
-C, --check-compatibility: بررسی رفتار مطابق با msgfmt استاندارد X/Open
--check-accelerators[=CHAR]: بررسی وجود شتاب‌دهنده‌های صفحه‌کلید برای موارد منو
-f, --use-fuzzy: استفاده از مدخل‌های فازی (fuzzy) در خروجی

جزئیات خروجی:

--no-convert: عدم تبدیل پیام‌ها به کدگذاری UTF-8
--no-redundancy: عدم بسط اولیه ماکروهای دستورالعمل رشته قالب ISO C 99 <inttypes.h>
-a, --alignment=NUMBER: تراز کردن رشته‌ها روی NUMBER بایت (پیش‌فرض: 1)
--endianness=BYTEORDER: نوشتن اعداد ۳۲ بیتی با ترتیب بایت مشخص‌شده (big یا little؛ پیش‌فرض به پلتفرم بستگی دارد)
--no-hash: فایل باینری شامل جدول هش (hash table) نخواهد بود

خروجی اطلاعاتی:

-h, --help: نمایش این راهنما و خروج
-V, --version: نمایش اطلاعات نسخه و خروج
--statistics: چاپ آمار مربوط به ترجمه‌ها
-v, --verbose: افزایش سطح جزئیات خروجی

نویسندگان (AUTHORS)

نوشته‌شده توسط Ulrich Drepper، Bruno Haible و Daiki Ueno.

گزارش باگ‌ها (REPORTING BUGS)

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

حق نشر (COPYRIGHT)

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

همچنین ببینید (SEE ALSO)

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

: info msgfmt

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

January 2026

GNU gettext-tools 1.0