.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "REGINA-ENGINE-CONFIG" "1" "25 August 2025" "" "The Regina Handbook"

.SH "نام (NAME)"
regina-engine-config \- دریافت پرچم‌های کامپایلر و پیونددهنده برای ساخت نرم‌افزار بر پایه Regina
.SH "خلاصه دستور (SYNOPSIS)"

\fBregina-engine-config\fR [ \fB--prefix\fR ] [ \fB--version\fR ] [ \fB--cflags\fR ] [ \fB--libs\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
این ابزار مشخص می‌کند که چه پرچم‌های کامپایلر و پیونددهنده‌ای (linker) باید برای ساخت و ادغام موتور ریاضیاتی Regina در برنامه‌های شما به کار روند.
موتور ریاضیاتی Regina معمولاً در کتابخانهٔ
\fIlibregina-engine.so\fR\& نصب می‌شود.
.PP
این ابزار فقط در شرایط خاصی در دسترس است:
.TP 0.2i
\(bu
اگر از \fBGNU/Linux\fR استفاده می‌کنید و Regina در مکانی سیستمی (مثلاً در زیرمسیر \fI/usr/\fR یا
\fI/usr/local/\fR) نصب شده است، در این صورت
\fBregina-engine-config\fR باید همراه با نصب شما ارائه شده باشد و پرچم‌های کامپایلر/پیونددهنده را متناسب با این نصب سیستمی در خروجی چاپ کند.
.TP 0.2i
\(bu
اگر خودتان Regina را از درخت کد مبدأ (source tree) روی هر پلتفرمی کامپایل می‌کنید، می‌توانید \fBregina-engine-config\fR را
از همان درخت کد مبدأ اجرا کنید، و خروجی پرچم‌های کامپایلر/پیونددهنده نسبت به همان درخت کد مبدأ خواهد بود. به‌ویژه، برای کارکرد این پرچم‌های کامپایلر/پیونددهنده نیازی به نصب نهایی Regina ندارید.
.TP 0.2i
\(bu
اگر از بسته‌های از پیش ساخته‌شدهٔ Regina در \fBmacOS\fR یا \fBWindows\fR استفاده می‌کنید،
ابزار \fBregina-engine-config\fR در بستهٔ نصبی شما گنجانده نخواهد شد.
.PP
به‌جای استفاده از \fBregina-engine-config\fR به‌عنوان بخشی از فرایند کامپایل، ممکن است ایجاد یک Makefile با استفاده از
\fBregina-helper\fR
و سپس استفادهٔ ساده از دستور \fBmake\fR برای شما آسان‌تر باشد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--prefix\fR
پیشوند محل نصبی که Regina در آن نصب شده است را چاپ می‌کند.
.TP
\fB--version\fR
نسخهٔ فعلی نصب‌شدهٔ Regina را چاپ می‌کند. این خروجی شامل هر رشتهٔ \fIBUILD_INFO\fR که هنگام ساخت Regina تنظیم شده باشد نیز خواهد بود.
.TP
\fB--cflags\fR
پرچم‌های کامپایلر را که برای کامپایل برنامه‌ای با استفاده از موتور محاسباتی Regina لازم است، چاپ می‌کند.
.TP
\fB--libs\fR
پرچم‌های پیونددهنده را که برای پیوند دادن یک برنامه با موتور محاسباتی Regina لازم است، چاپ می‌کند.
.SH "مثال‌ها (EXAMPLES)"

.nf
    example$ \fBregina-engine-config --cflags\fR
    -std=c++20
    -I/usr/include/regina-normal -I/usr/include -I/usr/include/libxml2
    example$
.fi
.SH "همچنین ببینید (SEE ALSO)"
.PP
regina-helper\&.
.SH "نویسندگان (AUTHORS)"
.PP
این ابزار توسط Benjamin Burton
<bab@maths.uq.edu.au>\& نوشته شده است.
افراد زیادی در توسعهٔ Regina مشارکت داشته‌اند؛ برای دیدن فهرست کامل دست‌اندرکاران به راهنمای کاربران مراجعه کنید.
.PP
این اسکریپت در گذشته‌های دور بر اساس \fBgtk-config\fR ساخته شده بود، اگرچه امروزه بخش بسیار کمی از آن باقی مانده است. نسخهٔ اصلی
\fBgtk-config\fR دارای کپی‌رایت\~(C)\~1998 متعلق به
Owen Taylor بوده و از مجوزی به سبک MIT استفاده می‌کرد؛ برای جزئیات کامل به اسکریپت
\fBregina-engine-config\fR مراجعه کنید.