.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "DUNE" 1 "" "Dune 3.24.2" "Dune Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
dune \- سیستم ساخت ترکیب‌پذیر برای OCaml
.SH "خلاصه دستور (SYNOPSIS)"
.sp -1
.P
\fBdune build [\N'45'\N'45'watch]\fR
.sp -1
.P
\fBdune runtest [\N'45'\N'45'watch]\fR
.sp -1
.P
\fBdune exec NAME\fR
.sp -1
.P
\fBdune utop [DIR]\fR
.sp -1
.P
\fBdune install\fR
.sp -1
.P
\fBdune init project NAME [PATH] [\N'45'\N'45'libs=l1,l2 \N'45'\N'45'ppx=p1,p2 \N'45'\N'45'inline\N'45'tests]\fR
.SH "توضیحات (DESCRIPTION)"
.P
ابزار Dune یک سیستم ساخت است که منحصراً برای پروژه‌های OCaml طراحی شده است\N'46' این ابزار بر ارائه یک تجربه کاربری یکپارچه تمرکز دارد و بیشتر جزئیات سطح پایین کامپایل OCaml را مدیریت می‌کند\N'46' تنها کاری که باید انجام دهید ارائه توصیفی از پروژه‌تان است و Dune بقیه کارها را انجام خواهد داد\N'46' 
.P
طرحی که این ابزار پیاده‌سازی می‌کند از ساختار مورداستفاده در Jane Street الهام گرفته شده و با دنیای متن‌باز سازگار گردیده است\N'46' این سیستم در طول زمانی دراز به بلوغ رسیده است و روزانه توسط صدها توسعه‌دهنده استفاده می‌شود، که نشان‌دهنده آزمودگی بالا و کارآمدی آن است\N'46' 
.SH "نام‌های مستعار دستور (COMMAND ALIASES)"
.TP 4
\fBprintenv\fR [\fIOPTION\fR]… [\fIPATH\fR]
نام مستعاری برای \fBenv\fR\N'46'
.TP 4
\fBpromote\fR [\fB\N'45'\N'45'build\N'45'info\fR] [\fB\N'45'\N'45'file\fR] [\fIOPTION\fR]… [\fIFILE\fR]…
نام مستعاری برای \fBpromotion apply\fR\N'46'
.TP 4
\fBtest\fR [\fIOPTION\fR]… [\fITEST\fR]…
نام مستعاری برای \fBruntest\fR\N'46'
.SH "دستورات (COMMANDS)"
.TP 4
\fBbuild\fR [\fIOPTION\fR]… [\fITARGET\fR]…
ساخت اهداف داده‌شده، یا اهداف پیش‌فرض در صورت عدم تعیین هدف\N'46'
.TP 4
\fBcache\fR \fICOMMAND\fR …
مدیریت حافظه پنهان (cache) اشتراکی Dune برای دست‌ساخته‌های ساخت\N'46'
.TP 4
\fBclean\fR [\fIOPTION\fR]… [\fIPATH\fR]…
پاکسازی پروژه\N'46'
.TP 4
\fBdescribe\fR [\fICOMMAND\fR] …
توصیف فضای کاری (workspace)\N'46'
.TP 4
\fBdiagnostics\fR [\fIOPTION\fR]…
واکشی و بازگرداندن خطاها از ساخت جاری\N'46'
.TP 4
\fBexec\fR [\fIOPTION\fR]… \fIPROG\fR [\fIARGS\fR]…
اجرای یک دستور در محیطی مشابه با حالتی که عملیات نصب انجام شده باشد\N'46'
.TP 4
\fBexternal\N'45'lib\N'45'deps\fR [\fIOPTION\fR]… [\fITARGET\fR]…
به dune describe external\N'45'lib\N'45'deps منتقل شده است\N'46'
.TP 4
\fBfmt\fR [\fIOPTION\fR]…
قالب‌بندی کد منبع\N'46'
.TP 4
\fBformat\N'45'dune\N'45'file\fR [\fIOPTION\fR]… [\fIFILE\fR]
قالب‌بندی فایل‌های dune\N'46'
.TP 4
\fBhelp\fR [\fB\N'45'\N'45'build\N'45'info\fR] [\fB\N'45'\N'45'man\N'45'format\fR=\fIFMT\fR] [\fIOPTION\fR]… [\fITOPIC\fR]
راهنمای تکمیلی Dune\N'46'
.TP 4
\fBinit\fR \fICOMMAND\fR …
گروه دستورات برای مقداردهی اولیه مؤلفه‌های Dune\N'46'
.TP 4
\fBinstall\fR [\fIOPTION\fR]… [\fIPACKAGE\fR]…
نصب بسته‌های تعریف‌شده در فضای کاری\N'46'
.TP 4
\fBinstalled\N'45'libraries\fR [\fIOPTION\fR]…
چاپ کتابخانه‌های نصب‌شده روی سیستم\N'46'
.TP 4
\fBinternal\fR \fICOMMAND\fR …

