.TH "GBS3" "1" "August 2024" "" ""

.SH "نام (NAME)"
gbs3 \- مفسر و اسکریپت‌نویس گامباس (GAMBAS)

.SH "خلاصه دستور (SYNOPSIS)"
.B gbs3
[\fIگزینه‌ها\fR] [\-\-] [<\fIفایل اسکریپت\fR> | <\fIدایرکتوری پروژه\fR> | \-]
.br
.B gbs3
\fB\-\-convert\-project\fR <\fIدایرکتوری مبدأ پروژه\fR> <\fIدایرکتوری مقصد اسکریپت\fR>
.br
.B gbs3
\fB\-\-convert\-script\fR <\fIفایل اسکریپت\fR> [<\fIمقصدی که دایرکتوری پروژه در آن ساخته می‌شود\fR>]
.br
.B gbs3
[\fB\-p\fR | \fB\-\-plugin\fR] <\fIفایل اسکریپت\fR> [<\fIدایرکتوری مقصدی که افزونه در آن ساخته می‌شود\fR>]

.SH "توضیحات (DESCRIPTION)"
گامباس (Gambas) یک محیط توسعه آزاد مبتنی بر مفسر بیسیک (Basic) با اکستنشن‌های شیءگرا و ترکیبی از Java و Visual Basic است.
با گامباس می‌توانید به‌سرعت رابط کاربری گرافیکی برنامه‌های خود را با Qt یا GTK+ طراحی کنید، به سیستم‌های پایگاه‌داده مانند MySQL، PostgreSQL، SQLite یا دیتابیس‌های ODBC دسترسی پیدا کنید، برنامه‌ها را با DBus هدایت نمایید، برنامه‌تان را به زبان‌های گوناگون ترجمه کنید، برنامه‌های GStreamer، OpenGL یا SDL بسازید، و مواردی از این دست...
.PP
.B gbs3
مفسری است که امکان کامپایل و اجرای اسکریپت‌های گامباس را فراهم می‌کند.
.br
همچنین از
.B gbs3
می‌توان برای تبدیل یک پروژه گامباس به اسکریپت، یا تبدیل مجدد یک اسکریپت به پروژه استفاده کرد.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-buildonly\fR
پردازش و کامپایل اسکریپت بدون اجرای آن
.TP
\fB\-c\fR, \fB\-\-nocache\fR
اجبار به کامپایل اسکریپت (عدم بررسی حافظه موقت / کَش)
.TP
\fB\-\-convert\-project\fR
تبدیل یک پروژه گامباس به یک فایل اسکریپت اجرایی گامباس
.TP
\fB\-\-convert\-script\fR
تبدیل یک فایل اسکریپت گامباس به یک پروژه گامباس
.TP
\fB\-e\fR
اجرای کد منبع ارائه‌شده از طریق خط فرمان (با جداکننده ':' )
.TP
\fB\-f\fR, \fB\-\-fast\fR
استفاده از کامپایلر درجا (Just\-In\-Time / JIT)
.TP
\fB\-g\fR, \fB\-\-debug\fR
افزودن اطلاعات اشکال‌زدایی به برنامه
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما و خروج
.TP
\fB\-l\fR, \fB\-\-list\fR
نمایش فهرستی از مؤلفه‌ها یا کتابخانه‌های دردسترس، با \fB\-l component\fR یا \fB\-l library\fR
.TP
\fB\-L\fR, \fB\-\-license\fR
نمایش مجوز برنامه
.TP
\fB\-p\fR, \fB\-\-plugin\fR
تولید یک افزونه اجرایی که می‌تواند توسط سایر اسکریپت‌ها بارگذاری شود
.TP
\fB\-S\fR, \fB\-\-strict\fR
شکست عملیات در صورت تعریف 'Public' یا 'Sub' بدون تابع 'main'؛ در غیر این صورت ()main ساخته می‌شود
.TP
\fB\-t\fR, \fB\-\-trace\fR
فعال‌سازی گزینه ردیابی هنگام اجرا
.TP
\fB\-T\fR, \fB\-\-terse\fR
چاپ گزارش خطای بسیار مختصر هنگام خطاهای کامپایل
.TP
\fB\-u\fR, \fB\-\-use\fR
بارگذاری مؤلفه‌ها یا کتابخانه‌ها ('comp1,comp2,lib1...')
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش خروجی با جزئیات کامل
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخه برنامه
.TP
\fB\-w\fR, \fB\-\-warnings\fR
نمایش هشدارها هنگام کامپایل

