نام (NAME)

pkgctl-version - بررسی و مدیریت نسخه‌های بسته در مقایسه با نسخه بالادست (upstream)

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

pkgctl version [OPTIONS] [SUBCOMMAND]

توضیحات (DESCRIPTION)

دستورات مرتبط با نسخه‌های بسته‌ها، شامل بررسی بسته‌های قدیمی‌شده و نیازمند به‌روزرسانی.

این ابزار از nvchecker(1) و یک فایل .nvchecker.toml واقع در کنار PKGBUILD استفاده می‌کند.

پیکربندی (CONFIGURATION)

فایل .nvchecker.toml باید حاوی بخشی باشد که با pkgbase بسته مطابقت داشته باشد. بخش pkgbase در داخل فایل .nvchecker.toml منبع و روش بررسی جدیدترین نسخه بسته متناظر را مشخص می‌کند.

از pkgctl-version-setup(1) برای تشخیص خودکار و راه‌اندازی یک پیکربندی اولیه nvchecker بر اساس آرایه منبع (source) در فایل PKGBUILD بسته استفاده کنید.

برای اطلاعات دقیق در مورد گزینه‌های مختلف پیکربندی موجود برای فایل .nvchecker.toml، به بخش فایل‌های پیکربندی در nvchecker(1) مراجعه نمایید. این مستندات دید جامعی درباره گزینه‌های ممکن برای سفارشی‌سازی فرآیند بررسی نسخه ارائه می‌دهد.

برای ارائه توکن‌های گیت‌هاب یا گیت‌لب به nvchecker، باید یک فایل keyfile.toml در دایرکتوری $XDG_CONFIG_HOME/nvchecker قرار داده شود. این فایل کلید برای ارائه توکن‌های احراز هویت لازم جهت دسترسی به API گیت‌هاب یا گیت‌لب به کار می‌رود.

منبع ترکیبی (COMBINER SOURCE)

برای استفاده از منبع ترکیبی (combiner source)، بخش pkgbase باید به عنوان منبع ترکیبی تعریف شود. علاوه بر این، بخش‌های اختصاصی باید با استفاده از یک کلید جدول درون کوتیشن شامل pkgbase به همراه نام مرحله (stage) که با دو نقطه جفت از هم جدا شده‌اند، افزوده شوند. برای مثال: ["sudo:stage1"].

این ویژگی امکان زنجیره‌سازی منابع مختلف در یک نتیجه واحد یا اعمال تبدیل چندمرحله‌ای بر منبع از طریق چندین عبارت باقاعده (regex) را فراهم می‌سازد.

گزینه‌ها (OPTIONS)

-h, --help

زیردستورها (SUBCOMMANDS)

pkgctl version check

pkgctl version setup

pkgctl version upgrade

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

pkgctl-version-check(1) pkgctl-version-setup(1) pkgctl-version-upgrade(1)

صفحه خانگی (HOMEPAGE)

https://gitlab.archlinux.org/archlinux/devtools

لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در بخش ردیاب مشکلات (issue tracker) گزارش دهید. لطفاً تمام تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت بازآفرینی باگ‌ها به کار گیرید.