'\" t
.\"     Title: pkgctl-version
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-VERSION" "1" "2026-06-21" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
pkgctl-version \- بررسی و مدیریت نسخه‌های بسته در مقایسه با نسخه بالادست (upstream)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl version [OPTIONS] [SUBCOMMAND]
.SH "توضیحات (DESCRIPTION)"
.sp
دستورات مرتبط با نسخه‌های بسته‌ها، شامل بررسی بسته‌های قدیمی‌شده و نیازمند به‌روزرسانی.
.sp
این ابزار از
.BR nvchecker (1)
و یک فایل
\f(CR.nvchecker.toml\fP
واقع در کنار
PKGBUILD
استفاده می‌کند.
.SH "پیکربندی (CONFIGURATION)"
.sp
فایل
\f(CR.nvchecker.toml\fP
باید حاوی بخشی باشد که با
pkgbase
بسته مطابقت داشته باشد. بخش pkgbase در داخل فایل
\f(CR.nvchecker.toml\fP
منبع و روش بررسی جدیدترین نسخه بسته متناظر را مشخص می‌کند.
.sp
از
.BR pkgctl\-version\-setup (1)
برای تشخیص خودکار و راه‌اندازی یک پیکربندی اولیه nvchecker بر اساس آرایه منبع (source) در فایل PKGBUILD بسته استفاده کنید.
.sp
برای اطلاعات دقیق در مورد گزینه‌های مختلف پیکربندی موجود برای فایل
\f(CR.nvchecker.toml\fP،
به بخش فایل‌های پیکربندی در
.BR nvchecker (1)
مراجعه نمایید. این مستندات دید جامعی درباره گزینه‌های ممکن برای سفارشی‌سازی فرآیند بررسی نسخه ارائه می‌دهد.
.sp
برای ارائه توکن‌های گیت‌هاب یا گیت‌لب به nvchecker، باید یک فایل
\f(CRkeyfile.toml\fP
در دایرکتوری
\f(CR$XDG_CONFIG_HOME/nvchecker\fP
قرار داده شود. این فایل کلید برای ارائه توکن‌های احراز هویت لازم جهت دسترسی به API گیت‌هاب یا گیت‌لب به کار می‌رود.
.SH "منبع ترکیبی (COMBINER SOURCE)"
.sp
برای استفاده از منبع ترکیبی (combiner source)، بخش
\f(CRpkgbase\fP
باید به عنوان منبع ترکیبی تعریف شود. علاوه بر این، بخش‌های اختصاصی باید با استفاده از یک کلید جدول درون کوتیشن شامل
\f(CRpkgbase\fP
به همراه نام مرحله (stage) که با دو نقطه جفت از هم جدا شده‌اند، افزوده شوند. برای مثال:
\f(CR["sudo:stage1"]\fP.
.sp
این ویژگی امکان زنجیره‌سازی منابع مختلف در یک نتیجه واحد یا اعمال تبدیل چندمرحله‌ای بر منبع از طریق چندین عبارت باقاعده (regex) را فراهم می‌سازد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "زیردستورها (SUBCOMMANDS)"
.sp
pkgctl version check
.RS 4
مقایسه نسخه‌های محلی بسته در برابر نسخه بالادست (upstream)
.RE
.sp
pkgctl version setup
.RS 4
تشخیص خودکار و راه‌اندازی یک پیکربندی پایه برای nvchecker
.RE
.sp
pkgctl version upgrade
.RS 4
تنظیم و به‌روزرسانی PKGBUILD جهت مطابقت با جدیدترین نسخه بالادست
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
pkgctl\-version\-check(1)
pkgctl\-version\-setup(1)
pkgctl\-version\-upgrade(1)
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
.sp
لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در بخش ردیاب مشکلات (issue tracker) گزارش دهید. لطفاً تمام تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت بازآفرینی باگ‌ها به کار گیرید.