'\" t
.\"     Title: crystal-spec
.\"    Author: [بخش "نویسندگان (AUTHORS)" را ببینید]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-07-23
.\"    Manual: Crystal Compiler Command Line Reference Guide
.\"    Source: crystal 1.21.0
.\"  Language: Persian
.\"
.TH "CRYSTAL\-SPEC" "1" "2026-07-23" "crystal 1.21.0" "Crystal Compiler Command Line Reference Guide"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
crystal-spec \- کامپایل و اجرای فایل‌های مشخصات (spec) زبان کریستال
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcrystal spec\fP [گزینه‌ها] [فایل‌ها]
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-d\fP, \fB\-\-debug\fP
.RS 4
تولید خروجی همراه با نمادهای اشکال‌زدایی (debug symbols). این نمادها هنگام اشکال‌زدایی برنامه ساخته‌شده با ابزارهایی مانند lldb، gdb، valgrind و غیره خوانده می‌شوند و نگاشت‌هایی به کد منبع اصلی برای آن ابزارها فراهم می‌کنند.
.RE
.sp
\fB\-\-no\-debug\fP
.RS 4
تولید خروجی بدون هیچ‌گونه نماد اشکال‌زدایی.
.RE
.sp
\fB\-D\fP \fIFLAG\fP, \fB\-\-define\fP \fIFLAG\fP
.RS 4
تعریف یک فلگ زمان کامپایل. این قابلیت برای تعریف شرطی انواع (types)، متدها یا دستورات بر اساس فلگ‌های موجود در زمان کامپایل مفید است. فلگ‌های پیش‌فرض از سه‌گانه هدف (target triple) مشخص‌شده با \fB\-\-target\-triple\fP یا پیش‌فرض میزبان (در صورت عدم تعیین) گرفته می‌شوند.
.RE
.sp
\fB\-\-error\-trace\fP
.RS 4
نمایش ردگیری کامل خطا (error trace).
.RE
.sp
\fB\-O\fP \fILEVEL\fP
.RS 4
حالت بهینه‌سازی: 0 (پیش‌فرض)، 1، 2، 3. برای جزئیات \fBبهینه‌سازی‌ها (OPTIMIZATIONS)\fP را ببینید.
.RE
.sp
\fB\-\-release\fP
.RS 4
کامپایل در حالت نهایی (release). معادل با \fB\-O3 \-\-single\-module\fP
.RE
.sp
\fB\-s\fP, \fB\-\-stats\fP
.RS 4
چاپ آمار مراحل مختلف کامپایلر برای ساخت فعلی. خروجی شامل زمان و حافظه مصرفی برای هر فرآیند کامپایلر است.
.RE
.sp
\fB\-p\fP, \fB\-\-progress\fP
.RS 4
چاپ آمار پیشرفت ساخت فعلی.
.RE
.sp
\fB\-t\fP, \fB\-\-time\fP
.RS 4
چاپ آمار مربوط به زمان اجرا.
.RE
.sp
\fB\-\-no\-color\fP
.RS 4
غیرفعال کردن خروجی رنگی.
.RE