.SH "تبدیل پروژه (PROJECT CONVERSION)"
دستور
.B gbs3
می‌تواند با استفاده از گزینه
.B \-\-convert\-project
یک پروژه گامباس را به یک فایل اسکریپت اجرایی تبدیل کند.
دایرکتوری ورودی پروژه برای ایجاد اسکریپت استفاده شده و اسکریپت حاصل در دایرکتوری خروجی نوشته می‌شود.
اسکریپت با همان نام پروژه اصلی ایجاد و نام‌گذاری می‌شود.
.PP
.nf
gbs3 --convert-project MyProjectDirectory DestinationScriptDirectory
.fi

.SH "تبدیل اسکریپت (SCRIPT CONVERSION)"
دستور
.B gbs3
می‌تواند با استفاده از گزینه
.B \-\-convert\-script
یک فایل اسکریپت را به یک پروژه کامل گامباس تبدیل کند.
.PP
اسکریپت ورودی به پروژه‌ای با همان نام پایه (basename) اسکریپت تبدیل شده و در دایرکتوری مشخص‌شده ایجاد می‌شود.
در صورتی که دایرکتوری خروجی مشخص نشده باشد، از متغیر محیطی
.B PWD
به عنوان محل ایجاد پروژه گامباس استفاده می‌شود.
.PP
.nf
gbs3 --convert-script MyScript.gbs ~/Projects
.fi
.PP
این دستور دایرکتوری پروژه 'MyScript' را در دایرکتوری 'Projects' کاربر ایجاد می‌کند.

.SH "افزونه‌ها (PLUGINS)"
دستور
.B gbs3
می‌تواند پس از ساخته شدن با استفاده از گزینه
.B \-p
یا
.BR \-\-plugin ،
افزونه‌هایی ایجاد کند که توسط سایر اسکریپت‌ها یا برنامه‌های گامباس قابل استفاده باشند.
افزونه‌ها در یک دایرکتوری انتخابی کاربر ساخته می‌شوند و بر خلاف یک اسکریپت معمولی که فایل‌های اجرایی آن در دایرکتوری موقت ایجاد شده و از آنجا اجرا می‌شوند، در همان دایرکتوری اجرا و کَش می‌گردند.
این امر باعث می‌شود که افزونه‌ها پس از خروج اسکریپت‌نویس پایدار بمانند.
.PP
اگر مقصدی برای خروجی مشخص نشود، افزونه در دایرکتوری
.I ~/.local/lib/gambas
ایجاد می‌شود و می‌توان آن را از آنجا با استفاده از تابع
.B ()component.load
بارگذاری کرد.
.PP
.nf
gbs3 -p MyPluginScript [Plugin Destination Directory]
.fi

.SH "مثال (EXAMPLE)"
.nf
#!/usr/bin/env gbs3
for i as integer = 0 to 10
  print i;;
next
.fi

.SH "دسترس‌پذیری (AVAILABILITY)"
آخرین نسخه گامباس همیشه از نشانی زیر قابل دریافت است:
.br
\fBgambas.sourceforge.net\fR
.PP
مستندات این زبان در نشانی زیر قرار دارد:
.br
\fBhttp://gambaswiki.org/wiki\fR

.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به \fBhttp://gambaswiki.org/bugtracker\fR

.SH "حق نشر (COPYRIGHT)"
Copyright\(co Benoît Minisini <benoit.minisini@gambas-basic.org>;
.PP
این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به کد منبع مراجعه کنید.  هیچ‌گونه
ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.