WINDMC(1)                    GNU Development Tools                   WINDMC(1)


نام (NAME)
       windmc - تولید منابع پیام ویندوز

خلاصه دستور (SYNOPSIS)
       windmc [options] input-file

توضیحات (DESCRIPTION)
       دستور windmc تعاریف پیام را از یک فایل ورودی (.mc) خوانده و آن‌ها را به
       مجموعه‌ای از فایل‌های خروجی تبدیل می‌کند. فایل‌های خروجی ممکن است از چهار
       نوع باشند:

       "h" یک فایل سرآیند C حاوی تعاریف پیام.

       "rc"
           یک فایل منبع (resource) قابل کامپایل توسط ابزار windres.

       "bin"
           یک یا چند فایل باینری حاوی داده‌های منبع برای یک زبان پیام خاص.

       "dbg"
           یک فایل include زبان C که شناسه‌های پیام را به نام نمادین آن‌ها نگاشت
           می‌کند.

       توضیحات دقیق این قالب‌های مختلف در مستندات مایکروسافت در دسترس است.

       هنگامی که windmc از قالب "mc" به قالب "bin"، "rc"، "h" و به صورت
       اختیاری "dbg" تبدیل انجام می‌دهد، مانند کامپایلر پیام ویندوز (Windows
       Message Compiler) عمل می‌کند.

گزینه‌ها (OPTIONS)
       -a
       --ascii_in
           مشخص می‌کند که فایل ورودی مشخص‌شده ASCII است. این رفتار پیش‌فرض است.

       -A
       --ascii_out
           مشخص می‌کند که پیام‌ها در فایل‌های خروجی "bin" باید با قالب ASCII
           باشند.

       -b
       --binprefix
           مشخص می‌کند که نام فایل‌های "bin" باید پیشوندی از نام پایه (basename)
           فایل مبدأ داشته باشند.

       -c
       --customflag
           بیت مشتری (customer bit) را در تمام شناسه‌های پیام تنظیم می‌کند.

       -C codepage
       --codepage_in codepage
           تنظیم کدپیج پیش‌فرض برای تبدیل فایل ورودی به UTF16. مقدار پیش‌فرض
           کدپیج 1252 است.

       -d
       --decimal_values
           ثابت‌ها را در فایل سرآیند در مبنای ده‌دهی (decimal) خروجی می‌دهد.
           پیش‌فرض استفاده از خروجی هگزادسیمال است.

       -e ext
       --extension ext
           پسوند برای فایل سرآیند. مقدار پیش‌فرض پسوند .h است.

       -F target
       --target target
           مشخص کردن قالب BFD مورد استفاده برای فایل باینری به عنوان خروجی.
           این یک نام هدف BFD است؛ می‌توانید از گزینه --help برای مشاهده فهرست
           اهداف پشتیبانی‌شده استفاده کنید. به‌طور معمول windmc از قالب پیش‌فرض
           استفاده خواهد کرد که اولین مورد فهرست‌شده با گزینه --help است.

       -h path
       --headerdir path
           پوشه مقصد برای فایل سرآیند تولیدشده. پیش‌فرض پوشه جاری است.

       -H
       --help
           فهرستی از گزینه‌های خط فرمان را نمایش داده و سپس خارج می‌شود.

       -m characters
       --maxlength characters
           به windmc دستور می‌دهد در صورتی که طول هر پیامی از عدد مشخص‌شده فراتر
           رفت، یک هشدار تولید کند.

       -n
       --nullterminate
           پایان دادن به متن پیام در فایل‌های "bin" با صفر (null-terminate).
           به‌طور پیش‌فرض آن‌ها با CR/LF خاتمه می‌یابند.

       -o
       --hresult_use
           هنوز پیاده‌سازی نشده است. به "windmc" دستور می‌دهد با استفاده از
           تعاریف HRESULT یک فایل سرآیند OLE2 تولید کند. در صورتی که این پرچم
           مشخص نشود، از کدهای وضعیت استفاده می‌شود.

       -O codepage
       --codepage_out codepage
           تنظیم کدپیج پیش‌فرض برای خروجی دادن فایل‌های متنی. مقدار پیش‌فرض کدپیج
           1252 است.

       -r path
       --rcdir path
           پوشه مقصد برای اسکریپت "rc" تولیدشده و فایل‌های "bin" تولیدشده که
           اسکریپت کامپایلر منابع شامل آن‌ها می‌شود. مقدار پیش‌فرض پوشه جاری است.

       -u
       --unicode_in
           مشخص می‌کند که فایل ورودی UTF16 است.

       -U
       --unicode_out
           مشخص می‌کند که پیام‌ها در فایل خروجی "bin" باید با قالب UTF16 باشند.
           این رفتار پیش‌فرض است.

       -v
       --verbose
           فعال کردن حالت با جزئیات کامل (verbose).

       -V
       --version
           شماره نسخه windmc را چاپ می‌کند.

       -x path
       --xdgb path
           مسیر فایل include زبان C از نوع "dbg" که شناسه‌های پیام را به نام
           نمادین نگاشت می‌کند. بدون مشخص کردن این سوییچ هیچ فایلی از این دست
           تولید نمی‌شود.

       @file
           خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده در محل
           قرارگیری گزینه اصلی @file جایگزین می‌شوند. اگر file وجود نداشته باشد
           یا قابل خواندن نباشد، با گزینه به‌صورت لفظی برخورد شده و حذف نخواهد
           شد.

           گزینه‌ها در file با نویسه‌های فاصله خالی از یکدیگر جدا می‌شوند. یک
           نویسه فاصله خالی می‌تواند با احاطه کردن کل گزینه درون علامت نقل‌قول
           تکی یا دوتایی در گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش) را
           می‌توان با قرار دادن یک بک‌اسلش در پیش از آن درج کرد. فایل file ممکن
           است خود شامل گزینه‌های اضافی @file باشد؛ چنین گزینه‌هایی به‌صورت
           بازگشتی پردازش خواهند شد.

همچنین ببینید (SEE ALSO)
       مدخل‌های Info برای binutils.

حق نشر (COPYRIGHT)
       کپی‌رایت © 1991-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation,
       Inc.)

       اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو»
       (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده
       توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون
       روی جلد، و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU
       Free Documentation License» گنجانده شده است.

binutils-2.47                     2026-08-03                         WINDMC(1)