نام (NAME)

cmdliner-install-tool-support - نصب کامل‌سازی پوسته و صفحات راهنمای ابزار

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

cmdliner install tool-support [OPTION]… TOOLEXEC[:NAME]… PREFIX

توضیحات (DESCRIPTION)

دستور cmdliner install tool-support دستورهای install tool-completion و install tool-manpages را ترکیب می‌کند تا تمام فایل‌های پشتیبانی ابزار را در یک PREFIX مشخص که فرض می‌شود از Filesystem Hierarchy Standard پیروی می‌کند نصب نماید. در صورتی که چنین نباشد (برای مثال در زمان نگارش این مستند در opam) از گزینه‌های --sharedir و/یا --mandir استفاده کنید. برای مشاهده مسیرهایی که نوشته خواهند شد، از گزینه --dry-run استفاده نمایید. مثال:

cmdliner install tool-support ./mytool /usr/local

cmdliner install tool-support --update-opam-install=mypkg.install \ 
         _build/mytool _build/prefix

آرگومان‌ها (ARGUMENTS)

PREFIX (اجباری): PREFIX پیشوند نصب است. برای مثال /usr/local.
TOOLEXEC[:NAME] (اجباری): TOOLEXEC فایل اجرایی ابزار است. در PATH جستجو می‌شود مگر آنکه مسیر صریح فایل مشخص شده باشد. NAME نام ابزار است؛ در صورت عدم تعیین، از نام پایه (basename) فایل TOOLEXEC با حذف هرگونه پسوند .exe به دست می‌آید. تکرارپذیر.`

گزینه‌ها (OPTIONS)

--dry-run: نصب را انجام ندهید، مسیرهایی که قرار است نوشته شوند را در خروجی نمایش دهید.
--mandir=MANDIR (در صورت عدم تعیین=SHAREDIR/man): MANDIR دایرکتوری ریشه man برای نصب است.
-s SHELL, --shell=SHELL (در صورت عدم تعیین=تمامی پوسته‌های پشتیبانی‌شده): SHELL پوسته‌ای است که باید پشتیبانی شود، باید یکی از مقادیر bash، zsh یا pwsh باشد. تکرارپذیر.
--sharedir=SHAREDIR (در صورت عدم تعیین=PREFIX/share): SHAREDIR دایرکتوری share برای نصب است.
--standalone-completion: تولید اسکریپت‌های کامل‌سازی مستقل. این اسکریپت‌ها به اسکریپت‌های عمومی کامل‌سازی cmdliner وابسته نیستند. برای برخی از پوسته‌ها ممکن است سرعت کامل‌سازی را کاهش دهد.
--update-opam-install=PKG.install: به‌روزرسانی یا ایجاد یک فایل .install مربوط به opam به نام PKG.install با دستورهای انتقال نصب از فایل‌های نصب‌شده به بخش‌های نصب متناظر opam. در صورت مشخص شدن --dry-run نیز اجرا می‌شود.

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

--help[=FMT] (پیش‌فرض=auto): نمایش این راهنما در قالب FMT. مقدار FMT باید یکی از گزینه‌های auto، pager، groff یا plain باشد. با مقدار auto، چنانچه متغیر محیطی TERM برابر با dumb بوده یا تعریف نشده باشد، قالب برابر با pager یا plain خواهد بود.
--version: نمایش اطلاعات نسخه.

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

cmdliner install tool-support با این کدها خارج می‌شود:

0: در صورت موفقیت.
123: در صورت بروز خطاهای نامشخص گزارش‌شده روی خروجی استاندارد خطا (standard error).
124: در صورت بروز خطا در تجزیه خط فرمان.
125: در صورت بروز خطاهای داخلی غیرمنتظره (باگ‌ها).

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

cmdliner(1)