.\" -*- 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 "WINDRES 1"
.TH WINDRES 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)"
windres \- دست‌کاری منابع ویندوز
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
windres [options] [input\-file] [output\-file]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \fBwindres\fR منابع را از یک فایل ورودی خوانده و آن‌ها را در یک فایل
خروجی کپی می‌کند. هر یک از این فایل‌ها می‌تواند در یکی از سه قالب زیر باشد:
.ie n .IP """rc""" 4
.el .IP \f(CWrc\fR 4
.IX Item "rc"
قالبی متنی که توسط Resource Compiler خوانده می‌شود.
.ie n .IP """res""" 4
.el .IP \f(CWres\fR 4
.IX Item "res"
قالبی باینری (دودویی) که توسط Resource Compiler تولید می‌شود.
.ie n .IP """coff""" 4
.el .IP \f(CWcoff\fR 4
.IX Item "coff"
یک شیء (object) یا فایل اجرایی COFF.
.PP
شرح دقیق این قالب‌های گوناگون در مستندات مایکروسافت در دسترس است.
.PP
هنگامی که \fBwindres\fR از قالب \f(CW\*(C`rc\*(C'\fR به قالب \f(CW\*(C`res\*(C'\fR
تبدیل انجام می‌دهد، همانند Windows Resource Compiler عمل می‌کند. هنگامی که
\&\fBwindres\fR از قالب \f(CW\*(C`res\*(C'\fR به قالب \f(CW\*(C`coff\*(C'\fR تبدیل می‌کند،
همانند برنامهٔ \f(CW\*(C`CVTRES\*(C'\fR ویندوز عمل خواهد کرد.
.PP
هنگامی که \fBwindres\fR یک فایل \f(CW\*(C`rc\*(C'\fR تولید می‌کند، خروجی مشابه
اما نه دقیقاً یکسان با قالبی است که برای ورودی انتظار می‌رود. زمانی که یک فایل
ورودی \f(CW\*(C`rc\*(C'\fR به یک نام فایل خارجی ارجاع دهد، فایل خروجی \f(CW\*(C`rc\*(C'\fR
در عوض محتوای آن فایل را درون خود می‌گنجاند.
.PP
اگر قالب ورودی یا خروجی مشخص نشده باشد، \fBwindres\fR بر اساس نام فایل،
یا برای فایل ورودی بر اساس محتویات آن حدس خواهد زد. فایلی با پسوند
\&\fI.rc\fR به عنوان یک فایل \f(CW\*(C`rc\*(C'\fR در نظر گرفته می‌شود، فایلی با
پسوند \fI.res\fR به عنوان یک فایل \f(CW\*(C`res\*(C'\fR در نظر گرفته می‌شود،
و فایلی با پسوند \fI.o\fR یا \fI.exe\fR به عنوان یک فایل \f(CW\*(C`coff\*(C'\fR
پردازش خواهد شد.
.PP
اگر هیچ فایل خروجی مشخص نشود، \fBwindres\fR منابع را با قالب \f(CW\*(C`rc\*(C'\fR
در خروجی استاندارد چاپ خواهد کرد.
.PP
کاربرد معمول این است که شما یک فایل \f(CW\*(C`rc\*(C'\fR بنویسید، از \fBwindres\fR
برای تبدیل آن به یک فایل شیء COFF استفاده کنید، و سپس فایل COFF را به
برنامهٔ خود پیوند (link) دهید. این کار منابع توصیف‌شده در فایل
\&\f(CW\*(C`rc\*(C'\fR را در ویندوز در دسترس قرار می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-i\fR \fIfilename\fR" 4
.IX Item "-i filename"
.PD 0
.IP "\fB\-\-input\fR \fIfilename\fR" 4
.IX Item "--input filename"
.PD
نام فایل ورودی. اگر از این گزینه استفاده نشود، \fBwindres\fR از نخستین آرگومان
غیرگزینه‌ای به عنوان نام فایل ورودی استفاده خواهد کرد. در صورت نبود هیچ آرگومان
غیرگزینه‌ای، \fBwindres\fR از ورودی استاندارد خواهد خواند. \fBwindres\fR
نمی‌تواند یک فایل COFF را از ورودی استاندارد بخواند.
.IP "\fB\-o\fR \fIfilename\fR" 4
.IX Item "-o filename"
.PD 0
.IP "\fB\-\-output\fR \fIfilename\fR" 4
.IX Item "--output filename"
.PD
نام فایل خروجی. اگر از این گزینه استفاده نشود، \fBwindres\fR از نخستین آرگومان
غیرگزینه‌ای پس از آرگومان‌های مربوط به نام فایل ورودی، به عنوان نام فایل خروجی
استفاده خواهد کرد. اگر هیچ آرگومان غیرگزینه‌ای وجود نداشته باشد، \fBwindres\fR
در خروجی استاندارد خواهد نوشت. \fBwindres\fR نمی‌تواند یک فایل COFF را در
خروجی استاندارد بنویسد. توجه داشته باشید که جهت سازگاری با \fBrc\fR گزینهٔ
\&\fB\-fo\fR نیز پذیرفته می‌شود، اما استفاده از آن توصیه نمی‌شود.
.IP "\fB\-J\fR \fIformat\fR" 4
.IX Item "-J format"
.PD 0
.IP "\fB\-\-input\-format\fR \fIformat\fR" 4
.IX Item "--input-format format"
.PD
قالب ورودی جهت خواندن. \fIformat\fR می‌تواند \fBres\fR، \fBrc\fR یا
\&\fBcoff\fR باشد. اگر قالب ورودی مشخص نشود، \fBwindres\fR همان‌طور که
در بالا شرح داده شد آن را حدس خواهد زد.
.IP "\fB\-O\fR \fIformat\fR" 4
.IX Item "-O format"
.PD 0
.IP "\fB\-\-output\-format\fR \fIformat\fR" 4
.IX Item "--output-format format"
.PD
قالب خروجی جهت تولید. \fIformat\fR می‌تواند \fBres\fR، \fBrc\fR یا
\&\fBcoff\fR باشد. اگر قالب خروجی مشخص نشود، \fBwindres\fR همان‌طور که
در بالا شرح داده شد آن را حدس خواهد زد.
.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 مورد استفاده برای یک فایل COFF را به عنوان ورودی یا خروجی مشخص
می‌کند. این مقدار نام یک هدف (target) BFD است؛ برای مشاهدهٔ فهرستی از هدف‌های
پشتیبانی‌شده می‌توانید از گزینهٔ \fB\-\-help\fR استفاده کنید. در حالت عادی
\&\fBwindres\fR از قالب پیش‌فرض استفاده خواهد کرد که نخستین مورد در فهرست
گزینهٔ \fB\-\-help\fR است.
.IP "\fB\-\-preprocessor\fR \fIprogram\fR" 4
.IX Item "--preprocessor program"
هنگامی که \fBwindres\fR یک فایل \f(CW\*(C`rc\*(C'\fR را می‌خواند، ابتدا آن را از
پیش‌پردازندهٔ C عبور می‌دهد. این گزینه می‌تواند برای تعیین پیش‌پردازندهٔ مورد
استفاده به کار رود. پیش‌پردازندهٔ پیش‌فرض \f(CW\*(C`gcc\*(C'\fR است.
.IP "\fB\-\-preprocessor\-arg\fR \fIoption\fR" 4
.IX Item "--preprocessor-arg option"
هنگامی که \fBwindres\fR یک فایل \f(CW\*(C`rc\*(C'\fR را می‌خواند، ابتدا آن را از
پیش‌پردازندهٔ C عبور می‌دهد. این گزینه می‌تواند برای مشخص کردن متن اضافی
جهت ارسال به خط فرمان پیش‌پردازنده استفاده شود. این گزینه را می‌توان چندین
بار برای افزودن گزینه‌های متعدد به خط فرمان پیش‌پردازنده به کار برد.
اگر گزینهٔ \fB\-\-preprocessor\fR مشخص نشده باشد، مجموعه‌ای پیش‌فرض
از آرگومان‌های پیش‌پردازنده استفاده خواهد شد، و هر گزینهٔ
\&\fB\-\-preprocessor\-arg\fR پس از آن‌ها در خط فرمان قرار خواهد گرفت. این
آرگومان‌های پیش‌فرض عبارتند از \f(CW\*(C`\-E\*(C'\fR، \f(CW\*(C`\-xc\-header\*(C'\fR
و \f(CW\*(C`\-DRC_INVOKED\*(C'\fR.
.IP "\fB\-I\fR \fIdirectory\fR" 4
.IX Item "-I directory"
.PD 0
.IP "\fB\-\-include\-dir\fR \fIdirectory\fR" 4
.IX Item "--include-dir directory"
.PD
یک دایرکتوری include را برای استفاده هنگام خواندن فایل \f(CW\*(C`rc\*(C'\fR مشخص
می‌کند. \fBwindres\fR این را به عنوان گزینهٔ \fB\-I\fR به پیش‌پردازنده ارسال
می‌کند. همچنین \fBwindres\fR هنگام جستجو برای فایل‌های نام‌برده‌شده در فایل
\&\f(CW\*(C`rc\*(C'\fR، این دایرکتوری را جستجو خواهد کرد. اگر آرگومان ارائه‌شده به این
دستور با هر یک از \fIformat\fRهای پشتیبانی‌شده (همان‌طور که در گزینهٔ \fB\-J\fR
توضیح داده شد) مطابقت داشته باشد، یک هشدار منسوخ‌شدگی صادر شده و دقیقاً مانند
گزینهٔ \fB\-J\fR عمل خواهد کرد. برنامه‌های جدید نباید از این رفتار استفاده کنند.
اگر نام یک دایرکتوری تصادفاً با یک \fIformat\fR مطابقت داشت، به‌سادگی پیشوند
\&\fB./\fR را به ابتدای آن اضافه کنید تا این رفتار سازگاری با گذشته غیرفعال شود.
.IP "\fB\-D\fR \fItarget\fR" 4
.IX Item "-D target"
.PD 0
.IP "\fB\-\-define\fR \fIsym\fR\fB[=\fR\fIval\fR\fB]\fR" 4
.IX Item "--define sym[=val]"
.PD
یک گزینهٔ \fB\-D\fR را برای ارسال به پیش‌پردازنده هنگام خواندن فایل
\&\f(CW\*(C`rc\*(C'\fR مشخص می‌کند.
.IP "\fB\-U\fR \fItarget\fR" 4
.IX Item "-U target"
.PD 0
.IP "\fB\-\-undefine\fR \fIsym\fR" 4
.IX Item "--undefine sym"
.PD
یک گزینهٔ \fB\-U\fR را برای ارسال به پیش‌پردازنده هنگام خواندن فایل
\&\f(CW\*(C`rc\*(C'\fR مشخص می‌کند.
.IP \fB\-r\fR 4
.IX Item "-r"
جهت سازگاری با rc نادیده گرفته می‌شود.
.IP \fB\-v\fR 4
.IX Item "-v"
فعال‌سازی حالت پرگو (verbose). در صورتی که پیش‌پردازنده‌ای را مشخص نکرده باشید،
این گزینه به شما اعلام می‌کند که کدام پیش‌پردازنده در حال استفاده است.
.IP "\fB\-c\fR \fIval\fR" 4
.IX Item "-c val"
.PD 0
.IP "\fB\-\-codepage\fR \fIval\fR" 4
.IX Item "--codepage val"
.PD
صفحهٔ کد (codepage) پیش‌فرض را برای استفاده هنگام خواندن یک فایل
\&\f(CW\*(C`rc\*(C'\fR مشخص می‌کند. مقدار \fIval\fR باید یک کد صفحهٔ کد در قالب
هگزادسیمال با پیشوند \fB0x\fR یا ده‌دهی باشد. دامنهٔ معتبر از صفر تا 0xffff
است، اما معتبر بودن صفحهٔ کد به سیستم میزبان و پیکربندی وابسته است.
.IP "\fB\-l\fR \fIval\fR" 4
.IX Item "-l val"
.PD 0
.IP "\fB\-\-language\fR \fIval\fR" 4
.IX Item "--language val"
.PD
زبان پیش‌فرض را برای استفاده هنگام خواندن یک فایل \f(CW\*(C`rc\*(C'\fR مشخص می‌کند.
مقدار \fIval\fR باید یک کد زبان در قالب هگزادسیمال باشد. هشت بیت پایینی زبان،
و هشت بیت بالایی زیرزبان (sublanguage) را مشخص می‌کنند.
.IP \fB\-\-use\-temp\-file\fR 4
.IX Item "--use-temp-file"
برای خواندن خروجی پیش‌پردازنده به‌جای استفاده از popen، از یک فایل موقت
استفاده می‌کند. اگر پیاده‌سازی popen در سیستم میزبان دارای اشکال است، از این
گزینه استفاده کنید (برای مثال، مشخص شده است نگارش‌های غیرانگلیسی خاصی از
Windows 95 و Windows 98 دارای پیاده‌سازی معیوب popen هستند که در آن‌ها
خروجی به جای لوله به کنسول فرستاده می‌شود).
.IP \fB\-\-no\-use\-temp\-file\fR 4
.IX Item "--no-use-temp-file"
برای خواندن خروجی پیش‌پردازنده از popen استفاده می‌کند، نه یک فایل موقت.
این رفتار پیش‌فرض است.
.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD
خلاصه‌ای از شیوهٔ استفاده را چاپ می‌کند.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
شماره نگارش \fBwindres\fR را چاپ می‌کند.
.IP \fB\-\-yydebug\fR 4
.IX Item "--yydebug"
اگر \fBwindres\fR با تعریف \f(CW\*(C`YYDEBUG\*(C'\fR به عنوان \f(CW1\fR
کامپایل شده باشد، این گزینه اشکال‌زدایی تجزیه‌کننده (parser) را فعال می‌کند.
.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 یا هر نگارش بعدی منتشر شده توسط بنیاد
نرم‌افزارهای آزاد (Free Software Foundation)؛ بدون بخش‌های تغییرناپذیر، بدون
متون روی جلد، و بدون متون پشت جلد اعطا می‌شود. یک نسخه از این مجوز در بخشی با
عنوان «GNU Free Documentation License» گنجانده شده است.