.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj\-diff 1  "diff " 
.SH "نام (NAME)"
jj\-diff \- مقایسه محتوای فایل‌ها میان دو بازنگری
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj diff\fR [\fB\-r\fR|\fB\-\-revisions\fR] [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-f\fR|\fB\-\-from\fR] [\fB\-\-ignore\-working\-copy\fR] [\fB\-\-no\-integrate\-operation\fR] [\fB\-t\fR|\fB\-\-to\fR] [\fB\-\-ignore\-immutable\fR] [\fB\-T\fR|\fB\-\-template\fR] [\fB\-\-at\-operation\fR] [\fB\-s\fR|\fB\-\-summary\fR] [\fB\-\-debug\fR] [\fB\-\-stat\fR] [\fB\-\-color\fR] [\fB\-\-types\fR] [\fB\-\-name\-only\fR] [\fB\-\-quiet\fR] [\fB\-\-git\fR] [\fB\-\-no\-pager\fR] [\fB\-\-color\-words\fR] [\fB\-\-config\fR] [\fB\-\-config\-file\fR] [\fB\-\-tool\fR] [\fB\-\-context\fR] [\fB\-w\fR|\fB\-\-ignore\-all\-space\fR] [\fB\-b\fR|\fB\-\-ignore\-space\-change\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIFILESETS\fR] 
.SH "توضیحات (DESCRIPTION)"
مقایسه محتوای فایل‌ها میان دو بازنگری
.PP
با گزینهٔ \fB\-r\fR، تغییرات را در مقایسه با بازنگری والد نشان می‌دهد. اگر چندین بازنگری والد وجود داشته باشد (یعنی بازنگری مورد نظر یک ادغام باشد)، آن‌ها ادغام خواهند شد و تغییرات از نتیجه به بازنگری مشخص‌شده نشان داده می‌شود.
.PP
با گزینه‌های \fB\-\-from\fR و/یا \fB\-\-to\fR، تفاوت از/به بازنگری‌های داده‌شده را نمایش می‌دهد. اگر هر یک مشخص نشود، مقدار پیش‌فرض آن به کامیت رونوشت کاری (working copy) بازمی‌گردد. برای نمونه، \fBjj diff \-\-from main\fR تغییرات را از "main" (شاید نام یک بوک‌مارک) به کامیت رونوشت کاری نشان می‌دهد.
.PP
اگر هیچ گزینه‌ای مشخص نشود، به‌طور پیش‌فرض معادل \fB\-r @\fR خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-r\fR, \fB\-\-revisions\fR \fI<REVSETS>\fR
نمایش تغییرات در این بازنگری‌ها
.sp
اگر چندین بازنگری وجود داشته باشد، کل تفاوت (diff) برای همهٔ آن‌ها نمایش داده خواهد شد. برای مثال، اگر زنجیره‌ای خطی از بازنگری‌های A..D داشته باشید، آن‌گاه \fBjj diff \-r B::D\fR برابر با \fBjj diff \-\-from A \-\-to D\fR خواهد بود. چندین رأس (head) و/یا ریشه پشتیبانی می‌شوند، اما وجود شکاف در مجموعه بازنگری (revset) پشتیبانی نمی‌شود (مانند \fBjj diff \-r \*(AqA|C\*(Aq\fR در یک زنجیرهٔ خطی A..C).
.sp
اگر یک بازنگری یک کامیت ادغام باشد، این گزینه تغییرات را *از* ادغام خودکار محتوای تمام والدین آن *به* محتوای خود بازنگری نمایش می‌دهد.
.sp
اگر هیچ‌کدام از \fB\-r\fR، \fB\-f\fR یا \fB\-t\fR مشخص نشوند، مقدار پیش‌فرض \fB\-r @\fR خواهد بود.
.TP
\fB\-f\fR, \fB\-\-from\fR \fI<REVSET>\fR
نمایش تغییرات از این بازنگری
.sp
اگر هیچ‌کدام از \fB\-r\fR، \fB\-f\fR یا \fB\-t\fR مشخص نشوند، مقدار پیش‌فرض \fB\-r @\fR خواهد بود.
.TP
\fB\-t\fR, \fB\-\-to\fR \fI<REVSET>\fR
نمایش تغییرات به این بازنگری
.sp
اگر هیچ‌کدام از \fB\-r\fR، \fB\-f\fR یا \fB\-t\fR مشخص نشوند، مقدار پیش‌فرض \fB\-r @\fR خواهد بود.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
[\fIFILESETS\fR]
محدود کردن تفاوت به این مسیرها
.SH "گزینه‌های قالب‌بندی تفاوت (DIFF FORMATTING OPTIONS)"
.TP
\fB\-T\fR, \fB\-\-template\fR \fI<TEMPLATE>\fR
رندر کردن هر مدخل تفاوت فایل با استفاده از قالب داده‌شده
.sp
تمام متدهای بدون آرگومان [`TreeDiffEntry` type] به‌عنوان کلمات کلیدی در عبارت قالب در دسترس هستند. برای اطلاعات بیشتر [`jj help \-k templates`] را ببینید.
.sp
[`TreeDiffEntry` type]: https://docs.jj\-vcs.dev/latest/templates/#treediffentry\-type
.sp
[`jj help \-k templates`]: https://docs.jj\-vcs.dev/latest/templates
.TP
\fB\-s\fR, \fB\-\-summary\fR
برای هر مسیر، تنها اصلاح، اضافه یا حذف شدن آن نشان داده شود
.TP
\fB\-\-stat\fR
نمایش هیستوگرام تغییرات
.TP
\fB\-\-types\fR
برای هر مسیر، تنها نوع آن قبل و بعد از تغییر نشان داده شود
.sp
تفاوت به‌صورت دو حرف نمایش داده می‌شود. حرف اول نوع قبلی و حرف دوم نوع بعدی را نشان می‌دهد. \*(Aq\-\*(Aq نشان می‌دهد مسیر وجود نداشته است، \*(AqF\*(Aq نشان‌دهندهٔ یک فایل معمولی، \*(AqL\*(Aq نشان‌دهندهٔ یک پیوند نمادین (symlink)، \*(AqC\*(Aq نشان‌دهندهٔ یک تداخل (conflict)، و \*(AqG\*(Aq نشان‌دهندهٔ یک زیرماژول Git است.
.TP
\fB\-\-name\-only\fR
برای هر مسیر، تنها مسیر آن نشان داده شود
.sp
معمولاً برای دستورات پوسته (shell) کاربرد دارد، مانند: `jj diff \-r @\- \-\-name\-only | xargs perl \-pi \-e\*(Aqs/OLD/NEW/g`
.TP
\fB\-\-git\fR
نمایش تفاوت در قالب Git
.TP
\fB\-\-color\-words\fR
نمایش تفاوت در سطح کلمه که در آن تغییرات تنها با رنگ مشخص می‌شوند
.TP
\fB\-\-tool\fR \fI<TOOL>\fR
تولید تفاوت توسط دستور خارجی
.sp
یک قالب توکار نیز می‌تواند به‌صورت `:<name>` مشخص شود. برای نمونه، `\-\-tool=:git` معادل `\-\-git` است.
.TP
\fB\-\-context\fR \fI<CONTEXT>\fR
تعداد خطوط متنی پیرامون (context) جهت نمایش
.TP
\fB\-w\fR, \fB\-\-ignore\-all\-space\fR
نادیده گرفتن فاصله‌های خالی هنگام مقایسه خطوط
.TP
\fB\-b\fR, \fB\-\-ignore\-space\-change\fR
نادیده گرفتن تغییرات در تعداد فاصله‌های خالی هنگام مقایسه خطوط
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که عملیات روی آن انجام می‌شود.
.sp
به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj در اجداد دایرکتوری کاری فعلی می‌گردد.
.TP
\fB\-\-ignore\-working\-copy\fR
از رونوشت کاری (working copy) اسنپ‌شات گرفته نشود و آن را به‌روزرسانی نکند.
.sp
به‌طور پیش‌فرض، Jujutsu در آغاز هر دستور از رونوشت کاری اسنپ‌شات می‌گیرد. همچنین در صورت تغییر کامیت رونوشت کاری (`@`) توسط دستور، رونوشت کاری در پایان دستور نیز به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از رونوشت کاری جلوگیری کنید و در عوض یک کامیت رونوشت کاری احتمالا قدیمی را ببینید، می‌توانید از
.B \-\-ignore\-working\-copy
استفاده کنید. این گزینه برای مثال در خط فرمان (command prompt) مفید است، به‌ویژه اگر فرآیند دیگری داشته باشید که کامیت‌های رونوشت کاری را ثبت می‌کند.
.sp
بارگذاری مخزن در یک عملیات خاص با
.B \-\-at\-operation
به‌طور ضمنی گزینهٔ
.B \-\-ignore\-working\-copy
را فعال می‌کند.
.TP
\fB\-\-no\-integrate\-operation\fR
دستور طبق معمول اجرا شود اما هیچ عملیاتی ادغام نشود.
.sp
هنگامی که این گزینه مشخص شود، عملیات همچنان مانند قبل ایجاد خواهند شد اما در تاریخچهٔ عملیات (operation log) ادغام نمی‌شوند. همچنین رونوشت کاری نیز به‌روزرسانی نخواهد شد.
.sp
دستور، شناسهٔ عملیات حاصل را چاپ خواهد کرد. می‌توانید آن شناسه را برای مثال به
.B jj \-\-at\-op
ارسال کنید تا وضعیت به‌دست‌آمدهٔ مخزن را بررسی نمایید، یا آن را به
.B jj op restore
بدهید تا مخزن به آن وضعیت بازگردانده شود. همچنین می‌توانید شناسه را به
.B jj op integrate
بدهید تا عملیات ادغام شود.
.sp
توجه داشته باشید که این کار مانع از عوارض جانبی خارج از مخزن *نمی‌شود*. برای نمونه،
.B jj git push \-\-no\-integrate\-operation
همچنان عملیات ارسال (push) را انجام خواهد داد.
.TP
\fB\-\-ignore\-immutable\fR
امکان بازنویسی کامیت‌های تغییرناپذیر (immutable) مجاز باشد.
.sp
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌هایی که در مجموعه کامیت‌های تغییرناپذیر پیکربندی شده‌اند جلوگیری می‌کند. این گزینه آن بررسی را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.
.sp
این گزینه تنها بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری `immutable_heads()` یا کلمه کلیدی قالب `immutable` اثری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود.
.sp
به‌طور پیش‌فرض، Jujutsu مخزن را در تازه‌ترین عملیات، یا در صورت وجود عملیات‌های واگرا، در نقطهٔ ادغام آن‌ها بارگذاری می‌کند.
.sp
می‌توانید از
.BI \-\-at\-op= <operation_ID>
استفاده کنید تا ببینید مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه
.BI "jj \-\-at\-op=" <operation_ID> " st"
آنچه را که
.B jj st
در زمان پایان یافتن آن عملیات نشان می‌داد به شما نمایش می‌دهد. مقدار
.B \-\-at\-op=@
تقریباً همانند حالت پیش‌فرض عمل می‌کند، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.
.sp
از دستور
.B jj op log
برای یافتن شناسه عملیات مورد نظر خود استفاده کنید. هر پیشوند یکتایی از شناسه عملیات کافی خواهد بود.
.sp
هنگام بارگذاری مخزن در یک عملیات پیشین، رونوشت کاری نادیده گرفته می‌شود، درست همان‌طور که گویی گزینهٔ
.B \-\-ignore\-working\-copy
مشخص شده است.
.sp
اجرای دستورات تغییردهنده (mutating) هنگام بارگذاری مخزن در یک عملیات پیشین امکان‌پذیر است. انجام این کار معادل اجرای همزمان دستورات از مبدأ آن عملیات پیشین است. به‌ندرت دلیلی برای انجام چنین کاری وجود دارد، اما ممکن است.
.TP
\fB\-\-debug\fR
فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging)
.TP
\fB\-\-color\fR \fI<WHEN>\fR
تعیین زمان استفاده از رنگ در خروجی
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
debug
.IP \(bu 2
auto
.RE
.TP
\fB\-\-quiet\fR
بی‌صدا کردن خروجی‌های غیر اصلی دستور
.sp
برای نمونه،
.B jj file list
همچنان فایل‌ها را فهرست می‌کند، اما به شما نمی‌گوید که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا نوادگان بازپایه‌ریزی شده‌اند یا خیر.
.sp
هشدارها و خطاها همچنان چاپ خواهند شد.
.TP
\fB\-\-no\-pager\fR
غیرفعال کردن صفحه‌بندی‌کننده (pager)
.TP
\fB\-\-config\fR \fI<NAME=VALUE>\fR
گزینه‌های پیکربندی اضافی (قابلیت تکرار دارد)
.sp
نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین شود. اگر مقدار رشته‌ای درون ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت‌های نقل‌قول صرف‌نظر کرد.
.TP
\fB\-\-config\-file\fR \fI<PATH>\fR
فایل‌های پیکربندی اضافی (قابلیت تکرار دارد)