.\" -*- 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
صفحه کد (codepage) پیش‌فرض مورد استفاده برای تبدیل فایل ورودی به UTF16 را تنظیم می‌کند. پیش‌فرض، صفحه کد 1252 است.
.IP \fB\-d\fR 4
.IX Item "-d"
.PD 0
.IP \fB\-\-decimal_values\fR 4
.IX Item "--decimal_values"
.PD
ثابت‌ها را در فایل سرایند در مبنای ده (decimal) خروجی می‌دهد. پیش‌فرض استفاده از خروجی شانزده‌شانزدهی (hexadecimal) است.
.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 دستور می‌دهد تا یک فایل سرایند OLE2 را با استفاده از تعاریف HRESULT تولید کند. در صورتی که این پرچم تعیین نشود از کدهای وضعیت (status codes) استفاده می‌شود.
.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 وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به صورت عینی (literal) برخورد خواهد شد و حذف نمی‌شود.
.Sp
گزینه‌ها در \fIfile\fR با نویسه فاصله (whitespace) از یکدیگر جدا می‌شوند. یک نویسه فاصله می‌تواند با قرار دادن کل گزینه در گیومه تکی یا دوتایی، درون گزینه قرار گیرد. هر نویسه‌ای (از جمله بک‌اسلش) می‌تواند با پیشوند کردن یک بک‌اسلش به نویسه مربوطه درج شود. خود فایل \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)، نسخهٔ 1.3 یا هر نسخهٔ متأخر دیگری که توسط بنیاد نرم‌افزارهای آزاد منتشر شده، با رعایت عدم وجود بخش‌های ناپیوسته، متون روی جلد و متون پشت جلد صادر شده است. یک نسخه از این مجوز در بخش موسوم به "GNU Free Documentation License" درج شده است.