.\" -*- 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-07-30 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 \- تولید منابع پیام ویندوز (Windows message resources)
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
windmc [گزینه‌ها] پرونده\-ورودی
.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 دستور می‌دهد یک پرونده سرایند OLE2 با استفاده از تعاریف HRESULT تولید کند. اگر این پرچم مشخص نشود، کدهای وضعیت استفاده می‌شوند.
.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 با نویسه فاصله خالی (whitespace) جدا می‌شوند. می‌توان یک نویسه فاصله را با احاطه کردن کل گزینه در علامت‌های نقل‌قول تکی یا دوتایی در یک گزینه گنجاند. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با پیشوند قرار دادن یک بک‌اسلش در ابتدای آن درج کرد. پرونده \fIfile\fR خود ممکن است حاوی گزینه‌های @\fIfile\fR دیگری باشد؛ چنین گزینه‌هایی به صورت بازگشتی پردازش خواهند شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
ورودی‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (c) 1991\-2026 Free Software Foundation, Inc.
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز اسناد آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان "GNU Free Documentation License" گنجانده شده است.