.\" Pipe this output to groff -m man -K utf8 -T utf8 | less -R
.\"
.mso an.tmac
.TH "DUNE-SUBST" 1 "" "Dune 3.24.2" "Dune Manual"
.\" Disable hyphenation and ragged-right
.nh
.ad l
.SH "نام (NAME)"
.P
dune\N'45'subst \- جایگزینی واترمارک‌ها در فایل‌های منبع
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdune subst\fR [\fB\N'45'\N'45'build\N'45'info\fR] [\fIOPTION\fR]…
.SH "توضیحات (DESCRIPTION)"
.P
رشته‌های \fB%%ID%%\fR را در فایل‌های منبع، به شیوه‌ای مشابه آنچه topkg در پیکربندی پیش‌فرض انجام می‌دهد، جایگزین می‌کند\N'46'
.P
این دستور فقط زمانی در نظر گرفته شده است که کاربر یک بسته را به نسخهٔ توسعهٔ آن سنجاق (pin) کند\N'46' به‌ویژه، رشته‌های \fB%%VERSION%%\fR را با نسخه‌ای که از vcs به دست آمده جایگزین می‌کند\N'46' در حال حاضر تنها git پشتیبانی می‌شود و نسخه از خروجی دستور زیر حاصل می‌گردد:
.P
.nf
  $ git describe \N'45'\N'45'always \N'45'\N'45'dirty \N'45'\N'45'abbrev=7
.fi
.P
دستور \fBdune subst\fR متغیرهایی را جایگزین می‌کند که topkg در پیکربندی پیش‌فرض جایگزین می‌نماید:
.sp -1
.P
\N'45' \fB%%NAME%%\fR، نام پروژه (از فایل dune\N'45'project)
.sp -1
.P
\N'45' \fB%%VERSION%%\fR، خروجی دستور \fBgit describe \N'45'\N'45'always \N'45'\N'45'dirty \N'45'\N'45'abbrev=7\fR
.sp -1
.P
\N'45' \fB%%VERSION_NUM%%\fR، مشابه با \fB%%VERSION%%\fR اما بدون پیشوند احتمالی \N'39'v\N'39' یا \N'39'V\N'39'
.sp -1
.P
\N'45' \fB%%VCS_COMMIT_ID%%\fR، هش کامیت از vcs
.sp -1
.P
\N'45' \fB%%PKG_MAINTAINER%%\fR، محتویات فیلد \fBmaintainer:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_AUTHORS%%\fR، محتویات فیلد \fBauthors:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_HOMEPAGE%%\fR، محتویات فیلد \fBhomepage:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_ISSUES%%\fR، محتویات فیلد \fBissues:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_DOC%%\fR، محتویات فیلد \fBdoc:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_LICENSE%%\fR، محتویات فیلد \fBlicense:\fR از فایل opam
.sp -1
.P
\N'45' \fB%%PKG_REPO%%\fR، محتویات فیلد \fBrepo:\fR از فایل opam
.P
برای فراخوانی \fBdune subst\fR هنگام سنجاق (pin) شدن بسته، این خط را به فیلد \fBbuild:\fR در فایل opam خود بیفزایید:
.P
.nf
  [dune "subst"] {pinned}
.fi
.P
توجه داشته باشید که این دستور تنها برای فراخوانی از درون فایل‌های opam در نظر گرفته شده است و رفتاری اندکی متفاوت با دیگر دستورهای dune دارد\N'46' به‌ویژه تلاشی برای تشخیص ریشهٔ پروژه نمی‌کند و باید حتماً از ریشهٔ پروژه فراخوانی شود\N'46'
.SH "گزینه‌ها (OPTIONS)"
.TP 4
\fB\N'45'\N'45'build\N'45'info\fR
نمایش اطلاعات ساخت\N'46'
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.P
این گزینه‌ها میان همهٔ دستورها مشترک هستند\N'46'
.TP 4
\fB\N'45'\N'45'debug\N'45'backtraces\fR
چاپ همیشگی ردگیری استثناها (backtraces)\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'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 subst\fR با مقادیر زیر خارج می‌شود:
.TP 4
0
در صورت موفقیت\N'46'
.TP 4
1
در صورت بروز خطا\N'46'
.TP 4
130
اگر با یک سیگنال متوقف شود\N'46'
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ را در https://github\N'46'com/ocaml/dune/issues بررسی کنید
.SH "همچنین ببینید (SEE ALSO)"
.P
dune(1)