'\" t
.\"     Title: pkgctl-version-check
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "PKGCTL\-VERSION\-CHECK" "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-check \- مقایسه نسخه بسته‌های محلی با نسخه بالادستی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl version check [OPTIONS] [PKGBASE.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
نسخه‌های بسته‌ها را در مخزن بسته‌بندی محلی با آخرین نسخه‌های بالادستی (upstream) آن‌ها مقایسه می‌کند.
.sp
پس از اجرا، این دستور فهرستی دسته‌بندی‌شده تولید می‌کند که دیدی جامع از وضعیت هر بسته ارائه می‌دهد. برای هر بسته، نسخه محلی فعلی را در کنار آخرین نسخه موجود در بالادست نمایش می‌دهد.
.sp
خلاصه‌ای از بسته‌های به‌روز، بسته‌های قدیمی و هرگونه خطای بررسی را نمایش می‌دهد.
.sp
این امر نگهداری فایل‌های PKGBUILD را ساده‌تر کرده و زحمت دستی مورد نیاز برای ردیابی تغییرات نسخه از منابع بالادستی را کاهش می‌دهد.
.SH "پیکربندی (CONFIGURATION)"
.sp
از nvchecker(1) و فایل \f(CR.nvchecker.toml\fP واقع در کنار PKGBUILD استفاده می‌کند. به بخش پیکربندی در pkgctl\-version(1) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "گزینه‌های فیلتر (FILTER OPTIONS)"
.sp
\fB\-v, \-\-verbose\fP
.RS 4
نمایش تمام نتایج شامل نسخه‌های به‌روز
.RE
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.sp
\fB\-\-json\fP
.RS 4
فعال‌سازی چاپ در قالب JSON؛ معادل اختصاری برای \f(CR\*(Aq\-\-format json\*(Aq\fP
.RE
.sp
\fB\-F, \-\-format\fP \fIFORMAT\fP
.RS 4
قالب‌بندی نتایج خروجی را کنترل می‌کند؛ \f(CRFORMAT\fP می‌تواند \f(CR\*(Aqpretty\*(Aq\fP
یا \f(CR\*(Aqjson\*(Aq\fP باشد (پیش‌فرض \f(CRpretty\fP)
.RE
.SH "کدهای خروج (EXIT CODES)"
.sp
هنگام خروج، یکی از کدهای زیر بازگردانده می‌شود:
.sp
\fB0\fP
.RS 4
وضعیت خروج عادی، تمام نسخه‌های بررسی‌شده به‌روز هستند
.RE
.sp
\fB1\fP
.RS 4
علت ناشناخته شکست
.RE
.sp
\fB2\fP
.RS 4
وضعیت خروج عادی، اما نسخه‌های قدیمی وجود دارند
.RE
.sp
\fB3\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) ارسال کنید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت رفع باگ‌ها انجام دهید.