.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "DUNE-DESCRIBE" 1 "" "Dune 3.24.2" "Dune Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
dune\-describe \- توصیف فضای کاری\N'46'
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdune describe\fR [\fICOMMAND\fR] …
.SH "توضیحات (DESCRIPTION)"
.P
آنچه را که در فضای کاری فعلی وجود دارد به شکل خوانا برای انسان یا ماشین توصیف می‌کند\N'46' به طور پیش‌فرض، این دستور توصیفی خوانا برای انسان از فضای کاری فعلی ارائه می‌دهد\N'46' این خروجی برای انسان در نظر گرفته شده و برای پردازش ماشینی مناسب نیست\N'46' به ویژه اینکه دارای نسخه‌بندی نیست\N'46' اگر می‌خواهید خروجی این دستور را در یک برنامه تفسیر کنید، باید از گزینهٔ \fB\N'45'\N'45'format\fR برای تعیین قالب ماشین‌خوان و همچنین گزینهٔ \fB\N'45'\N'45'lang\fR برای دریافت خروجی پایدار استفاده کنید\N'46'
.SH "دستورها (COMMANDS)"
.TP 4
\fBaliases\fR [\fIOPTION\fR]… [\fIDIR\fR]…
چاپ aliasها در یک دایرکتوری مشخص\N'46' مشابه ls عمل می‌کند\N'46'
.TP 4
\fBcontexts\fR [\fIOPTION\fR]…
فهرست کردن contextهای ساخت موجود در فضای کاری\N'46'
.TP 4
\fBdepexts\fR [\fIOPTION\fR]…
چاپ فهرست تمام depextهای موجود
.TP 4
\fBenv\fR [\fIOPTION\fR]… [\fIPATH\fR]
چاپ محیط (متغیرهای محیطی) یک دایرکتوری\N'46'
.TP 4
\fBexternal\N'45'lib\N'45'deps\fR [\fIOPTION\fR]…
چاپ کتابخانه‌های خارجی مورد نیاز برای ساخت پروژه\N'46' این یک مجموعهٔ تقریبی از کتابخانه‌ها است\N'46'
.TP 4
\fBinstalled\N'45'libraries\fR [\fIOPTION\fR]…
چاپ کتابخانه‌های نصب‌شده روی سیستم\N'46'
.TP 4
\fBlocation\fR [\fIOPTION\fR]… \fIPROG\fR
چاپ مسیر فایل اجرایی با استفاده از همان منطق ارزیابی مورد استفاده در [dune exec]\N'46'
.TP 4
\fBopam\N'45'files\fR [\fIOPTION\fR]…
چاپ اطلاعات دربارهٔ فایل‌های opam کشف‌شده\N'46'
.TP 4
\fBpackage\N'45'entries\fR [\fIOPTION\fR]…
چاپ اطلاعات مربوط به ورودی‌ها بر پایهٔ هر بسته\N'46'
.TP 4
\fBpkg\fR \fICOMMAND\fR …
زیردستورهای مربوط به مدیریت بسته
.TP 4
\fBpp\fR [\fIOPTION\fR]… \fIFILE\fR
ساخت FILE مشخص‌شده و چاپ خروجی پیش‌پردازش‌شده\N'46'
.TP 4
\fBrules\fR [\fIOPTION\fR]… [\fITARGET\fR]…
خروجی گرفتن از قوانین (rules)\N'46'
.TP 4
\fBtargets\fR [\fIOPTION\fR]… [\fIDIR\fR]…
چاپ targetها در یک دایرکتوری مشخص\N'46' مشابه ls عمل می‌کند\N'46'
.TP 4
\fBtests\fR [\fIOPTION\fR]…
چاپ آزمون‌های تعریف‌شده در پروژه\N'46' قالب خروجی این دستور آزمایشی است و بدون اطلاع قبلی ممکن است تغییر کند
.TP 4
\fBworkspace\fR [\fIOPTION\fR]… [\fIDIRS\fR]…
چاپ توصیفی از ساختار فضای کاری\N'46' در صورت مشخص شدن دایرکتوری‌های DIRS، فقط آن دایرکتوری‌های فضای کاری در نظر گرفته می‌شوند\N'46'
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
\fIDIRS\fR
توصیفی از ساختار فضای کاری را چاپ می‌کند\N'46' در صورت مشخص شدن دایرکتوری‌های DIRS، فقط آن دایرکتوری‌های فضای کاری در نظر گرفته می‌شوند\N'46'
.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 اما برای خطای استاندارد به جای خروجی استاندارد اعمال می‌شود\N'46' یک مقدار پیش‌فرض مناسب برای مونو\N'45'ریپازیتوری‌های بزرگ \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 است\N'46' این کار تضمین می‌کند که یک ساخت موفقیت‌آمیز، خروجی خالی و «تمیز» داشته باشد\N'46'
.TP 4
\fB\N'45'\N'45'action\N'45'stdout\N'45'on\N'45'success\fR=\fIVAL\fR
نحوهٔ برخورد با خروجی استاندارد اکشن‌ها را در زمان موفقیت آن‌ها مشخص می‌کند\N'46' مقادیر ممکن عبارتند از: \fBprint\fR برای چاپ ساده در خروجی Dune، \fBswallow\fR برای نادیده گرفتن کامل آن و \fBmust\N'45'be\N'45'empty\fR برای الزام به اینکه اکشن هیچ چیزی چاپ نکرده باشد\N'46' با مقدار \fBmust\N'45'be\N'45'empty\fR، اگر اکشن چیزی در خروجی استاندارد خود چاپ کند، Dune آن را ناموفق تلقی خواهد کرد\N'46' پیش‌فرض \fBprint\fR است\N'46'
.TP 4
\fB\N'45'\N'45'build\N'45'info\fR
نمایش اطلاعات ساخت\N'46'
.TP 4
\fB\N'45'\N'45'context\fR=\fICONTEXT\fR (absent=\fBdefault\fR)
بافت ساخت (context) مورد استفاده\N'46'
.TP 4
\fB\N'45'\N'45'display\N'45'separate\N'45'messages\fR
جداسازی پیام‌های خطا با یک خط خالی\N'46'
.TP 4
\fB\N'45'\N'45'error\N'45'reporting\fR=\fIVAL\fR (absent=\fBdeterministic\fR)
زمان گزارش خطاهای ساخت را کنترل می‌کند\N'46' مقدار \fBearly\fR خطاها را به محض کشف شدن گزارش می‌دهد\N'46' مقدار \fBdeterministic\fR خطاها را در پایان فرایند ساخت با ترتیبی معین گزارش می‌کند\N'46' مقدار \fBtwice\fR هر خطا را دو بار گزارش می‌دهد: یک بار به محض کشف خطا و بار دیگر در پایان ساخت، با ترتیبی معین\N'46'
.TP 4
\fB\N'45'f\fR, \fB\N'45'\N'45'force\fR
اجبار اکشن‌های مرتبط با aliasها به اجرای دوباره حتی اگر وابستگی‌های آن‌ها تغییر نکرده باشد\N'46'
.TP 4
\fB\N'45'\N'45'file\N'45'watcher\fR=\fIVAL\fR (absent=\fBautomatic\fR)
سازوکار تشخیص تغییرات در مبدا (source)\N'46' مقدار Automatic باعث می‌شود dune یک برنامهٔ خارجی را برای تشخیص تغییرات اجرا کند\N'46' مقدار Manual برای آگاه‌سازی دستی dune از تغییر فایل‌ها است\N'46'
.TP 4
\fB\N'45'\N'45'format\fR=\fIFORMAT\fR (absent=\fBsexp\fR)
مقدار \fIFORMAT\fR باید \fBsexp\fR یا \fBcsexp\fR باشد
.TP 4
\fB\N'45'\N'45'lang\fR=\fIVERSION\fR (absent=\fB0\N'46'1\fR)
رفتاری مشابه با این نسخه از Dune داشته باشد\N'46'
.TP 4
\fB\N'45'\N'45'no\N'45'recursive\fR
زیردایرکتوری‌ها پیمایش نشوند\N'46' فقط دایرکتوری‌های ارائه‌شده، یا ریشهٔ فضای کاری در صورت عدم تعیین در نظر گرفته می‌شوند\N'46'
.TP 4
\fB\N'45'\N'45'passive\N'45'watch\N'45'mode\fR
مشابه [\N'45'\N'45'watch]، اما فرایند ساخت را فقط زمانی شروع می‌کند که از خارج توسط یک RPC دستور داده شود\N'46'
.TP 4
\fB\N'45'\N'45'sandbox\fR=\fIVAL\fR (absent \fBDUNE_SANDBOX\fR env)
تنظیم حالت محیط ایزوله (sandboxing)\N'46' برخی اکشن‌ها نیازمند حالت سندباکس خاصی هستند، بنابراین این تنظیم را نادیده می‌گیرند\N'46' مقادیر مجاز عبارتند از: none، symlink، copy، hardlink\N'46'
.TP 4
\fB\N'45'\N'45'sanitize\N'45'for\N'45'tests\fR
پاک‌سازی مسیرهای مطلق در آیتم‌های فضای کاری و UIDهای مربوطه، به طوری که خروجی تکرارپذیر (reproducible) باشد\N'46'
.TP 4
\fB\N'45'\N'45'stop\N'45'on\N'45'first\N'45'error\fR
توقف فرایند ساخت به محض مواجهه با اولین خطا\N'46'
.TP 4
\fB\N'45'w\fR, \fB\N'45'\N'45'watch\fR
به جای پایان دادن به فرایند ساخت پس از اتمام، به طور مداوم منتظر تغییرات فایل‌ها می‌ماند\N'46'
.TP 4
\fB\N'45'\N'45'wait\N'45'for\N'45'filesystem\N'45'clock\fR
برنامهٔ Dune خلاصهٔ محتوای (digest) فایل‌ها را برای بهبود کارایی تدریجی (incremental) ذخیره می‌کند\N'46' این خلاصه‌ها خود کش می‌شوند\N'46' در برخی موارد، Dune برای اطمینان‌پذیری نیاز دارد که برخی مدخل‌های کش خلاصه را حذف کند\N'46' این گزینه باعث می‌شود Dune منتظر جلو رفتن ساعت سیستم فایل بماند تا نیازی به حذف چیزی نداشته باشد\N'46' احتمالاً نیازی به این گزینه نخواهید داشت؛ این گزینه بیشتر برای توسعه‌دهندگان Dune کاربرد دارد تا آزمون‌های Dune روی کش خلاصه تکرارپذیرتر شوند\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'deps\fR
آیا وابستگی‌های بین ماژول‌ها چاپ شوند یا خیر\N'46'
.TP 4
\fB\N'45'\N'45'with\N'45'pps\fR
آیا وابستگی‌ها به بازنویس‌های ppx (که در زمان کامپایل فراخوانی می‌شوند) در نظر گرفته شوند یا خیر\N'46'.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 در نظر گرفته می‌شود
.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
همیشه ردگیری بازگشتی (backtrace) استثناها را چاپ می‌کند\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' رفتار پیش‌فرض به وجود یک دایرکتوری قفل بستگی دارد\N'46'
.TP 4
\fB\N'45'\N'45'profile\fR=\fIVAL\fR (در صورت عدم تعیین، متغیر محیطی \fBDUNE_PROFILE\fR)
انتخاب نمایه ساخت، برای مثال \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\N'45'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
خروجی دادن داده‌های ردگیری (trace) در قالب 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'45'ویرگول به‌عنوان جداکننده استفاده کرد\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)
کامپایل متقابل (cross\N'45'compile) با استفاده از این زنجیره ابزار (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 describe\fR با وضعیت‌های زیر خارج می‌شود:
.TP 4
0
در صورت موفقیت\N'46'
.TP 4
1
در صورت بروز خطا\N'46'
.TP 4
130
اگر توسط یک سیگنال متوقف شود\N'46'
.SH "محیط (ENVIRONMENT)"
.P
این متغیرهای محیطی بر اجرای \fBdescribe\fR تأثیر می‌گذارند:
.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
کامپایل متقاطع با استفاده از این زنجیره ابزار (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_INSTRUMENT_WITH\fR
فعال‌سازی ابزاردقیق‌سازی توسط \fBBACKENDS\fR\N'46' متغیر \fBBACKENDS\fR فهرستی از نام‌های کتابخانه‌ها است که با کاما از هم جدا شده‌اند، و هر کدام باید یک backend ابزاردقیق‌سازی را اعلان کرده باشند\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
استفاده از این دایرکتوری به عنوان ریشه فضای کاری (workspace) به‌جای حدس زدن آن\N'46' توجه داشته باشید که این گزینه تفسیر اهداف ارائه‌شده در خط فرمان را تغییر نمی‌دهد\N'46' این متغیر فقط برای اسکریپت‌ها در نظر گرفته شده است\N'46'
.TP 4
\fBDUNE_SANDBOX\fR
حالت ایزوله‌سازی (sandboxing) برای استفاده به‌صورت پیش‌فرض\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)