.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "DUNE-INSTALL" 1 "" "Dune 3.24.2" "Dune Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
dune\-install \- نصب بسته‌های تعریف‌شده در فضای کاری
.SH "خلاصه دستور (SYNOPSIS)"
.P
دایرکتوری‌های نصب استفاده‌شده، بر اساس اولویت مشخص می‌شوند:
.sp -1
.P
\N'45' دایرکتوری‌های تنظیم‌شده در خط فرمان \fIdune install\fR، یا متغیرهای محیطی متناظر
.sp -1
.P
\N'45' دایرکتوری‌های تعیین‌شده در باینری dune؛ این موارد پیش از کامپایل dune با \fI\N'46'/configure\fR تنظیم می‌شوند
.sp -1
.P
\N'45' استخراج‌شده از متغیر محیطی \fIOPAM_SWITCH_PREFIX\fR در صورت وجود
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'action\N'45'stderr\N'45'on\N'45'success\fR=\fIVAL\fR
مشابه \fB\N'45'\N'45'action\N'45'stdout\N'45'on\N'45'success\fR اما برای خطای استاندارد به‌جای خروجی استاندارد. یک پیش‌فرض مناسب برای تک‌مخزن‌های بزرگ (monorepos)، گزینهٔ \fB\N'45'\N'45'action\N'45'stdout\N'45'on\N'45'success=swallow \N'45'\N'45'action\N'45'stderr\N'45'on\N'45'success=must\N'45'be\N'45'empty\fR است. این کار تضمین می‌کند که یک ساخت موفقیت‌آمیز، خروجی خالی و «تمیز» داشته باشد.
.TP 4
\fB\N'45'\N'45'action\N'45'stdout\N'45'on\N'45'success\fR=\fIVAL\fR
تعیین نحوهٔ برخورد با خروجی استاندارد کنش‌ها در صورت موفقیت آن‌ها. مقادیر ممکن عبارتند از: \fBprint\fR برای چاپ صرف آن در خروجی Dune، گزینهٔ \fBswallow\fR برای نادیده گرفتن کامل آن و \fBmust\N'45'be\N'45'empty\fR برای الزام به اینکه کنش نباید چیزی چاپ کرده باشد. با انتخاب \fBmust\N'45'be\N'45'empty\fR، اگر کنش چیزی در خروجی استاندارد خود چاپ کند، Dune آن را ناموفق در نظر خواهد گرفت. پیش‌فرض \fBprint\fR است.
.TP 4
\fB\N'45'\N'45'bindir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌های اجرایی عمومی (binaries). تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'build\N'45'info\fR
نمایش اطلاعات ساخت.
.TP 4
\fB\N'45'\N'45'context\fR=\fICONTEXT\fR
انتخاب بستر (context) برای نصب از آن. به‌طور پیش‌فرض، فایل‌ها از تمام بسترهای تعریف‌شده نصب می‌شوند.
.TP 4
\fB\N'45'\N'45'create\N'45'install\N'45'files\fR
به‌جای نصب مستقیم، فایل‌های نصب را در دایرکتوری ریشه ایجاد می‌کند و در صورت نیاز فایل‌های جایگزین‌شده را در destdir (به‌طور پیش‌فرض _destdir) می‌سازد.
.TP 4
\fB\N'45'\N'45'datadir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌ها از بخش share. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'destdir\fR=\fIPATH\fR (در صورت عدم تعیین، متغیر محیطی \fBDESTDIR\fR)
این دایرکتوری به ابتدای تمام مسیرهای نصب اضافه می‌شود.
.TP 4
\fB\N'45'\N'45'display\N'45'separate\N'45'messages\fR
جداسازی پیام‌های خطا با یک خط خالی.
.TP 4
\fB\N'45'\N'45'docdir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌های مستندات. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'dry\N'45'run\fR
صرفاً نمایش عملیات‌های فایلی که قرار بود انجام شوند.
.TP 4
\fB\N'45'\N'45'error\N'45'reporting\fR=\fIVAL\fR (در صورت عدم تعیین=\fBdeterministic\fR)
زمان گزارش خطاهای ساخت را کنترل می‌کند. مقدار \fBearly\fR خطاها را به محض کشف شدن گزارش می‌دهد. مقدار \fBdeterministic\fR خطاها را در پایان ساخت با ترتیبی قطعی گزارش می‌کند. مقدار \fBtwice\fR هر خطا را دو بار گزارش می‌دهد: یک بار به محض کشف خطا، و بار دیگر در پایان ساخت با ترتیبی قطعی.
.TP 4
\fB\N'45'\N'45'etcdir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌های پیکربندی. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'f\fR, \fB\N'45'\N'45'force\fR
اجبار به اجرای مجدد کنش‌های مرتبط با نام‌های مستعار (aliases)، حتی اگر وابستگی‌های آن‌ها تغییری نکرده باشد.
.TP 4
\fB\N'45'\N'45'file\N'45'watcher\fR=\fIVAL\fR (در صورت عدم تعیین=\fBautomatic\fR)
سازوکار تشخیص تغییرات در مبدأ کد (source). مقدار \fBautomatic\fR برای اجرای یک برنامهٔ خارجی توسط dune جهت تشخیص تغییرات است. مقدار \fBmanual\fR برای اطلاع‌رسانی دستی تغییر فایل‌ها به dune استفاده می‌شود.
.TP 4
\fB\N'45'\N'45'libdir\fR=\fIPATH\fR
دایرکتوری کپی فایل‌های کتابخانه، به‌صورت نسبی نسبت به \fBprefix\fR یا مطلق. اگر \fB\N'45'\N'45'prefix\fR مشخص شده باشد، پیش‌فرض \fI$prefix/lib\fR خواهد بود. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'libexecdir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌های اجرایی کتابخانه‌ای. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'mandir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب صفحات راهنما (man pages). تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'passive\N'45'watch\N'45'mode\fR
مشابه [\N'45'\N'45'watch]، اما ساخت را تنها زمانی آغاز می‌کند که از طریق یک فراخوانی RPC دستور خارجی دریافت کند.
.TP 4
\fB\N'45'\N'45'prefix\fR=\fIPREFIX\fR (در صورت عدم تعیین، متغیر محیطی \fBDUNE_INSTALL_PREFIX\fR)
دایرکتوری کپی فایل‌ها. برای نمونه، فایل‌های اجرایی در \fI$prefix/bin\fR، فایل‌های کتابخانه‌ای در \fI$prefix/lib\fR و غیره کپی می‌شوند.
.TP 4
\fB\N'45'\N'45'relocatable\fR
فایل‌های باینری را جابه‌جایی‌پذیر (relocatable) می‌کند (دایرکتوری نصب قابل انتقال خواهد بود). دایرکتوری نصب باید با \N'45'\N'45'prefix مشخص شود.
.TP 4
\fB\N'45'\N'45'sandbox\fR=\fIVAL\fR (در صورت عدم تعیین، متغیر محیطی \fBDUNE_SANDBOX\fR)
تنظیم حالت ایزوله‌سازی (sandboxing). برخی کنش‌ها نیازمند حالت خاصی از ایزوله‌سازی هستند، بنابراین این تنظیم را نادیده می‌گیرند. مقادیر مجاز عبارتند از: none،‏ symlink،‏ copy،‏ hardlink.
.TP 4
\fB\N'45'\N'45'sbindir\fR=\fIPATH\fR
بازنویسی دستی دایرکتوری برای نصب فایل‌ها از بخش sbin. تنها مسیر مطلق پذیرفته می‌شود.
.TP 4
\fB\N'45'\N'45'sections\fR=\fIVAL\fR
بخش‌هایی که باید نصب شوند.
.TP 4
\fB\N'45'\N'45'stop\N'45'on\N'45'first\N'45'error\fR
متوقف کردن فرآیند ساخت به محض مواجهه با نخستین خطا.
.TP 4
\fB\N'45'w\fR, \fB\N'45'\N'45'watch\fR
به‌جای خاتمه دادن به ساخت پس از اتمام، به‌طور مداوم منتظر تغییرات فایل‌ها می‌ماند.
.TP 4
\fB\N'45'\N'45'wait\N'45'for\N'45'filesystem\N'45'clock\fR
ابزار Dune برای پردازش افزایشی بهتر، محتوای فایل‌ها را خلاصه‌سازی (digest) می‌کند. این خلاصه‌ها خودشان کش می‌شوند. در برخی موارد، Dune برای اطمینان از صحت عملکرد ناچار است برخی از مدخل‌های کش خلاصه را حذف کند. این گزینه باعث می‌شود Dune منتظر پیش رفتن ساعت سیستم فایل بماند تا نیازی به دور ریختن هیچ موردی نداشته باشد. معمولاً نیازی به این گزینه نخواهید داشت؛ این گزینه بیشتر برای توسعه‌دهندگان Dune کاربرد دارد تا آزمون‌های Dune روی کش خلاصه بازتولیدپذیرتر باشند..SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها بین تمامی دستورها مشترک هستند\N'46'
.TP 4
\fB\N'45'\N'45'always\N'45'show\N'45'command\N'45'line\fR
همیشه خط فرمان کامل برنامه‌های اجراشده توسط dune را نمایش می‌دهد\N'46'
.TP 4
\fB\N'45'\N'45'auto\N'45'promote\fR
ارتقای خودکار فایل‌ها\N'46' این کار مشابه اجرای \fBdune promote\fR پس از ساخت است\N'46'
.TP 4
\fB\N'45'\N'45'build\N'45'dir\fR=\fIFILE\fR (در غیاب متغیر محیطی \fBDUNE_BUILD_DIR\fR)
دایرکتوری ساخت مشخص‌شده\N'46' در صورت مشخص نشدن، پیش‌فرض _build است\N'46'
.TP 4
\fB\N'45'\N'45'cache\fR=\fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_CACHE\fR)
فعال یا غیرفعال کردن کَش Dune (یکی از مقادیر \fBdisabled\fR، \fBenabled\N'45'except\N'45'user\N'45'rules\fR یا \fBenabled\fR)\N'46' مقدار پیش‌فرض `enabled\N'45'except\N'45'user\N'45'rules\N'39' است\N'46'
.TP 4
\fB\N'45'\N'45'cache\N'45'check\N'45'probability\fR=\fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_CACHE_CHECK_PROBABILITY\fR)
بررسی بازتولیدپذیری ساخت با اجرای دوباره قواعد انتخاب‌شده به‌صورت تصادفی و مقایسه نتایج آن‌ها با موارد ذخیره‌شده در کَش Dune\N'46' نکته: افزایش احتمال این بررسی‌ها سرعت ساخت را کاهش می‌دهد\N'46' احتمال پیش‌فرض صفر است، یعنی هیچ قاعده‌ای بررسی نمی‌شود\N'46'
.TP 4
\fB\N'45'\N'45'cache\N'45'storage\N'45'mode\fR=\fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_CACHE_STORAGE_MODE\fR)
حالت ذخیره‌سازی کَش Dune (یکی از مقادیر \fBauto\fR، \fBhardlink\fR یا \fBcopy\fR)\N'46' مقدار پیش‌فرض `hardlink\N'39' است\N'46'
.TP 4
\fB\N'45'\N'45'config\N'45'file\fR=\fIFILE\fR
بارگذاری این فایل پیکربندی به جای فایل پیش‌فرض\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'backtraces\fR
همیشه ردپای پشته استثناها (backtraces) چاپ شود\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'dependency\N'45'path\fR
در صورت بروز خطا، چاپ مسیر وابستگی از هدف‌های خط فرمان تا قاعده‌ای که شکست خورده است\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'package\N'45'logs\fR (در غیاب متغیر محیطی \fBDUNE_DEBUG_PACKAGE_LOGS\fR)
همیشه لاگ‌های استاندارد هنگام ساخت بسته‌ها چاپ شوند
.TP 4
\fB\N'45'\N'45'default\N'45'target\fR=\fITARGET\fR (در صورت عدم تعیین=\fB@@default\fR)
تنظیم هدف پیش‌فرضی که در صورت مشخص نشدن هیچ هدفی در \fBdune build\fR استفاده می‌شود\N'46'
.TP 4
\fB\N'45'\N'45'diff\N'45'command\fR=\fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_DIFF_COMMAND\fR)
دستور شل مورد استفاده برای مقایسه فایل‌ها (diff)\N'46' از \N'45' برای غیرفعال کردن چاپ تفاوت‌ها استفاده کنید\N'46'
.TP 4
\fB\N'45'\N'45'disable\N'45'promotion\fR (در غیاب متغیر محیطی \fBDUNE_DISABLE_PROMOTION\fR)
غیرفعال کردن تمام قواعد ارتقا (promotion)
.TP 4
\fB\N'45'\N'45'display\fR=\fIMODE\fR
کنترل حالت نمایش Dune\N'46' برای جزئیات بیشتر \fBdune\N'45'config(5)\fR را ببینید\N'46' مقادیر معتبر برای این گزینه عبارتند از: progress، verbose، short، quiet یا tui\N'46'
.TP 4
\fB\N'45'\N'45'dump\N'45'gc\N'45'stats\fR=\fIFILE\fR
ذخیره آمار زباله‌روب (garbage collector) در یک فایل پس از اتمام ساخت\N'46'
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (پیش‌فرض=\fBauto\fR)
نمایش این راهنما در قالب \fIFMT\fR\N'46' مقدار \fIFMT\fR باید یکی از مقادیر \fBauto\fR، \fBpager\fR، \fBgroff\fR یا \fBplain\fR باشد\N'46' با مقدار \fBauto\fR، هر زمان که متغیر محیطی \fBTERM\fR برابر \fBdumb\fR یا تعریف‌نشده باشد، قالب برابر \fBpager\fR یا \fBplain\fR خواهد بود\N'46'
.TP 4
\fB\N'45'\N'45'ignore\N'45'promoted\N'45'rules\fR
نادیده گرفتن قواعد دارای (mode promote)، به‌جز مواردی که شامل (only \N'46'\N'46'\N'46') هستند\N'46' متغیر %{ignoring_promoted_rules} در فایل‌های dune نشان‌دهنده داده شدن یا نشدن این گزینه است\N'46'
.TP 4
\fB\N'45'\N'45'instrument\N'45'with\fR=\fIBACKENDS\fR (در غیاب متغیر محیطی \fBDUNE_INSTRUMENT_WITH\fR)
فعال‌سازی ابزاردقیق‌سازی (instrumentation) توسط \fBBACKENDS\fR\N'46' مقدار \fBBACKENDS\fR فهرستی از نام‌های کتابخانه‌ها است که با کاما از هم جدا شده‌اند، و هر کدام باید یک پس‌بند ابزاردقیق‌سازی را اعلان کرده باشند\N'46'
.TP 4
\fB\N'45'j\fR \fIJOBS\fR (در غیاب متغیر محیطی \fBDUNE_JOBS\fR)
اجرای هم‌زمان حداکثر \fIJOBS\fR دستور\N'46' مقدار \fIJOBS\fR باید یک عدد صحیح مثبت یا \fBauto\fR برای تشخیص خودکار تعداد هسته‌ها (پیش‌فرض) باشد\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'buffer\fR
خروجی دستورهای اجراشده توسط dune بافر نشود\N'46' به‌طور پیش‌فرض، dune خروجی زیردستورها را بافر می‌کند تا در صورت اجرای موازی چند دستور، از درهم‌آمیختگی آن‌ها جلوگیری شود\N'46' با این حال، این امر هنگام اشکال‌زدایی آزمون‌های طولانی می‌تواند مشکل‌ساز باشد\N'46' با گزینه \fB\N'45'\N'45'no\N'45'buffer\fR، دستورها دسترسی مستقیم به ترمینال خواهند داشت\N'46' توجه داشته باشید که در نتیجه، خروجی آن‌ها در فایل لاگ ثبت نخواهد شد\N'46' بهتر است این گزینه را به همراه \fB\N'45'j 1\fR به کار ببرید تا از تداخل خروجی‌ها جلوگیری شود\N'46' علاوه بر این، باید از \fB\N'45'\N'45'verbose\fR نیز استفاده کنید تا مطمئن شوید دستورها پیش از اجرا چاپ می‌شوند\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'config\fR
بارگذاری نکردن فایل پیکربندی
.TP 4
\fB\N'45'\N'45'no\N'45'print\N'45'directory\fR
نادیده گرفتن و جلوگیری از چاپ پیام‌های "Entering directory"\N'46'
.TP 4
\fB\N'45'\N'45'only\N'45'packages\fR=\fIPACKAGES\fR
نادیده گرفتن بندهایی (stanzas) که به بسته‌ای خارج از \fBPACKAGES\fR ارجاع می‌دهند\N'46' مقدار \fBPACKAGES\fR فهرستی از نام بسته‌هاست که با کاما از هم جدا شده‌اند\N'46' توجه داشته باشید که این کار تاثیری مشابه با حذف بندهای مربوطه از فایل‌های dune دارد\N'46' این گزینه بیشتر برای انتشار نسخه‌ها در نظر گرفته شده است\N'46' در طول توسعه، معمولاً آنچه نیاز دارید ساخت یک هدف خاص مانند \fB<package>\N'46'install\fR است\N'46'`
.TP 4
\fB\N'45'p\fR \fIPACKAGES\fR, \fB\N'45'\N'45'for\N'45'release\N'45'of\N'45'packages\fR=\fIPACKAGES\fR (الزامی)
کوتاه‌نوشتی برای \fB\N'45'\N'45'release \N'45'\N'45'pkg=disabled \N'45'\N'45'only\N'45'packages PACKAGE\fR\N'46' باید از این گزینه در فایل‌های \fI<package>\N'46'opam\fR خود استفاده کنید تا در پروژه‌هایی با چندین بسته، تنها موارد لازم ساخته شوند و ساخت‌های بازتولیدپذیر تضمین گردند\N'46'
.TP 4
\fB\N'45'\N'45'pkg\fR=\fIVAL\fR
فعال یا غیرفعال کردن مدیریت بسته\N'46' رفتار پیش‌فرض به وجود یا عدم وجود دایرکتوری lock بستگی دارد\N'46'
.TP 4
\fB\N'45'\N'45'profile\fR=\fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_PROFILE\fR)
انتخاب نمایه (profile) ساخت؛ برای مثال \fBdev\fR یا \fBrelease\fR\N'46' مقدار پیش‌فرض \fBdev\fR است\N'46'
.TP 4
\fB\N'45'\N'45'promote\N'45'install\N'45'files\fR[=\fIVAL\fR] (پیش‌فرض=\fBtrue\fR)
ارتقای تمام فایل‌های تولیدشده <package>\N'46'install به درخت منبع پروژه\N'46'
.TP 4
\fB\N'45'\N'45'release\fR
قرار دادن \fBdune\fR در حالت بازتولیدپذیر \fIrelease\fR\N'46' کوتاه‌نوشتی برای \fB\N'45'\N'45'root \N'46' \N'45'\N'45'ignore\N'45'promoted\N'45'rules \N'45'\N'45'no\N'45'config \N'45'\N'45'profile release \N'45'\N'45'always\N'45'show\N'45'command\N'45'line \N'45'\N'45'promote\N'45'install\N'45'files \N'45'\N'45'require\N'45'dune\N'45'project\N'45'file \N'45'\N'45'default\N'45'target @install\fR\N'46' باید از این گزینه برای ساخت‌های انتشار استفاده کنید\N'46' به عنوان مثال، استفاده از این گزینه در فایل‌های \fI<package>\N'46'opam\fR الزامی است؛ مگر اینکه قبلاً از \fB\N'45'p\fR استفاده کرده باشید، چرا که \fB\N'45'p\fR خود متضمن این گزینه است\N'46'
.TP 4
\fB\N'45'\N'45'require\N'45'dune\N'45'project\N'45'file\fR[=\fIVAL\fR] (پیش‌فرض=\fBtrue\fR)
در صورت وجود نداشتن فایل dune\N'45'project، با خطا متوقف شود\N'46'
.TP 4
\fB\N'45'\N'45'root\fR=\fIDIR\fR (در غیاب متغیر محیطی \fBDUNE_ROOT\fR)
استفاده از این دایرکتوری به عنوان ریشه فضای کاری به جای حدس زدن آن\N'46' توجه داشته باشید که این گزینه تفسیری که از هدف‌های مشخص‌شده در خط فرمان می‌شود را تغییر نمی‌دهد\N'46' این گزینه فقط برای اسکریپت‌ها در نظر گرفته شده است\N'46'
.TP 4
\fB\N'45'\N'45'store\N'45'orig\N'45'source\N'45'dir\fR (در غیاب متغیر محیطی \fBDUNE_STORE_ORIG_SOURCE_DIR\fR)
ذخیره مکان اصلی منبع در فراداده‌های dune\N'45'package\N'46'
.TP 4
\fB\N'45'\N'45'target\N'45'exec\fR=\fITOOLCHAIN=CMD\fR (در غیاب متغیر محیطی \fBDUNE_TARGET_EXEC\fR)
دستور پوشش‌دهنده (wrapper) برای اجرای باینری‌های هدف هنگام کامپایل متقابل (cross-compiling)\N'46' قالب: TOOLCHAIN=CMD (به عنوان مثال، \N'39'windows=wine\N'39')\N'46'
.TP 4
\fB\N'45'\N'45'terminal\N'45'persistence\fR=\fIMODE\fR
تغییر نحوه نمایش لاگ نتایج ساخت در کنسول بین ساخت‌های مجدد در حالت \fB\N'45'\N'45'watch\fR\N'46' حالت‌های پشتیبانی‌شده: \fBpreserve\fR، \fBclear\N'45'on\N'45'rebuild\fR، \fBclear\N'45'on\N'45'rebuild\N'45'and\N'45'flush\N'45'history\fR\N'46'
.TP 4
\fB\N'45'\N'45'trace\N'45'file\fR=\fIFILE\fR
خروجی دادن داده‌های ردیابی در قالب catapult (سازگار با chrome://tracing)\N'46'
.TP 4
\fB\N'45'\N'45'verbose\fR
یکسان با \fB\N'45'\N'45'display verbose\fR
.TP 4
\fB\N'45'\N'45'version\fR
نمایش اطلاعات نسخه\N'46'
.TP 4
\fB\N'45'\N'45'watch\N'45'exclusions\fR=\fIREGEX\fR
افزودن یک عبارت باقاعده POSIX که دایرکتوری‌های منطبق را از \fB`dune build \N'45'\N'45'watch`\fR مستثنی می‌کند\N'46' گزینه \fB\N'45'\N'45'watch\N'45'exclusions\fR برای افزودن چندین استثنا می‌تواند تکرار شود\N'46' همچنین می‌توان از نقطه‌ویرگول به عنوان جداکننده استفاده کرد\N'46' اگر هیچ استثنایی مشخص نشود، از یک مجموعه استاندارد از استثناها استفاده می‌شود؛ اما اگر از \fIیک یا چند\fR \fB\N'45'\N'45'watch\N'45'exclusions\fR استفاده شود، \fBهیچ‌یک\fR از استثناهای استاندارد اعمال نخواهند شد\N'46' استثناهای استاندارد عبارتند از: ^_opam /_opam ^_esy /_esy ^\N'92'\N'46'#\N'46'* /\N'92'\N'46'#\N'46'* ~$ ^#[^#]*#$ /#[^#]*#$ ^4913$ /4913$ /\N'46'git /\N'46'hg :/windows
.TP 4
\fB\N'45'\N'45'workspace\fR=\fIFILE\fR (در غیاب متغیر محیطی \fBDUNE_WORKSPACE\fR)
استفاده از این فایل مشخص فضای کاری به جای جستجوی آن\N'46'
.TP 4
\fB\N'45'x\fR \fIVAL\fR (در غیاب متغیر محیطی \fBDUNE_CROSS_TARGET\fR)
کامپایل متقابل با استفاده از این زنجیره ابزار (toolchain)\N'46'.SH "راهنمای بیشتر (MORE HELP)"
.P
برای دریافت راهنما درباره یک دستور مشخص، از `\fBdune\fR \fICOMMAND\fR \N'45'\N'45'help\N'39' استفاده کنید\N'46'
.SH "وضعیت خروج (EXIT STATUS)"
.P
\fBdune install\fR با این مقادیر خارج می‌شود:
.TP 4
0
در صورت موفقیت\N'46'
.TP 4
1
در صورت بروز خطا\N'46'
.TP 4
130
اگر توسط یک سیگنال متوقف شده باشد\N'46'
.SH "محیط (ENVIRONMENT)"
.P
این متغیرهای محیطی بر اجرای \fBinstall\fR تأثیر می‌گذارند:
.TP 4
\fBDESTDIR\fR
گزینهٔ \fB\N'45'\N'45'destdir\fR را ببینید\N'46'
.TP 4
\fBDUNE_BUILD_DIR\fR
دایرکتوری ساخت مشخص‌شده\N'46' در صورت مشخص نشدن، _build در نظر گرفته می‌شود\N'46'
.TP 4
\fBDUNE_CACHE\fR
فعال یا غیرفعال کردن حافظه پنهان Dune (یکی از مقادیر \fBdisabled\fR، \fBenabled\N'45'except\N'45'user\N'45'rules\fR یا \fBenabled\fR)\N'46' مقدار پیش‌فرض `enabled\N'45'except\N'45'user\N'45'rules\N'39' است\N'46'
.TP 4
\fBDUNE_CACHE_CHECK_PROBABILITY\fR
بررسی بازتولیدپذیری ساخت با اجرای دوبارهٔ قواعد تصادفی انتخاب‌شده و مقایسه نتایج آن‌ها با موارد ذخیره‌شده در حافظه پنهان Dune\N'46' نکته: افزایش احتمال چنین بررسی‌هایی روند ساخت را کندتر می‌کند\N'46' احتمال پیش‌فرض صفر است، یعنی هیچ قاعده‌ای بررسی نمی‌شود\N'46'
.TP 4
\fBDUNE_CACHE_STORAGE_MODE\fR
حالت ذخیره‌سازی حافظه پنهان Dune (یکی از موارد \fBauto\fR، \fBhardlink\fR یا \fBcopy\fR)\N'46' مقدار پیش‌فرض `hardlink\N'39' است\N'46'
.TP 4
\fBDUNE_CROSS_TARGET\fR
کامپایل متقابل (Cross-compile) با استفاده از این زنجیره ابزار (toolchain)\N'46'
.TP 4
\fBDUNE_DEBUG_PACKAGE_LOGS\fR
چاپ همیشگی گزارش‌های استاندارد هنگام ساخت بسته‌ها\N'46'
.TP 4
\fBDUNE_DIFF_COMMAND\fR
دستور شل برای مقایسه تفاوت (diff) فایل‌ها\N'46' از \N'45' برای غیرفعال کردن چاپ تفاوت‌ها استفاده کنید\N'46'
.TP 4
\fBDUNE_DISABLE_PROMOTION\fR
غیرفعال کردن تمام قوانین ارتقا (promotion rules)\N'46'
.TP 4
\fBDUNE_INSTALL_PREFIX\fR
گزینهٔ \fB\N'45'\N'45'prefix\fR را ببینید\N'46'
.TP 4
\fBDUNE_INSTRUMENT_WITH\fR
فعال‌سازی سازوکار سنجش کد (instrumentation) توسط \fBBACKENDS\fR\N'46' مقدار \fBBACKENDS\fR فهرستی از نام‌های کتابخانه است که با کاما از یکدیگر جدا شده‌اند و هرکدام باید یک بک‌اند سنجش را تعریف کنند\N'46'
.TP 4
\fBDUNE_JOBS\fR
اجرای حداکثر \fIJOBS\fR دستور به‌صورت هم‌زمان\N'46' مقدار \fIJOBS\fR باید یک عدد صحیح مثبت یا \fBauto\fR برای تشخیص خودکار تعداد هسته‌ها (پیش‌فرض) باشد\N'46'
.TP 4
\fBDUNE_PROFILE\fR
پروفایل ساخت\N'46' در صورت عدم تعیین \fBdev\fR، یا در صورت تنظیم \N'45'p مقدار \fBrelease\fR خواهد بود\N'46'
.TP 4
\fBDUNE_ROOT\fR
استفاده از این دایرکتوری به‌عنوان ریشه فضای کاری به‌جای حدس زدن آن\N'46' توجه داشته باشید که این گزینه تفسیر اهداف ارائه‌شده در خط فرمان را تغییر نمی‌دهد\N'46' این متغیر فقط برای اسکریپت‌ها در نظر گرفته شده است\N'46'
.TP 4
\fBDUNE_SANDBOX\fR
حالت سندباکس برای استفاده به‌صورت پیش‌فرض\N'46' (\N'45'\N'45'sandbox را ببینید)
.TP 4
\fBDUNE_STORE_ORIG_SOURCE_DIR\fR
ذخیره مکان اصلی مبدأ در متادیتای dune\N'45'package\N'46'
.TP 4
\fBDUNE_TARGET_EXEC\fR
دستور پوشش‌دهنده (wrapper) برای اجرای باینری‌های مقصد هنگام کامپایل متقابل\N'46' قالب: TOOLCHAIN=CMD (مثلاً \N'39'windows=wine\N'39')\N'46'
.TP 4
\fBDUNE_WORKSPACE\fR
استفاده از این فایل فضای کاری مشخص به‌جای جستجوی آن\N'46'
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/dune/issues بررسی کنید\N'46'
.SH "همچنین ببینید (SEE ALSO)"
.P
dune(1)