.TH FENNEL 1

.SH "نام (NAME)"
fennel \- یک زبان برنامه‌نویسی لیسپ که روی Lua اجرا می‌شود
.SH "خلاصه دستور (SYNOPSIS)"
.B fennel
[\fB--repl\fR] |
[\fB--compile \fIfilename\fR] |
[\fB--eval \fIsource\fR] |
[\fIfilename\fP] [\fIargs ...\fR]

.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما به طور خلاصه دستور
.B fennel
را شرح می‌دهد.
.PP
.B fennel
نقطه ورود اصلی برای Fennel است؛ یک زبان برنامه‌نویسی لیسپ که بر روی محیط‌های زمان اجرای Lua اجرا می‌شود. بدون هیچ گزینه یا آرگومانی، یک حلقه تعاملی خواندن-ارزیابی-چاپ (REPL) را اجرا می‌کند.
.PP
در صورت دریافت نام یک فایل به عنوان نخستین آرگومان، آن فایل را اجرا کرده و آرگومان‌های بعدی را به آن ارسال می‌کند. کامپایل پیش از موعد (AOT) با پرچم
.B --compile
قابل فراخوانی است، در حالی که قطعه‌کدهای کوتاه را می‌توان با آرگومان
.B --eval
ارزیابی کرد.

.SH "گزینه‌ها (OPTIONS)"
خلاصه‌ای از گزینه‌ها در زیر آمده است.
.TP
.B \-\-repl
شروع یک نشست تعاملی REPL. در صورت ارائه نشدن هیچ آرگومانی، این گزینه پیش‌فرض است.
.TP
.B \-\-compile \fIfilename\fP
انجام کامپایل پیش از موعد بر روی فایل ارائه‌شده و نوشتن خروجی Lua در خروجی استاندارد.
.TP
.B \-\-eval \fIsource\fP
ارزیابی یک قطعه کد منبع داده‌شده و چاپ نتیجه.
.TP
.B \-\-no-searcher
هنگام اجرای یک REPL یا یک فایل،
.B fennel.searcher
به طور پیش‌فرض نصب می‌شود تا تابع
.B require
بتواند علاوه بر فایل‌های Lua، فایل‌های Fennel را نیز بارگذاری کند. این پرچم این رفتار را غیرفعال می‌کند. روی کامپایل پیش از موعد تأثیری ندارد.
.TP
.B \-\-add-package-path \fIpath\fP
افزودن مسیر ارائه‌شده به
.B package.path
تا تابع
.B require
بداند هنگام جستجو برای ماژول‌های Lua در آنجا جستجو کند.
.TP
.B \-\-add-fennel-path \fIpath\fP
مشابه مورد بالا، اما برای مسیری از Fennel که هنگام جستجو برای ماژول‌های Fennel استفاده می‌شود.
.TP
.B \-\-globals \fIVAR1[,VAR2...]\fP
مجاز شمردن VAR1، VAR2 و غیره به عنوان متغیرهای سراسری علاوه بر مجموعه استاندارد سراسری‌ها. این کار بررسی دقیق متغیرهای سراسری را حتی در کامپایل پیش از موعد (که در غیر این صورت غیرفعال بود) فعال می‌کند. برای غیرفعال کردن بررسی متغیرهای سراسری از "*" استفاده کنید.
.TP
.B \-\-globals-only \fIVAR1[,VAR2...]\fP
مشابه مورد بالا، اما بدون در نظر گرفتن مجموعه متغیرهای سراسری استاندارد.
.TP
.B \-\-require-as-include
به جای بارگذاری ماژول‌های require شده در زمان اجرا، آن‌ها را به صورت درون‌خطی (inline) در داخل فایل اصلی در حال کامپایل قرار می‌دهد. فقط در هنگام کامپایل پیش از موعد کاربرد دارد.
.TP
.B \-\-to-be-closed
هنگام کامپایل
.B with-open
از قابلیت to-be-closed در نسخه Lua 5.4+ استفاده می‌کند تا از تداخل با ردگیری‌ها (traces) جلوگیری شود.
.TP
.B \-\-assert-as-repl
فراخوانی‌های تابع توکار
.B assert
از Fennel با فراخوانی‌هایی به
.B assert-repl
جایگزین می‌شوند تا در صورت شکست assertion، یک REPL آغاز شود که بتوانید در آن به صورت تعاملی اشکال‌زدایی کنید.
.TP
.B \-\-lambda-as-fn
تعاریف تابع
.B lambda
را با
.B fn\fR
جایگزین می‌کند، که سربار زمان اجرا ناشی از بررسی تعداد آرگومان‌ها (arity) را حذف می‌کند.
.TP
.B \-\-use-bit-lib
کامپایل عملیات بیتی به منظور استفاده از کتابخانه bitop در LuaJIT به جای عملگرهای بیتی Lua 5.3+.
.TP
.B \-\-load \fIFILE\fP
بارگذاری فایل مشخص‌شده پیش از اجرای هر دستوری.
.TP
.B \-\-compile-binary \fIFILE\fP \fIOUT\fP \fILUA_LIB\fP \fILUA_DIR\fP
کامپایل FILE به یک فایل باینری مستقل OUT با استفاده از LUA_LIB و فایل‌های هدر Lua در LUA_DIR. برای جزئیات به
.B \-\-compile-binary \-\-help
مراجعه کنید.
.TP
.B \-\-no\-compiler\-sandbox
عدم محدود کردن محیط کامپایلر (استفاده‌شده در ماکروها) به یک سندباکس حداقلی.
.TP
.B \-\-keywords \fIKEYWORD1[,KEYWORD2...]\fP
در نظر گرفتن این نمادها به عنوان کلمات کلیدی رزروشده Lua.
.TP
.B \-h, \-\-help
چاپ پیام راهنما و خروج
.TP
.B \-v, \-\-version
چاپ شماره نسخه و خروج
.PP
از متغیر محیطی NO_COLOR برای غیرفعال کردن کدهای فرار در پیام‌های خطا استفاده کنید.

.SH "همچنین ببینید (SEE ALSO)"

.MR fennel-api 3 ,
.MR fennel-reference 5 ,
.MR fennel-tutorial 7

معناشناسی (semantics) بسیار نزدیک به Lua است، بنابراین کتابچه راهنمای مرجع Lua نیز مفید است.

.SH "جامعه کاربری (COMMUNITY)"

فهرست پستی در https://lists.sr.ht/~technomancy/fennel و سامانه ردیابی مشکلات در https://dev.fennel-lang.org قرار دارد. بیشتر گفتگوها در کانال ‎#fennel در گفتگوی Libera صورت می‌گیرد.

.SH "نویسندگان (AUTHORS)"
Calvin Rose و Phil Hagelberg و مشارکت‌کنندگان:
https://github.com/bakpakin/Fennel/graphs/contributors

.SH "مجوز (LICENSE)"
حق نشر © 2016-2025، منتشرشده تحت مجوز MIT/X11