.\" Automatically generated by Pandoc 2.5
.\"
.TH "ros" "1" "" "" ""
.hy
.PP
Roswell \- ابزار راه‌اندازی و مدیریت محیط Common Lisp
.SH "خلاصه دستور (SYNOPSIS)"
.IP \[bu] 2
\f[B]ros\f[R] [\f[B]options\f[R]] \f[C][command [args...]\f[R]
.IP \[bu] 2
\f[B]ros\f[R] [\f[B]options\f[R]] \f[C][\-\-]script [args...]\f[R]
.IP \[bu] 2
\f[B]ros\f[R] [\f[B]options\f[R]] < script.ros
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار Roswell یک ابزار خط فرمانی برای نصب و مدیریت پیاده‌سازی‌های Common Lisp و همچنین یک زیرساخت اسکریپت‌نویسی برای الگوسازی، نوشتن، اجرا، کامپایل، توزیع، بارگیری و نصب ROSWELL\-SCRIPTS نوشته‌شده به زبان Common Lisp است.
.PP
در حال حاضر roswell از sbcl، ccl، clisp و ecl به عنوان پیاده‌سازی‌های لیسپ پشتیبانی می‌کند.
برای جزئیات بیشتر به \f[I]ros\-install\f[R](1) مراجعه کنید.
.PP
اسکریپت‌های نصب‌شده توسط roswell در صورتی که دایرکتوری مناسب در PATH گنجانده شده باشد، در سراسر سیستم در دسترس خواهند بود.
.SH "زیرفرمان‌ها (SUBCOMMANDS)"
.PP
به ترتیب کاربرد و بسامد استفاده:
.TP
.B install
نصب یک پیاده‌سازی مشخص (مانند sbcl، ccl) یا یک سامانه (مانند alexandria) برای محیط roswell.
به \f[I]ros\-install\f[R](1) مراجعه کنید.
.TP
.B init [name[.ros]]
ایجاد یک اسکریپت ros جدید.
پسوند \f[C].ros\f[R] اختیاری است و به‌طور خودکار افزوده می‌شود.
به \f[I]ros\-init\f[R] مراجعه کنید.
.TP
.B dump [executable|output] [script]
تخلیهٔ یک ایمیج از اسکریپت برای راه‌اندازی سریع‌تر یا ساخت یک فایل اجرایی.
به \f[I]ros\-dump\f[R] مراجعه کنید.
.TP
.B build
ساخت یک فایل اجرایی از روی اسکریپت.
به \f[I]ros\-build\f[R] مراجعه کنید.
.TP
.B run
شروع محیط تعاملی REPL.
به \f[I]ros\-run\f[R] مراجعه کنید.
.TP
.B use
تغییر پیاده‌سازی پیش‌فرض مورد استفاده توسط roswell.
به \f[I]ros\-use\f[R] مراجعه کنید.
.TP
.B list
فهرست کردن اطلاعات گوناگون.
به \f[I]ros\-list\f[R] مراجعه کنید.
.TP
.B config
دریافت و تنظیم گزینه‌ها.
به \f[I]ros\-config\f[R] مراجعه کنید.
.TP
.B setup
اجرای پیکربندی و راه‌اندازی اولیه.
به \f[I]ros\-setup\f[R] مراجعه کنید.
.TP
.B emacs
راه‌اندازی emacs به همراه slime.
به \f[I]ros\-emacs\f[R] مراجعه کنید.
.TP
.B wait
انتظار نامحدود؛ برای دیمن کردن (daemonize) اسکریپت استفاده می‌شود.
به \f[I]ros\-wait\f[R] مراجعه کنید.
.TP
.B delete
حذف یک پیاده‌سازی نصب‌شده.
به \f[I]ros\-delete\f[R] مراجعه کنید.
.TP
.B version
نمایش اطلاعات نسخهٔ roswell.
به \f[I]ros\-version\f[R] مراجعه کنید.
.TP
.B help
نمایش راهنمای زیرفرمان.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌ها به ترتیب از چپ به راست پردازش می‌شوند.
.TP
.B \-w CODE \[en]wrap CODE
اجرای اسکریپت به همراه پوستهٔ پیچنده (wrapper) CODE، مانند rlwrap
.TP
.B \-m IMAGE \[en]image IMAGE
ادامه از ایمیج لیسپ IMAGE
.TP
.B \-L NAME \[en]lisp NAME
اجرای اسکریپت با پیاده‌سازی لیسپ NAME[/VERSION] در صورت وجود،
مانند sbcl\-bin یا sbcl/1.2.16؛
در غیر این صورت با شکست مواجه می‌شود.
.TP
.B \-l FILE \[en]load FILE
بارگذاری فایل لیسپ FILE هنگام ساخت
.TP
.B \-S X \[en]source\-registry X
بازنویسی رجیستری منبع سامانه‌های asdf.
.TP
.B \-s SYSTEM \[en]system SYSTEM
بارگذاری SYSTEM مربوط به asdf هنگام ساخت.
.TP
.B \[en]load\-system SYSTEM
مشابه بالا (برای سازگاری با buildapp)
.TP
.B \-p PACKAGE \[en]package PACKAGE
تغییر بستهٔ فعلی به PACKAGE
.TP
.B \-sp SP \[en]system\-package SP
ترکیبی از \-s SP و \-p SP
.TP
.B \-e FORM \[en]eval FORM
ارزیابی FORM هنگام ساخت
.TP
.B \[en]require MODULE
فراخوانی require برای MODULE هنگام ساخت
.TP
.B \-q \[en]quit
خروج از lisp در این نقطه
.TP
.B \-r FUNC \[en]restart FUNC
ایمیج ساخته‌شده پس از فراخوانی FUNC بازراه‌اندازی می‌شود
.TP
.B \-E FUNC \[en]entry FUNC
ایمیج ساخته‌شده پس از فراخوانی (FUNC argv) بازراه‌اندازی می‌شود.
.TP
.B \-i FORM \[en]init FORM
ارزیابی FORM پس از بازراه‌اندازی.
.TP
.B \-ip FORM \[en]print FORM
ارزیابی و چاپ با princ روی FORM پس از بازراه‌اندازی
.TP
.B \-iw FORM \[en]write FORM
ارزیابی و نوشتن (write) عبارت FORM پس از بازراه‌اندازی
.TP
.B \-F FORM \[en]final FORM
ارزیابی FORM پیش از تخلیهٔ IMAGE
.TP
.B \-R \[en]rc
تلاش برای خواندن /etc/rosrc و \[ti]/.roswell/init.lisp
.TP
.B +R \[en]no\-rc
نادیده گرفتن /etc/rosrc و \[ti]/.roswell/init.lisp
.TP
.B \-Q \[en]quicklisp
بارگذاری quicklisp (پیش‌فرض)
.TP
.B +Q \[en]no\-quicklisp
عدم بارگذاری quicklisp
.TP
.B \-v \[en]verbose
نمایش خروجی کامل و پرجزئیات هنگام ساخت
.TP
.B \[en]quiet
قطع نمایش خروجی هنگام ساخت (پیش‌فرض)
.TP
.B \[en]test
برای اهداف آزمایشی
.TP
.B dynamic\-space\-size=[size in MB]
مخصوص SBCL.
این آرگومان از طریق \f[C]\-\-dynamic\-space\-size\f[R] به SBCL ارسال می‌شود
.SH "محیط (ENVIRONMENT)"
.TP
.B ROSWELL_HOME
دایرکتوری خانگی roswell را مشخص می‌کند؛ مقدار پیش‌فرض آن در پلتفرم یونیکس $HOME است.
.SH "گزارش باگ‌ها (BUGS)"
.PP
فهرست مشکلات را بررسی کنید (<https://github.com/roswell/roswell/issues>)
.SH "همچنین ببینید (SEE ALSO)"
.PP
\f[I]sbcl\f[R](1) \f[I]ros\-dump\f[R](1) \f[I]ros\-init\f[R](1)
\f[I]ros\-install\f[R](1) \f[I]ros\-list\f[R](1) \f[I]ros\-setup\f[R](1)
.SH "نویسندگان (AUTHORS)"
تیم پروژهٔ Roswell.