.TH CEPL: "1" "ژوئیه 2024" "cepl-32\&.1\&.0" "دستورات کاربر"

.SH "نام (NAME)"
cepl \- یک محیط تعاملی REPL برای C و ++C

.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcepl\fR [\-hpvw] [\-a\fI<out.s>\fR] [\-c\fI<compiler>\fR] \
[\-e\fI<code to evaluate>\fR] [\-l\fI<library>\fR] \
[\-I\fI<include directory>\fR] [\-L\fI<library directory>\fR] \
[\-s\fI<standard>\fR] [\-o\fI<out\&.c>\fR]
.fi

.SH "توضیحات (DESCRIPTION)"
.sp
یک REPL مبتنی بر readline برای زبان‌های C و ++C به همراه تاریخچه دستورات، تکمیل خودکار با Tab، و قابلیت واگرد (undo).
.fi

.SH "نحوه استفاده (USAGE)"
.sp
متغیرهای محیطی زیر در نظر گرفته می‌شوند: \fBCFLAGS\fR، \fBLDFLAGS\fR، \fBLDLIBS\fR و \fBLIBS\fR.
.sp
تاریخچه دستورات از فایل \fI~/\&.cepl_history\fR خوانده و در آن ذخیره می‌شود.
.sp
برای جابه‌جایی میان حالت‌های C و ++C، کامپایلر C یا ++C خود را با \fI\-c\fR مشخص کنید، مانند:
.sp
    \fIcepl -cg++ -lboost_filesystem -lboost_context -lboost_system\fR
.sp
برای اجرا در حالت ++C با پیوند به Boost و کامپایل با g++، یا:
.sp
    \fIcepl -cclang -lelf\fR
.sp
برای اجرا در حالت C با پیوند به libelf و کامپایل با clang.
.sp
هنگامی که گزینه \fI\-l\fR ارسال می‌شود، کتابخانه مشخص‌شده برای یافتن نمادها اسکن می‌شود و سپس به تکمیل خودکار readline افزوده می‌گردد.
.fi

.SS "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های خط فرمان:
.fi

.HP
\fB\-a\fR, \fB\-\-asm\fR		نام فایلی که کد اسمبلی در آن ذخیره می‌شود
.HP
\fB\-c\fR, \fB\-\-compiler\fR	تعیین کامپایلر جایگزین
.HP
\fB\-e\fR, \fB\-\-eval\fR	ارزیابی آرگومان به‌عنوان کد C/C++
.HP
\fB\-h\fR, \fB\-\-help\fR	نمایش اطلاعات راهنما و نحوه استفاده
.HP
\fB\-o\fR, \fB\-\-output\fR	نام فایلی که کد C/C++ در آن ذخیره می‌شود
.HP
\fB\-p\fR, \fB\-\-parse\fR	غیرفعال کردن افزودن نمادهای کتابخانه پویا به تکمیل readline
.HP
\fB\-s\fR, \fB\-\-std\fR		تعیین استاندارد مورد استفاده برای C/C++
.HP
\fB\-v\fR, \fB\-\-version\fR	نمایش اطلاعات نسخه
.HP
\fB\-w\fR, \fB\-\-warnings\fR	کامپایل با فلگ‌های \fB\-Wall\fR \fB\-Wextra\fR \fB\-pedantic\fR
.HP
\fB\-l\fR			پیوند به کتابخانه مشخص‌شده (قابل تکرار)
.HP
\fB\-I\fR			جستجوی دایرکتوری برای فایل‌های هدر (قابل تکرار)
.HP
\fB\-L\fR			جستجوی دایرکتوری برای کتابخانه‌ها (قابل تکرار)
.fi

.SS "دستورات (COMMANDS)"
.sp
خطوطی که با پیشوند \fB;\fR آغاز می‌شوند به‌عنوان دستور تفسیر می‌گردند (متن درون \fB[]\fR اختیاری است)
.fi

.HP
\fB;f[unction]\fR	خط خارج از ()main تعریف می‌شود (مثلاً \fB;f #define SWAP2(X) ((((X) >> 8) & 0xff) | (((X) & 0xff) << 8))\fR)
.HP
\fB;h[elp]\fR		نمایش راهنما
.HP
\fB;m[an]\fR		نمایش صفحه راهنما برای شناسه (مثلاً \fB;m strpbrk\fR)
.HP
\fB;q[uit]\fR		خروج از CEPL
.HP
\fB;r[eset]\fR		بازنشانی CEPL به وضعیت اولیه برنامه
.HP
\fB;u[ndo]\fR		واگرد تدریجی (قابل تکرار)
.fi

.SH "نکات (NOTES)"
.sp
لطفاً گزارش باگ‌ها، مشکلات یا درخواست قابلیت‌های جدید را به <\fIhttps://github.com/alyptik/cepl\fR> ارسال فرمایید.
.fi

.SH "نویسندگان (AUTHORS)"
.ie n \{\
 \h'-04'\(bu\h'+03'\c \&.\}
.el \{\
.sp -1
.IP \(bu 2\&.3
.\}
Joey Pabalinas <\fIjoeypabalinas@gmail.com\fR>
.fi