REGINA-ENGINE-CONFIG(1) The Regina Handbook REGINA-ENGINE-CONFIG(1)

regina-engine-config - دریافت پرچم‌های کامپایلر و پیونددهنده برای ساخت نرم‌افزار بر پایه Regina

regina-engine-config [ --prefix ] [ --version ] [ --cflags ] [ --libs ]

این ابزار مشخص می‌کند که چه پرچم‌های کامپایلر و پیونددهنده‌ای (linker) باید برای ساخت و ادغام موتور ریاضیاتی Regina در برنامه‌های شما به کار روند. موتور ریاضیاتی Regina معمولاً در کتابخانهٔ libregina-engine.so نصب می‌شود.

این ابزار فقط در شرایط خاصی در دسترس است:

•
اگر از GNU/Linux استفاده می‌کنید و Regina در مکانی سیستمی (مثلاً در زیرمسیر /usr/ یا /usr/local/) نصب شده است، در این صورت regina-engine-config باید همراه با نصب شما ارائه شده باشد و پرچم‌های کامپایلر/پیونددهنده را متناسب با این نصب سیستمی در خروجی چاپ کند.
•
اگر خودتان Regina را از درخت کد مبدأ (source tree) روی هر پلتفرمی کامپایل می‌کنید، می‌توانید regina-engine-config را از همان درخت کد مبدأ اجرا کنید، و خروجی پرچم‌های کامپایلر/پیونددهنده نسبت به همان درخت کد مبدأ خواهد بود. به‌ویژه، برای کارکرد این پرچم‌های کامپایلر/پیونددهنده نیازی به نصب نهایی Regina ندارید.
•
اگر از بسته‌های از پیش ساخته‌شدهٔ Regina در macOS یا Windows استفاده می‌کنید، ابزار regina-engine-config در بستهٔ نصبی شما گنجانده نخواهد شد.

به‌جای استفاده از regina-engine-config به‌عنوان بخشی از فرایند کامپایل، ممکن است ایجاد یک Makefile با استفاده از regina-helper و سپس استفادهٔ ساده از دستور make برای شما آسان‌تر باشد.

پیشوند محل نصبی که Regina در آن نصب شده است را چاپ می‌کند.
نسخهٔ فعلی نصب‌شدهٔ Regina را چاپ می‌کند. این خروجی شامل هر رشتهٔ BUILD_INFO که هنگام ساخت Regina تنظیم شده باشد نیز خواهد بود.
پرچم‌های کامپایلر را که برای کامپایل برنامه‌ای با استفاده از موتور محاسباتی Regina لازم است، چاپ می‌کند.
پرچم‌های پیونددهنده را که برای پیوند دادن یک برنامه با موتور محاسباتی Regina لازم است، چاپ می‌کند.

example$ regina-engine-config --cflags
-std=c++20
-I/usr/include/regina-normal -I/usr/include -I/usr/include/libxml2
example$

regina-helper.

این ابزار توسط Benjamin Burton <bab@maths.uq.edu.au> نوشته شده است. افراد زیادی در توسعهٔ Regina مشارکت داشته‌اند؛ برای دیدن فهرست کامل دست‌اندرکاران به راهنمای کاربران مراجعه کنید.

این اسکریپت در گذشته‌های دور بر اساس gtk-config ساخته شده بود، اگرچه امروزه بخش بسیار کمی از آن باقی مانده است. نسخهٔ اصلی gtk-config دارای کپی‌رایت (C) 1998 متعلق به Owen Taylor بوده و از مجوزی به سبک MIT استفاده می‌کرد؛ برای جزئیات کامل به اسکریپت regina-engine-config مراجعه کنید.

25 August 2025