'\" t
.\"     Title: asdlgen
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-11-04
.\"    Manual: \ \&
.\"    Source: SML/NJ
.\"  Language: English
.\"
.TH "ASDLGEN" "1" "2025-11-04" "SML/NJ" "\ \&"
.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)"
asdlgen \- کامپایلر زبان توصیف نحو انتزاعی (ASDL)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBasdlgen\fP \fICOMMAND\fP [ \fIOPTIONS\fP ] \fIFILE\fP ...
.sp
که در آن \fICOMMAND\fP یکی از موارد زیر است:
.sp
\fBhelp\fP
.RS 4
اطلاعات مربوط به گزینه‌های موجود را در خروجی استاندارد چاپ می‌کند.
.RE
.sp
\fBversion\fP
.RS 4
نسخهٔ \fBasdlgen\fP را در خروجی استاندارد چاپ می‌کند.
.RE
.sp
\fBc++\fP یا \fBcxx\fP
.RS 4
تولید کد \fBC++\fP.
.RE
.sp
\fBsml\fP
.RS 4
تولید کد \fBSML\fP.
.RE
.sp
\fBcheck\fP
.RS 4
بررسی صحت مشخصات ورودی، بدون تولید هیچ خروجی.
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBasdlgen\fP فایل‌های مشخص‌شده را که باید حاوی اعلانات ماژول و نمای (view) ASDL باشند می‌خواند و کدهای pickling و unpickling را تولید می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی (COMMON OPTIONS)"
.sp
\fB\-n\fP
.RS 4
هیچ فایل خروجی نوشته نمی‌شود. در عوض، فهرست فایل‌هایی که قرار بود نوشته شوند در خروجی استاندارد چاپ می‌شود.
.RE
.sp
\fB\-d\fP \fIDIR\fP, \fB\-\-output\-directory=\fP\fIDIR\fP
.RS 4
دایرکتوری خروجی را برای قرار دادن فایل‌های تولیدشده مشخص می‌کند. به طور پیش‌فرض، خروجی در همان دایرکتوری فایل ورودی که از آن تولید شده است قرار می‌گیرد.
.RE
.sp
\fB\-\-gen=\fP\fINAMES\fP
.RS 4
اجزای مورد نظر برای تولید را مشخص می‌کند، که در آن \fINAMES\fP فهرستی از نام‌های جداشده با کاما از موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBtypes\fP \(em تعاریف نوع را بر اساس مشخصات ASDL تولید می‌کند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBmemory\fP \(em تولید pickler حافظه.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBfile\fP \(em تولید pickler فایل.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBsexp\fP \(em تولید pickler مبتنی بر S\-Expression (فقط برای SML).
.RE
.RE
.SS "گزینه‌های C++ (C++ OPTIONS)"
.sp
\fB\-\-base\-include=\fP\fIFILE\fP
.RS 4
نام فایل هدر \fBC++\fP را که انواع پایه و توابع اولیه ASDL را تعریف می‌کند مشخص می‌کند. مقدار پیش‌فرض asdl/asdl.hxx است.
.RE
.SS "گزینه‌های SML (SML OPTIONS)"
.sp
\fB\-\-cm=\fP\fIFILE\fP
.RS 4
یک فایل CM برای pickler تولید می‌کند؛ این یک کتابخانهٔ CM تعریف خواهد کرد. توجه داشته باشید که اگر مشخصات ASDL شامل ماژول‌های اولیه باشد، این ماژول‌ها در فهرست ساختارهای صادرشده (exported structures) قرار خواهند گرفت، اما فایل‌های مبدأ پشتیبان باید به صورت دستی به فایل CM اضافه شوند.
.RE
.sp
\fB\-\-mlb=\fP\fIFILE\fP
.RS 4
یک فایل MLB برای pickler تولید می‌کند. توجه داشته باشید که اگر مشخصات ASDL شامل ماژول‌های اولیه باشد، این موارد در فهرست ساختارهای صادرشده قرار خواهند گرفت، اما فایل‌های مبدأ پشتیبان باید به صورت دستی به فایل MLB اضافه شوند.
.RE
.SH "نویسندگان (AUTHORS)"
.sp
نسخهٔ اولیهٔ \fBasdlgen\fP توسط Dan Wang به عنوان بخشی از پروژهٔ National Compiler Infrastructure در دانشگاه پرینستون نوشته شد. این نسخه از ابزار توسط John Reppy پیاده‌سازی شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIASDL Reference Manual\fP (در مستندات \fBSML/NJ\fP گنجانده شده است).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
Copyright \(co 2020 The Fellowship of SML/NJ
.sp
این یک نرم‌افزار آزاد است؛ شرایط تکثیر را در سورس‌کد مشاهده کنید. هیچ تضمینی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.