.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "WINDMC 1"
.TH WINDMC 1 2026-08-03 binutils-2.47 "GNU Development Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
windmc \- تولید منابع پیام ویندوز
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
windmc [options] input\-file
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBwindmc\fR تعاریف پیام را از یک فایل ورودی (.mc) خوانده و
آن‌ها را به مجموعه‌ای از فایل‌های خروجی تبدیل می‌کند. فایل‌های خروجی ممکن است از
چهار نوع باشند:
.ie n .IP """h""" 4
.el .IP \f(CWh\fR 4
.IX Item "h"
یک فایل سرآیند C حاوی تعاریف پیام.
.ie n .IP """rc""" 4
.el .IP \f(CWrc\fR 4
.IX Item "rc"
یک فایل منبع (resource) قابل کامپایل توسط ابزار \fBwindres\fR.
.ie n .IP """bin""" 4
.el .IP \f(CWbin\fR 4
.IX Item "bin"
یک یا چند فایل باینری حاوی داده‌های منبع برای یک
زبان پیام خاص.
.ie n .IP """dbg""" 4
.el .IP \f(CWdbg\fR 4
.IX Item "dbg"
یک فایل include زبان C که شناسه‌های پیام را به نام نمادین آن‌ها نگاشت می‌کند.
.PP
توضیحات دقیق این قالب‌های مختلف در
مستندات مایکروسافت در دسترس است.
.PP
هنگامی که \fBwindmc\fR از قالب \f(CW\*(C`mc\*(C'\fR به قالب \f(CW\*(C`bin\*(C'\fR،
\f(CW\*(C`rc\*(C'\fR، \f(CW\*(C`h\*(C'\fR و به صورت اختیاری \f(CW\*(C`dbg\*(C'\fR تبدیل انجام می‌دهد، مانند
کامپایلر پیام ویندوز (Windows Message Compiler) عمل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
.PD 0
.IP \fB\-\-ascii_in\fR 4
.IX Item "--ascii_in"
.PD
مشخص می‌کند که فایل ورودی مشخص‌شده ASCII است. این رفتار
پیش‌فرض است.
.IP \fB\-A\fR 4
.IX Item "-A"
.PD 0
.IP \fB\-\-ascii_out\fR 4
.IX Item "--ascii_out"
.PD
مشخص می‌کند که پیام‌ها در فایل‌های خروجی \f(CW\*(C`bin\*(C'\fR باید با قالب ASCII
باشند.
.IP \fB\-b\fR 4
.IX Item "-b"
.PD 0
.IP \fB\-\-binprefix\fR 4
.IX Item "--binprefix"
.PD
مشخص می‌کند که نام فایل‌های \f(CW\*(C`bin\*(C'\fR باید پیشوندی از
نام پایه (basename) فایل مبدأ داشته باشند.
.IP \fB\-c\fR 4
.IX Item "-c"
.PD 0
.IP \fB\-\-customflag\fR 4
.IX Item "--customflag"
.PD
بیت مشتری (customer bit) را در تمام شناسه‌های پیام تنظیم می‌کند.
.IP "\fB\-C\fR \fIcodepage\fR" 4
.IX Item "-C codepage"
.PD 0
.IP "\fB\-\-codepage_in\fR \fIcodepage\fR" 4
.IX Item "--codepage_in codepage"
.PD
تنظیم کدپیج پیش‌فرض برای تبدیل فایل ورودی به UTF16. مقدار
پیش‌فرض کدپیج 1252 است.
.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
.IP \fB\-\-decimal_values\fR 4
.IX Item "--decimal_values"
.PD
ثابت‌ها را در فایل سرآیند در مبنای ده‌دهی (decimal) خروجی می‌دهد. پیش‌فرض
استفاده از خروجی هگزادسیمال است.
.IP "\fB\-e\fR \fIext\fR" 4
.IX Item "-e ext"
.PD 0
.IP "\fB\-\-extension\fR \fIext\fR" 4
.IX Item "--extension ext"
.PD
پسوند برای فایل سرآیند. مقدار پیش‌فرض پسوند .h است.
.IP "\fB\-F\fR \fItarget\fR" 4
.IX Item "-F target"
.PD 0
.IP "\fB\-\-target\fR \fItarget\fR" 4
.IX Item "--target target"
.PD
مشخص کردن قالب BFD مورد استفاده برای فایل باینری به عنوان خروجی. این
یک نام هدف BFD است؛ می‌توانید از گزینه \fB\-\-help\fR برای مشاهده فهرست
اهداف پشتیبانی‌شده استفاده کنید. به‌طور معمول \fBwindmc\fR از قالب
پیش‌فرض استفاده خواهد کرد که اولین مورد فهرست‌شده با گزینه \fB\-\-help\fR است.
.IP "\fB\-h\fR \fIpath\fR" 4
.IX Item "-h path"
.PD 0
.IP "\fB\-\-headerdir\fR \fIpath\fR" 4
.IX Item "--headerdir path"
.PD
پوشه مقصد برای فایل سرآیند تولیدشده. پیش‌فرض
پوشه جاری است.
.IP \fB\-H\fR 4
.IX Item "-H"
.PD 0
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD
فهرستی از گزینه‌های خط فرمان را نمایش داده و سپس خارج می‌شود.
.IP "\fB\-m\fR \fIcharacters\fR" 4
.IX Item "-m characters"
.PD 0
.IP "\fB\-\-maxlength\fR \fIcharacters\fR" 4
.IX Item "--maxlength characters"
.PD
به \fBwindmc\fR دستور می‌دهد در صورتی که طول هر پیامی
از عدد مشخص‌شده فراتر رفت، یک هشدار تولید کند.
.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
.IP \fB\-\-nullterminate\fR 4
.IX Item "--nullterminate"
.PD
پایان دادن به متن پیام در فایل‌های \f(CW\*(C`bin\*(C'\fR با صفر (null-terminate). به‌طور پیش‌فرض
آن‌ها با CR/LF خاتمه می‌یابند.
.IP \fB\-o\fR 4
.IX Item "-o"
.PD 0
.IP \fB\-\-hresult_use\fR 4
.IX Item "--hresult_use"
.PD
هنوز پیاده‌سازی نشده است. به \f(CW\*(C`windmc\*(C'\fR دستور می‌دهد با استفاده از
تعاریف HRESULT یک فایل سرآیند OLE2 تولید کند. در صورتی که این پرچم
مشخص نشود، از کدهای وضعیت استفاده می‌شود.
.IP "\fB\-O\fR \fIcodepage\fR" 4
.IX Item "-O codepage"
.PD 0
.IP "\fB\-\-codepage_out\fR \fIcodepage\fR" 4
.IX Item "--codepage_out codepage"
.PD
تنظیم کدپیج پیش‌فرض برای خروجی دادن فایل‌های متنی. مقدار پیش‌فرض
کدپیج 1252 است.
.IP "\fB\-r\fR \fIpath\fR" 4
.IX Item "-r path"
.PD 0
.IP "\fB\-\-rcdir\fR \fIpath\fR" 4
.IX Item "--rcdir path"
.PD
پوشه مقصد برای اسکریپت \f(CW\*(C`rc\*(C'\fR تولیدشده و فایل‌های
\&\f(CW\*(C`bin\*(C'\fR تولیدشده که اسکریپت کامپایلر منابع شامل آن‌ها می‌شود. مقدار پیش‌فرض
پوشه جاری است.
.IP \fB\-u\fR 4
.IX Item "-u"
.PD 0
.IP \fB\-\-unicode_in\fR 4
.IX Item "--unicode_in"
.PD
مشخص می‌کند که فایل ورودی UTF16 است.
.IP \fB\-U\fR 4
.IX Item "-U"
.PD 0
.IP \fB\-\-unicode_out\fR 4
.IX Item "--unicode_out"
.PD
مشخص می‌کند که پیام‌ها در فایل خروجی \f(CW\*(C`bin\*(C'\fR باید با قالب UTF16
باشند. این رفتار پیش‌فرض است.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال کردن حالت با جزئیات کامل (verbose).
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
شماره نسخه \fBwindmc\fR را چاپ می‌کند.
.IP "\fB\-x\fR \fIpath\fR" 4
.IX Item "-x path"
.PD 0
.IP "\fB\-\-xdgb\fR \fIpath\fR" 4
.IX Item "--xdgb path"
.PD
مسیر فایل include زبان C از نوع \f(CW\*(C`dbg\*(C'\fR که شناسه‌های پیام را به نام
نمادین نگاشت می‌کند. بدون مشخص کردن این سوییچ هیچ فایلی از این دست تولید نمی‌شود.
.IP \fB@\fR\fIfile\fR 4
.IX Item "@file"
خواندن گزینه‌های خط فرمان از \fIfile\fR. گزینه‌های خوانده‌شده
در محل قرارگیری گزینه اصلی @\fIfile\fR جایگزین می‌شوند. اگر \fIfile\fR
وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت
لفظی برخورد شده و حذف نخواهد شد.
.Sp
گزینه‌ها در \fIfile\fR با نویسه‌های فاصله خالی از یکدیگر جدا می‌شوند. یک نویسه فاصله خالی
می‌تواند با احاطه کردن کل گزینه درون علامت نقل‌قول تکی یا دوتایی
در گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با قرار دادن
یک بک‌اسلش در پیش از آن درج کرد. فایل \fIfile\fR ممکن است خود شامل گزینه‌های اضافی
@\fIfile\fR باشد؛ چنین گزینه‌هایی به‌صورت بازگشتی پردازش خواهند شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
مدخل‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
کپی‌رایت \(co 1991\-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳
یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛
بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون
متون پشت جلد. یک نسخه از این مجوز در
بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.