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" دستور می‌دهد یک پرونده سرایند
           OLE2 با استفاده از تعاریف HRESULT تولید کند. اگر این پرچم مشخص
           نشود، کدهای وضعیت استفاده می‌شوند.

       -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 با نویسه فاصله خالی (whitespace) جدا می‌شوند. می‌توان
           یک نویسه فاصله را با احاطه کردن کل گزینه در علامت‌های نقل‌قول تکی یا
           دوتایی در یک گزینه گنجاند. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با
           پیشوند قرار دادن یک بک‌اسلش در ابتدای آن درج کرد. پرونده file خود
           ممکن است حاوی گزینه‌های @file دیگری باشد؛ چنین گزینه‌هایی به صورت
           بازگشتی پردازش خواهند شد.

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

حق نشر (COPYRIGHT)
       Copyright (c) 1991-2026 Free Software Foundation, Inc.

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

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