.TH WINEGCC 1 "October 2005" "Wine 11.17" "Wine Developers Manual"
.SH "نام (NAME)"
winegcc \- کامپایلر C و ++C سازگار با MinGW برای Wine
.SH "خلاصه دستور (SYNOPSIS)"
.B winegcc
.RI [ options "] " infile\fR...
.SH "توضیحات (DESCRIPTION)"
دستور
.B winegcc 
یک پوسته‌پوش (wrapper) برای gcc است که تلاش می‌کند یک کامپایلر سازگار با MinGW را در لینوکس ارائه دهد. این ابزار بیش از همه برای توسعه‌دهندگان Win32 مفید است که می‌توانند به‌سادگی کد MinGW خود را از ویندوز آورده و بدون تغییر، آن را تحت Winelib در لینوکس دوباره کامپایل کنند.
ابزار wineg++ نیز عمدتاً همان گزینه‌های winegcc را می‌پذیرد.
.PP
هدف winegcc این است که بتوان به‌راحتی gcc/g++/windres را با winegcc/wineg++/wrc در یک Makefile مربوط به MinGW جایگزین کرد و صرفاً برنامه را با استفاده از Winelib تحت Wine دوباره کامپایل نمود. اگرچه معمولاً تغییرات کوچکی باید در کد مبدأ برنامه یا Makefile اعمال شود، اما انجام آن‌ها به روشی که بین محیط‌های MinGW و Wine سازگار باشد، بسیار آسان است.
.PP
این راهنما تنها تفاوت‌های نسبت به gcc را مستند می‌کند؛ لطفاً برای اطلاعات بیشتر دربارهٔ آن گزینه‌ها به راهنمای gcc مراجعه کنید.
.PP
.SH "گزینه‌ها (OPTIONS)"
.B گزینه‌های gcc:
تمام گزینه‌های gcc پشتیبانی می‌شوند و به کامپایلر پس‌زمینه (backend) هدایت می‌گردند.
.IP "\fB-b,--target \fItarget\fR"
سه‌تایی (triplet) معماری هدف را برای کامپایل چندسکویی (cross-compiling) مشخص می‌کند. سپس winegcc به‌جای gcc، دستور \fItarget\fR-gcc را اجرا خواهد کرد.
.IP "\fB--wine-objdir \fIdir\fR"
دایرکتوری شیء (object) مربوط به Wine را مشخص می‌کند. این گزینه هنگام ساخت خودِ Wine، جهت استفاده از هدرها و کتابخانه‌ها از داخل درخت ساخت (build tree) استفاده می‌شود.
.IP "\fB--winebuild \fIname\fR"
مسیر و نام فایل باینری \fBwinebuild\fR را که به‌طور خودکار توسط \fBwinegcc\fR راه‌اندازی می‌شود مشخص می‌کند. اگر تنظیم نشده باشد، \fBwinegcc\fR در مسیر (PATH) به دنبال فایلی به نام \fIwinebuild\fR خواهد گشت. این گزینه بر متغیر محیطی \fBWINEBUILD\fR اولویت دارد.
.IP \fB-fno-short-wchar\fR
نوع دادهٔ زیرین wchar_t را بازنویسی کرده و آن را به نوع پیش‌فرض هدف تبدیل می‌کند، به‌جای استفاده از short unsigned int که پیش‌فرض Win32 است.
.IP \fB-mconsole\fR
این گزینه آرگومان \(aq--subsystem console\(aq را برای ساخت برنامه‌های کنسولی به winebuild ارسال می‌کند. این رفتار پیش‌فرض است.
.IP \fB-mno-cygwin\fR
به‌جای پیوند خوردن با libc سیستم میزبان، از پیاده‌سازی MSVCRT در Wine استفاده می‌کند. این امر برای اکثریت قاطع برنامه‌های Win32 ضروری است، زیرا آن‌ها معمولاً به ویژگی‌های مختلف MSVCRT وابسته‌اند. این سوییچ توسط کامپایلر MinGW نیز در ویندوز برای پیوند خوردن با MSVCRT به‌جای Cygwin libc استفاده می‌شود. اشتراک نحوه نگارش با MinGW نوشتن Makefileهایی را که در Wine ،MinGW+MSYS یا MinGW+Cygwin کار کنند بسیار آسان می‌کند.
.IP \fB-municode\fR
نقطهٔ ورود پیش‌فرض برنامه را به‌جای \fBmain()\fR استاندارد، بر روی تابع یونیکد \fBwmain()\fR قرار می‌دهد.
.IP \fB-mwindows\fR
این گزینه -lgdi32 ،-lcomdlg32 و -lshell32 را به فهرست کتابخانه‌های پیش‌فرض اضافه کرده و آرگومان \(aq--subsystem windows\(aq را جهت ساخت برنامه‌های گرافیکی به winebuild ارسال می‌کند.
.IP \fB-nodefaultlibs\fR
هنگام پیوند دادن، از کتابخانه‌های استاندارد سیستم استفاده نمی‌کند. این موارد در کمترین حالت شامل -lkernel32 ،-luser32 ،-ladvapi32 و هر کتابخانهٔ پیش‌فرضی هستند که توسط کامپایلر پس‌زمینه استفاده می‌شود. گزینهٔ -mwindows همان‌طور که در بالا شرح داده شد، فهرست کتابخانه‌های پیش‌فرض را افزایش می‌دهد.
.IP \fB-nostartfiles\fR
هنگام پیوند دادن، کتابخانهٔ winecrt0 را اضافه نمی‌کند.
.IP \fB-Wb,\fIoption\fR
گزینه‌ای را به winebuild ارسال می‌کند. اگر \fIoption\fR شامل کاما باشد، در محل کاماها به چندین گزینه تقسیم می‌شود.
.IP \fB-Wl,--out-implib,\fIlib.a\fR
هنگام پیوند دادن یک dll، کتابخانهٔ واردات (import library) متناظر با آن را نیز ایجاد می‌کند.
.SH "محیط (ENVIRONMENT)"
.TP
.B WINEBUILD
مسیر و نام فایل باینری \fBwinebuild\fR را که به‌طور خودکار توسط \fBwinegcc\fR راه‌اندازی می‌شود مشخص می‌کند. اگر تنظیم نشده باشد، \fBwinegcc\fR در متغیر PATH به دنبال فایلی به نام \fIwinebuild\fR خواهد گشت.
.SH "تعاریف (DEFINES)"
دستور winegcc شناسهٔ __WINE__ را برای کدهایی تعریف می‌کند که باید بدانند چه زمانی تحت Wine کامپایل می‌شوند. همچنین برای سازگاری با MinGW، شناسه‌های WIN32 ،_WIN32 ،__WIN32 ،__WIN32__ ،__WINNT و __WINNT__ را تعریف می‌کند.
.SH "گزارش باگ‌ها (BUGS)"
در حال حاضر ویژگی‌های dllimport/dllexport به دلیل عدم پشتیبانی از این قابلیت‌ها در نسخهٔ ELF نرم‌افزار gcc پشتیبانی نمی‌شوند.
.PP
پیوند ایستا (Static linking) در حال حاضر در برابر DLLهای Wine پشتیبانی نمی‌شود. در نتیجه، گزینه‌های -static ،--static و -Wl,-static خطایی ایجاد خواهند کرد.
.PP
باگ‌ها را می‌توان در
.UR https://bugs.winehq.org
.B سامانه ردیابی باگ Wine
.UE
گزارش کرد.
.SH "نویسندگان (AUTHORS)"
.B winegcc
توسط Dimitrie O. Paun نوشته شده است.
.SH "در دسترس بودن (AVAILABILITY)"
.B winegcc
بخشی از توزیع Wine است که از طریق WineHQ،
.UR https://www.winehq.org
.B مقر توسعه Wine
.UE
در دسترس است.
.SH "همچنین ببینید (SEE ALSO)"
.BR gcc (1),
.BR winebuild (1),
.BR wrc (1),
.BR wine (1),
.br
.UR https://www.winehq.org/help
.B مستندات و پشتیبانی Wine
.UE .