.TP 4
\fBmonitor\fR [\fIOPTION\fR]…
اتصال به یک کارساز Dune RPC و نظارت بر آن\N'46'
.TP 4
\fBocaml\fR \fICOMMAND\fR …
گروه دستورات مرتبط با OCaml\N'46'
.TP 4
\fBocaml\N'45'merlin\fR [\fIOPTION\fR]…
راه‌اندازی یک کارساز پیکربندی merlin\N'46'
.TP 4
\fBpackage\fR \fICOMMAND\fR …
مدیریت بسته آزمایشی
.TP 4
\fBpkg\fR \fICOMMAND\fR …
مدیریت بسته آزمایشی
.TP 4
\fBpromotion\fR \fICOMMAND\fR …
کنترل چگونگی انتشار مجدد تغییرات به کد منبع\N'46'
.TP 4
\fBrocq\fR \fICOMMAND\fR …
گروه دستورات مرتبط با Rocq\N'46'
.TP 4
\fBrpc\fR \fICOMMAND\fR …
سازوکار RPC ابزار Dune\N'46' آزمایشی\N'46'
.TP 4
\fBrules\fR [\fIOPTION\fR]… [\fITARGET\fR]…
تخلیه (dump) قوانین\N'46'
.TP 4
\fBruntest\fR [\fIOPTION\fR]… [\fITEST\fR]…
اجرای آزمون‌ها\N'46'
.TP 4
\fBshow\fR \fICOMMAND\fR …
گروه دستورات برای نمایش اطلاعات درباره فضای کاری
.TP 4
\fBshutdown\fR [\fIOPTION\fR]…
لغو و خاموش کردن فرآیندهای ساخت در فضای کاری جاری\N'46'
.TP 4
\fBsubst\fR [\fB\N'45'\N'45'build\N'45'info\fR] [\fIOPTION\fR]…
جایگزینی نشانه‌ها (watermarks) در فایل‌های منبع\N'46'
.TP 4
\fBtools\fR \fICOMMAND\fR …
گروه دستورات برای ابزارهای بسته‌بندی‌شده\N'46'
.TP 4
\fBtop\fR [\fIOPTION\fR]… [\fIDIR\fR]
چاپ فهرستی از دستورالعمل‌های toplevel برای گنجاندن دایرکتوری‌ها و بارگذاری فایل‌های cma\N'46'
.TP 4
\fBtrace\fR \fICOMMAND\fR …
دستوراتی برای مشاهده رد وقایع (event trace) ابزار dune
.TP 4
\fBuninstall\fR [\fIOPTION\fR]… [\fIPACKAGE\fR]…
حذف بسته‌های تعریف‌شده در فضای کاری\N'46'
.TP 4
\fBupgrade\fR [\fIOPTION\fR]…
ارتقای پروژه‌ها بین نسخه‌های اصلی Dune\N'46'
.TP 4
\fButop\fR [\fIOPTION\fR]… [\fIDIR\fR] [\fIARGS\fR]…
بارگذاری کتابخانه در utop\N'46'
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها بین تمامی دستورات مشترک هستند\N'46'
.TP 4
\fB\N'45'\N'45'help\fR[=\fIFMT\fR] (default=\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'version\fR
نمایش اطلاعات نسخه\N'46'
.SH "راهنمای بیشتر (MORE HELP)"
.P
برای راهنمایی درباره یک دستور مشخص از `\fBdune\fR \fICOMMAND\fR \N'45'\N'45'help\N'39' استفاده کنید\N'46'
.SH "وضعیت خروج (EXIT STATUS)"
.P
\fBdune\fR با این مقادیر خارج می‌شود:
.TP 4
0
در صورت موفقیت\N'46'
.TP 4
1
در صورت بروز خطا\N'46'
.TP 4
130
در صورتی که توسط یک سیگنال متوقف شود\N'46'
.SH "محیط (ENVIRONMENT)"
.P
این متغیرهای محیطی بر اجرای \fBdune\fR تأثیر می‌گذارند:
.TP 4
\fBCLICOLOR\fR
اگر مقداری غیر از \fB0\fR داشته باشد، رنگ‌های ANSI پشتیبانی می‌شوند و زمانی که برنامه به دستور دیگری لوله‌کشی (pipe) نشده باشد، باید استفاده شوند\N'46' اگر برابر با \fB0\fR باشد، کدهای فرار رنگی ANSI در خروجی درج نمی‌شوند
.TP 4
\fBCLICOLOR_FORCE\fR
اگر مقداری غیر از \fB0\fR داشته باشد، رنگ‌های ANSI تحت هر شرایطی باید فعال شوند\N'46'
.TP 4
\fBDUNE_CACHE_ROOT\fR
در صورت تنظیم، مکان تمام حافظه‌های پنهان مختلف مورداستفاده dune را مشخص می‌کند\N'46'
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/dune/issues بررسی کنید
.SH "مثال‌ها (EXAMPLES)"
.TP 4
1\N'46'
مقداردهی اولیه یک پروژه جدید به نام `foo\N'39':
.P
.nf
      dune init project foo
.fi
.TP 4
2\N'46'
ساخت تمام اهداف در درخت منبع جاری:
.P
.nf
      dune build
.fi
.TP 4
3\N'46'
اجرای فایل اجرایی به نام `bar\N'39':
.P
.nf
      dune exec bar
.fi
.TP 4
4\N'46'
اجرای تمام آزمون‌ها در درخت منبع جاری:
.P
.nf
      dune runtest
.fi
.TP 4
5\N'46'
نصب تمام مؤلفه‌های تعریف‌شده در پروژه:
.P
.nf
      dune install
.fi
.TP 4
6\N'46'
حذف تمام دست‌ساخته‌های ساخت:
.P
.nf
      dune clean
.fi