.\" $Id: luac.man,v 1.29 2011/11/16 13:53:40 lhf Exp $
.TH LUAC 1 "$Date: 2011/11/16 13:53:40 $"
.SH "نام (NAME)"
luac \- کامپایلر Lua
.SH "خلاصه دستور (SYNOPSIS)"
.B luac
[
.I گزینه‌ها
] [
.I نام_فایل‌ها
]
.SH "توضیحات (DESCRIPTION)"
.B luac
کامپایلر Lua است.
این ابزار برنامه‌های نوشته‌شده به زبان برنامه‌نویسی Lua را به فایل‌های باینری
حاوی قطعه‌کدهای از پیش کامپایل‌شده ترجمه می‌کند
که بعداً می‌توانند بارگذاری و اجرا شوند.
.LP
مزایای اصلی قطعه‌کدهای پیش‌کامپایل‌شده عبارت‌اند از:
بارگذاری سریع‌تر،
محافظت از کد منبع در برابر تغییرات تصادفی کاربر،
و
بررسی نحو (syntax checking) به‌صورت آفلاین.
پیش‌کامپایل کردن به معنی اجرای سریع‌تر نیست،
زیرا در Lua قطعه‌کدها همواره پیش از اجرا به بایت‌کد کامپایل می‌شوند.
.B luac
صرفاً اجازه می‌دهد تا آن بایت‌کدها برای اجرای بعدی در یک فایل ذخیره شوند.
قطعه‌کدهای از پیش کامپایل‌شده لزوماً کوچک‌تر از کد منبع متناظر خود نیستند.
هدف اصلی در پیش‌کامپایل کردن، بارگذاری سریع‌تر است.
.LP
در خط فرمان،
می‌توانید فایل‌های متنی حاوی کد منبع Lua و
فایل‌های باینری حاوی قطعه‌کدهای از پیش کامپایل‌شده را با یکدیگر ترکیب کنید.
.B luac
یک فایل خروجی واحد تولید می‌کند که حاوی بایت‌کدهای ترکیب‌شده
برای تمام فایل‌های داده‌شده است.
اجرای فایل ترکیب‌شده معادل اجرای تک‌تک فایل‌های ارائه‌شده است.
به‌طور پیش‌فرض،
نام فایل خروجی
.BR luac.out
است، اما می‌توانید این نام را با گزینهٔ
.B \-o
تغییر دهید.
.LP
قطعه‌کدهای از پیش کامپایل‌شده بین معماری‌های گوناگون
.I قابل‌حمل نیستند\c
.
علاوه بر این،
احتمال دارد ساختار درونی قطعه‌کدهای از پیش کامپایل‌شده
با انتشار نسخهٔ جدیدی از Lua تغییر کند.
اطمینان حاصل کنید که فایل‌های منبع تمام برنامه‌های Lua را که پیش‌کامپایل می‌کنید، نگه‌داری نمایید.
.LP
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-l
فهرستی از بایت‌کدهای کامپایل‌شده برای ماشین مجازی Lua تولید می‌کند.
فهرست کردن بایت‌کدها برای آشنایی با ماشین مجازی Lua مفید است.
اگر فایلی مشخص نشود،
.B luac
فایل
.B luac.out
را بارگذاری کرده و محتویات آن را فهرست می‌کند.
برای دریافت فهرست کامل از
.B \-l \-l
استفاده کنید.
.TP
.BI \-o " file"
خروجی را به‌جای نام پیش‌فرض
.BR luac.out ،
در
.IR file
می‌نویسد.
(می‌توانید از
.B "'\-'"
برای خروجی استاندارد استفاده کنید،
اما نه در پلتفرم‌هایی که خروجی استاندارد را در حالت متنی باز می‌کنند.)
فایل خروجی می‌تواند یکی از همان فایل‌های داده‌شده باشد، زیرا
تمام فایل‌ها قبل از بازنویسی فایل خروجی بارگذاری می‌شوند.
مراقب باشید فایل‌های باارزش خود را بازنویسی نکنید.
.TP
.B \-p
فایل‌ها را بارگذاری می‌کند اما هیچ فایل خروجی تولید نمی‌کند.
عمدتاً برای بررسی نحو و آزمایش قطعه‌کدهای از پیش کامپایل‌شده به کار می‌رود:
فایل‌های معیوب احتمالاً هنگام بارگذاری با خطا مواجه می‌شوند.
اگر هیچ فایلی داده نشود،
.B luac
فایل
.B luac.out
را بارگذاری کرده و محتویات آن را آزمایش می‌کند.
چنانچه فایل بدون خطا بارگذاری شود، هیچ پیامی نمایش داده نخواهد شد.
.TP
.B \-s
اطلاعات اشکال‌زدایی (debug) را پیش از نوشتن فایل خروجی حذف (strip) می‌کند.
این کار در قطعه‌کدهای بسیار بزرگ مقداری در فضا صرفه‌جویی می‌کند،
اما اگر در زمان اجرای یک قطعه‌کد خلاصه‌شده خطایی رخ دهد،
پیام‌های خطا ممکن است اطلاعات کاملی که معمولاً ارائه می‌دهند را نداشته باشند.
به‌ویژه، شماره خطوط و نام متغیرهای محلی از بین می‌روند.
.TP
.B \-v
اطلاعات نسخه را نمایش می‌دهد.
.TP
.B \-\-
پردازش گزینه‌ها را متوقف می‌کند.
.TP
.B \-
پردازش گزینه‌ها را متوقف کرده و ورودی استاندارد را پردازش می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR lua (1)
.br
مستندات در lua.org.
.SH "خطاها (DIAGNOSTICS)"
پیام‌های خطا باید خودتوضیح باشند.
.SH "نویسندگان (AUTHORS)"
R. Ierusalimschy,
L. H. de Figueiredo,
W. Celes
.\" EOF