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