jj-operation-diff(1) General Commands Manual jj-operation-diff(1) نام (NAME) jj-operation-diff - مقایسهٔ تغییرات اعمال‌شده در مخزن بین دو عملیات خلاصه دستور (SYNOPSIS) jj operation diff [--operation] [-R|--repository] [-f|--from] [--ignore-working-copy] [--no-integrate-operation] [-t|--to] [-G|--no-graph] [--ignore-immutable] [--at-operation] [-p|--patch] [--debug] [-s|--summary] [--color] [--stat] [--quiet] [--types] [--name-only] [--no-pager] [--config] [--git] [--color-words] [--config-file] [--tool] [--context] [--ignore-all-space] [--ignore-space-change] [--show-changes-in] [-h|--help] توضیحات (DESCRIPTION) مقایسهٔ تغییرات اعمال‌شده در مخزن بین دو عملیات گزینه‌ها (OPTIONS) --operation نمایش تغییرات مخزن در این عملیات، در مقایسه با والد آن -f, --from نمایش تغییرات مخزن از مبدأ این عملیات -t, --to نمایش تغییرات مخزن تا مقصد این عملیات -G, --no-graph نمایش فهرستی ساده از تغییرات اصلاح‌شده به‌جای گراف -p, --patch نمایش وصلهٔ (patch) اصلاحات اعمال‌شده در تغییرات اگر نسخهٔ پیشین دارای والدین متفاوتی باشد، به‌طور موقت بر روی والدین نسخهٔ جدید بازپایه‌ریزی (rebase) می‌شود تا تفاوت (diff) با تغییرات نامرتبط آلوده نشود. -h, --help چاپ راهنما (مشاهده خلاصه با '-h') گزینه‌های قالب‌بندی تفاوت (DIFF FORMATTING OPTIONS) -s, --summary برای هر مسیر، تنها اصلاح، اضافه یا حذف شدن آن نشان داده شود --stat نمایش هیستوگرام تغییرات --types برای هر مسیر، تنها نوع آن قبل و بعد از تغییر نشان داده شود تفاوت به‌صورت دو حرف نمایش داده می‌شود. حرف اول نشان‌دهندهٔ نوع قبلی و حرف دوم نشان‌دهندهٔ نوع بعدی است. '-' نشان می‌دهد مسیر وجود نداشته است، 'F' نشان‌دهندهٔ یک فایل معمولی، 'L' نشان‌دهندهٔ یک پیوند نمادین (symlink)، 'C' نشان‌دهندهٔ یک تداخل (conflict)، و 'G' نشان‌دهندهٔ یک زیرماژول Git است. --name-only برای هر مسیر، تنها مسیر آن نشان داده شود معمولاً برای دستورات پوسته (shell) کاربرد دارد، مانند: `jj diff -r @- --name-only | xargs perl -pi -e's/OLD/NEW/g` --git نمایش تفاوت در قالب Git (Git-format diff) --color-words نمایش تفاوت در سطح کلمه که در آن تغییرات تنها با رنگ مشخص می‌شوند --tool تولید تفاوت توسط دستور خارجی یک قالب توکار نیز می‌تواند به‌صورت `:` مشخص شود. برای نمونه، `--tool=:git` معادل `--git` است. --context تعداد خطوط متنی پیرامون (context) جهت نمایش --ignore-all-space نادیده گرفتن فاصله‌های خالی هنگام مقایسهٔ خطوط --ignore-space-change نادیده گرفتن تغییرات در تعداد فاصله‌های خالی هنگام مقایسهٔ خطوط --show-changes-in نمایش تنها بازنگری‌های تغییریافته‌ای که با عبارت revset داده‌شده مطابقت دارند اگر هیچ بازنگری‌ای مشخص نشود، مقدار پیش‌فرض آن تنظیم `revsets.op-diff-changes-in` خواهد بود. گزینه‌های عمومی (GLOBAL OPTIONS) -R, --repository مسیر مخزنی که عملیات روی آن انجام می‌شود به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در اجداد دایرکتوری کاری فعلی می‌گردد. --ignore-working-copy از رونوشت کاری (working copy) اسنپ‌شات گرفته نشود و آن را به‌روزرسانی نکند به‌طور پیش‌فرض، Jujutsu در آغاز هر دستور از رونوشت کاری اسنپ‌شات می‌گیرد. همچنین در صورت تغییر کامیت رونوشت کاری (`@`) توسط دستور، رونوشت کاری در پایان دستور نیز به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از رونوشت کاری جلوگیری کنید و در عوض یک کامیت رونوشت کاری احتمالاً قدیمی را ببینید، می‌توانید از --ignore-working-copy استفاده کنید. این گزینه برای مثال در خط فرمان (command prompt) مفید است، به‌ویژه اگر فرآیند دیگری داشته باشید که کامیت‌های رونوشت کاری را ثبت می‌کند. بارگذاری مخزن در یک عملیات خاص با --at-operation به‌طور ضمنی گزینهٔ --ignore-working-copy را فعال می‌کند. --no-integrate-operation دستور طبق معمول اجرا شود اما هیچ عملیاتی ادغام نشود هنگامی که این گزینه مشخص شود، عملیات همچنان مانند قبل ایجاد خواهند شد اما در تاریخچهٔ عملیات (operation log) ادغام نمی‌شوند. همچنین رونوشت کاری نیز به‌روزرسانی نخواهد شد. دستور، شناسهٔ عملیات حاصل را چاپ خواهد کرد. می‌توانید آن شناسه را برای مثال به jj --at-op ارسال کنید تا وضعیت به‌دست‌آمدهٔ مخزن را بررسی نمایید، یا آن را به jj op restore بدهید تا مخزن به آن وضعیت بازگردانده شود. همچنین می‌توانید شناسه را به jj op integrate بدهید تا عملیات ادغام شود. توجه داشته باشید که این کار مانع از عوارض جانبی خارج از مخزن *نمی‌شود*. برای نمونه، jj git push --no-integrate-operation همچنان عملیات ارسال (push) را انجام خواهد داد. --ignore-immutable امکان بازنویسی کامیت‌های تغییرناپذیر (immutable) مجاز باشد به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌هایی که در مجموعه کامیت‌های تغییرناپذیر پیکربندی شده‌اند جلوگیری می‌کند. این گزینه آن بررسی را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید. این گزینه تنها بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری `immutable_heads()` یا کلمه کلیدی قالب `immutable` اثری ندارد. --at-operation عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود. به‌طور پیش‌فرض، Jujutsu مخزن را در تازه‌ترین عملیات، یا در صورت وجود عملیات‌های واگرا، در نقطهٔ ادغام آن‌ها بارگذاری می‌کند. می‌توانید از --at-op= استفاده کنید تا ببینید مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه jj --at-op= st آنچه را که jj st در زمان پایان یافتن آن عملیات نشان می‌داد به شما نمایش می‌دهد. مقدار --at-op=@ تقریباً همانند حالت پیش‌فرض عمل می‌کند، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد. از دستور jj op log برای یافتن شناسه عملیات مورد نظر خود استفاده کنید. هر پیشوند یکتایی از شناسه عملیات کافی خواهد بود. هنگام بارگذاری مخزن در یک عملیات پیشین، رونوشت کاری نادیده گرفته می‌شود، درست همان‌طور که گویی گزینهٔ --ignore-working-copy مشخص شده است. اجرای دستورات تغییردهنده (mutating) هنگام بارگذاری مخزن در یک عملیات پیشین امکان‌پذیر است. انجام این کار معادل اجرای همزمان دستورات از مبدأ آن عملیات پیشین است. به‌ندرت دلیلی برای انجام چنین کاری وجود دارد، اما ممکن است. --debug فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging) --color تعیین زمان استفاده از رنگ در خروجی مقادیر ممکن: • always • never • debug • auto --quiet بی‌صدا کردن خروجی‌های غیر اصلی دستور برای نمونه، jj file list همچنان فایل‌ها را فهرست می‌کند، اما به شما نمی‌گوید که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا نوادگان بازپایه‌ریزی شده‌اند یا خیر. هشدارها و خطاها همچنان چاپ خواهند شد. --no-pager غیرفعال کردن صفحه‌بندی‌کننده (pager) --config گزینه‌های پیکربندی اضافی (قابلیت تکرار دارد) نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین شود. اگر مقدار رشته‌ای درون ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت‌های نقل‌قول صرف‌نظر کرد. --config-file فایل‌های پیکربندی اضافی (قابلیت تکرار دارد) diff jj-operation-diff(1)