'\" t
.\"     Title: pkgctl-diff
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-21
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "PKGCTL\-DIFF" "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-diff \- مقایسه فایل‌های بسته با استفاده از حالت‌های مختلف
.SH "خلاصه دستور (SYNOPSIS)"
.sp
pkgctl diff [OPTIONS] [MODES] [FILE|PKGNAME.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
بسته ساخته‌شده به‌صورت محلی مربوط به PKGBUILD را جستجو کرده و آخرین نسخه آن بسته
را از مخازن pacman بارگیری می‌کند. سپس با استفاده از حالت‌های مختلف آرشیوهای بسته
را مقایسه می‌کند، در حالی که به‌طور پیش‌فرض از فهرست محتوای ساده tar استفاده می‌کند.
.sp
هنگامی که یک بسته مشخص شود، از آن برای مقایسه با بسته محلی ساخته‌شده استفاده می‌شود.
هنگامی که دو بسته مشخص شوند، هر دو بسته با یکدیگر مقایسه می‌شوند.
.sp
در هر دو حالت، نام بسته به یک نام فایل از حافظه موقت (cache) یا مخزن استخر (pool) تبدیل
می‌شود و \fIpkgctl diff\fP به‌گونه‌ای عمل خواهد کرد که گویی این نام فایل از ابتدا مشخص شده بود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-M, \-\-makepkg\-config\fP
.RS 4
تعیین یک فایل پیکربندی جایگزین برای makepkg
.RE
.sp
\fB\-P, \-\-pool\fP=\fIDIR\fP
.RS 4
جستجوی هدف مقایسه در دایرکتوری pool (پیش‌فرض \f(CR\*(Aq/srv/ftp/pool\*(Aq\fP)
.RE
.sp
\fB\-v, \-\-verbose\fP
.RS 4
ارائه خروجی با جزئیات بیشتر و بدون فیلتر
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش متن راهنما
.RE
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.sp
\fB\-\-color\fP[=\fIWHEN\fP]
.RS 4
خروجی رنگی؛ مقدار \fIWHEN\fP می‌تواند \f(CR\*(Aqnever\*(Aq\fP، \f(CR\*(Aqalways\*(Aq\fP یا \f(CR\*(Aqauto\*(Aq\fP باشد؛ گزینه ساده \fB\-\-color\fP به معنای \fB\-\-color=\fIauto\fP\fP است.
.RE
.sp
\fB\-u, \-U, \-\-unified\fP
.RS 4
خروجی ۳ خط از زمینه یکپارچه (unified context)
.RE
.sp
\fB\-y, \-\-side\-by\-side\fP
.RS 4
خروجی در دو ستون
.RE
.sp
\fB\-W, \-\-width\fP[=\fINUM\fP]
.RS 4
خروجی حداکثر \fINUM\fP ستون چاپی (پیش‌فرض \f(CR\*(Aqauto\*(Aq\fP)؛ مقدار \fINUM\fP می‌تواند \f(CR\*(Aqauto\*(Aq\fP، \f(CR\*(Aqcolumns\*(Aq\fP یا یک عدد باشد.
مقدار \f(CR\*(Aqauto\*(Aq\fP به حداکثر طول خط هر دو فایل تعیین می‌شود که تضمین می‌کند خروجی مقایسه بریده نشود.
.RE
.SH "حالت‌ها (MODES)"
.sp
\fB\-l, \-\-list\fP
.RS 4
فعال‌سازی حالت مقایسه فهرست محتویات tar (پیش‌فرض)
.RE
.sp
\fB\-d, \-\-diffoscope\fP
.RS 4
فعال‌سازی حالت مقایسه diffoscope
.RE
.sp
\fB\-p, \-\-pkginfo\fP
.RS 4
فعال‌سازی حالت مقایسه .PKGINFO
.RE
.sp
\fB\-b, \-\-buildinfo\fP
.RS 4
فعال‌سازی حالت مقایسه .BUILDINFO
.RE
.SH "صفحه خانگی (HOMEPAGE)"
.sp
\fI\c
.URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP"
.sp
لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در سامانه پیگیری اشکالات گزارش دهید. لطفاً نهایت تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید برای باگ‌ها انجام دهید.