'\" t
.\"     Title: pkgctl-version-upgrade
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-VERSION\-UPGRADE" "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-upgrade \- ارتقای نسخه بسته به آخرین نسخه منتشرشده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl version upgrade [OPTIONS] [PKGBASE.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
فرایند به‌روز نگه‌داشتن فایل‌های PKGBUILD را با آخرین نسخه‌های بالادستی (upstream) ساده و تسهیل می‌کند.
.sp
پس از اجرا، این دستور فایل PKGBUILD را به‌صورت خودکار تنظیم کرده و اطمینان حاصل می‌کند که فیلد \fIpkgver\fP با آخرین نسخه موجود از منبع بالادستی مطابقت داده شود. علاوه بر به‌روزرسانی \fIpkgver\fP، این دستور مقدار \fIpkgrel\fP را نیز به ۱ بازنشانی کرده و جمع‌های کنترلی (checksums) را به‌روز می‌کند.
.sp
خلاصه‌ای از بسته‌های ارتقایافته، بسته‌های به‌روز و هرگونه خطای بررسی (check failures) را نمایش می‌دهد.
.sp
این امر نگهداری فایل‌های PKGBUILD را ساده‌تر کرده و زحمت دستی مورد نیاز برای ردیابی و اعمال تغییرات نسخه از منابع بالادستی را کاهش می‌دهد.
.SH "پیکربندی (CONFIGURATION)"
.sp
از nvchecker(1) و فایل \f(CR.nvchecker.toml\fP واقع در کنار PKGBUILD استفاده می‌کند. به بخش پیکربندی در pkgctl\-version(1) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-no\-update\-checksums\fP
.RS 4
غیرفعال کردن محاسبه و به‌روزرسانی جمع‌های کنترلی (checksums).
.RE
.sp
\fB\-v, \-\-verbose\fP
.RS 4
نمایش نتایج شامل نسخه‌های به‌روز.
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
pkgctl\-version(1),
nvchecker(1)
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fR"
.sp
لطفاً گزارش باگ‌ها و درخواست امکانات جدید را در سامانه پیگیری اشکالات (issue tracker) ارسال کنید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت رفع باگ‌ها انجام دهید.