نام (NAME)

dune-subst - جایگزینی واترمارک‌ها در فایل‌های منبع

خلاصه دستور (SYNOPSIS)

dune subst [--build-info] [OPTION]…

توضیحات (DESCRIPTION)

رشته‌های %%ID%% را در فایل‌های منبع، به شیوه‌ای مشابه آنچه topkg در پیکربندی پیش‌فرض انجام می‌دهد، جایگزین می‌کند.

این دستور فقط زمانی در نظر گرفته شده است که کاربر یک بسته را به نسخهٔ توسعهٔ آن سنجاق (pin) کند. به‌ویژه، رشته‌های %%VERSION%% را با نسخه‌ای که از vcs به دست آمده جایگزین می‌کند. در حال حاضر تنها git پشتیبانی می‌شود و نسخه از خروجی دستور زیر حاصل می‌گردد:

$ git describe --always --dirty --abbrev=7

دستور dune subst متغیرهایی را جایگزین می‌کند که topkg در پیکربندی پیش‌فرض جایگزین می‌نماید:

- %%NAME%%، نام پروژه (از فایل dune-project)

- %%VERSION%%، خروجی دستور git describe --always --dirty --abbrev=7

- %%VERSION_NUM%%، مشابه با %%VERSION%% اما بدون پیشوند احتمالی 'v' یا 'V'

- %%VCS_COMMIT_ID%%، هش کامیت از vcs

- %%PKG_MAINTAINER%%، محتویات فیلد maintainer: از فایل opam

- %%PKG_AUTHORS%%، محتویات فیلد authors: از فایل opam

- %%PKG_HOMEPAGE%%، محتویات فیلد homepage: از فایل opam

- %%PKG_ISSUES%%، محتویات فیلد issues: از فایل opam

- %%PKG_DOC%%، محتویات فیلد doc: از فایل opam

- %%PKG_LICENSE%%، محتویات فیلد license: از فایل opam

- %%PKG_REPO%%، محتویات فیلد repo: از فایل opam

برای فراخوانی dune subst هنگام سنجاق (pin) شدن بسته، این خط را به فیلد build: در فایل opam خود بیفزایید:

[dune "subst"] {pinned}

توجه داشته باشید که این دستور تنها برای فراخوانی از درون فایل‌های opam در نظر گرفته شده است و رفتاری اندکی متفاوت با دیگر دستورهای dune دارد. به‌ویژه تلاشی برای تشخیص ریشهٔ پروژه نمی‌کند و باید حتماً از ریشهٔ پروژه فراخوانی شود.

گزینه‌ها (OPTIONS)

--build-info

نمایش اطلاعات ساخت.

گزینه‌های عمومی (COMMON OPTIONS)

این گزینه‌ها میان همهٔ دستورها مشترک هستند.

--debug-backtraces

چاپ همیشگی ردگیری استثناها (backtraces).

--help[=FMT] (پیش‌فرض=auto)

نمایش این راهنما در قالب FMT. مقدار FMT باید یکی از مقادیر auto، pager، groff یا plain باشد. با مقدار auto، هرگاه متغیر محیطی TERM برابر dumb یا تعریف‌نشده باشد، قالب به‌صورت pager یا plain خواهد بود.

--version

نمایش اطلاعات نسخه.

راهنمای بیشتر (MORE HELP)

برای دریافت راهنما در مورد یک دستور خاص، از `dune COMMAND --help' استفاده کنید.

وضعیت خروج (EXIT STATUS)

dune subst با مقادیر زیر خارج می‌شود:

0

در صورت موفقیت.

1

در صورت بروز خطا.

130

اگر با یک سیگنال متوقف شود.

گزارش باگ‌ها (BUGS)

گزارش‌های باگ را در https://github.com/ocaml/dune/issues بررسی کنید

همچنین ببینید (SEE ALSO)

dune(1)