نام (NAME)

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

خلاصه دستور (SYNOPSIS)

windmc [گزینه‌ها] پرونده-ورودی

توضیحات (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)

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