jj-simplify-parents(1) General Commands Manual jj-simplify-parents(1)

jj-simplify-parents - ساده‌سازی یال‌های والد برای بازنگری (یا بازنگری‌های) مشخص‌شده

jj simplify-parents [-R|--repository] [-s|--source] [--ignore-working-copy] [-r|--revision] [--no-integrate-operation] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help]

ساده‌سازی یال‌های والد برای بازنگری (یا بازنگری‌های) مشخص‌شده.

حذف تمام والدینی از هر یک از بازنگری‌های مشخص‌شده که از طریق والدین دیگر نیز نیاکان (اجداد) غیرمستقیم همان بازنگری‌ها هستند. این عمل هیچ تأثیری بر محتوای هیچ بازنگری‌ای، از جمله نسخهٔ کاری (working copy) ندارد.

به عبارت دیگر، برای تمامی (A, B, C) که در آن‌ها A دارای والدین (B, C) بوده و C نیاکانی از B است، A بازنویسی می‌شود تا به‌جای B+C تنها B را به عنوان والد داشته باشد.

ساده‌سازی بازنگری (یا بازنگری‌های) مشخص‌شده همراه با درخت نوادگان آن‌ها (قابل تکرار است)
ساده‌سازی بازنگری (یا بازنگری‌های) مشخص‌شده (قابل تکرار است)

اگر هیچ‌یک از گزینه‌های --source و --revisions ارائه نشوند، این مورد به طور پیش‌فرض از تنظیمات revsets.simplify-parents استفاده می‌کند، یا اگر تنظیم نشده باشد، برابر با reachable(@, mutable()) خواهد بود.

چاپ راهنما (مشاهده خلاصه با '-h')

مسیر مخزنی که عملیات روی آن انجام می‌شود

به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در اجداد دایرکتوری کاری فعلی می‌گردد.

از نسخهٔ کاری اسنپ‌شات گرفته نشود و به‌روزرسانی نگردد

به‌طور پیش‌فرض، Jujutsu در آغاز هر دستور از نسخهٔ کاری اسنپ‌شات می‌گیرد. همچنین در صورت تغییر کامیت نسخهٔ کاری (`@`) توسط دستور، نسخهٔ کاری در پایان دستور نیز به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از نسخهٔ کاری جلوگیری کنید و به جای آن یک کامیت نسخهٔ کاری احتمالاً قدیمی را ببینید، می‌توانید از --ignore-working-copy استفاده کنید. این گزینه برای مثال در خط فرمان، به‌ویژه در صورت داشتن فرایند دیگری که کامیت‌های نسخهٔ کاری را ثبت می‌کند، می‌تواند مفید باشد.

بارگذاری مخزن در یک عملیات خاص با --at-operation به‌طور ضمنی گزینهٔ --ignore-working-copy را فعال می‌کند.

اجرای دستور طبق روال معمول بدون ادغام هیچ‌یک از عملیات‌ها

هنگامی که این گزینه مشخص شود، عملیات‌ها همچنان مثل همیشه ایجاد خواهند شد اما در لاگ عملیات (operation log) ادغام نمی‌شوند. نسخهٔ کاری نیز به‌روزرسانی نخواهد شد.

دستور، شناسهٔ عملیات حاصل را چاپ خواهد کرد. می‌توانید آن شناسه را برای مثال به jj --at-op ارسال کنید تا وضعیت به‌دست‌آمدهٔ مخزن را بررسی نمایید، یا آن را به jj op restore بدهید تا مخزن به آن وضعیت بازگردانده شود. همچنین می‌توانید شناسه را به jj op integrate بدهید تا عملیات ادغام شود.

توجه داشته باشید که این کار مانع از عوارض جانبی خارج از مخزن *نمی‌شود*. برای نمونه، jj git push --no-integrate-operation همچنان عملیات ارسال (push) را انجام خواهد داد.

امکان بازنویسی کامیت‌های تغییرناپذیر (immutable) مجاز باشد

به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌هایی که در مجموعه کامیت‌های تغییرناپذیر پیکربندی شده‌اند جلوگیری می‌کند. این گزینه آن بررسی را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.

این گزینه تنها بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری immutable_heads() یا کلمه کلیدی قالب immutable اثری ندارد.

عملیاتی که مخزن باید در نقطهٔ آن بارگذاری شود

به‌طور پیش‌فرض، Jujutsu مخزن را در تازه‌ترین عملیات، یا در صورت وجود عملیات‌های واگرا، در نقطهٔ ادغام آن‌ها بارگذاری می‌کند.

می‌توانید از --at-op=<operation_ID> استفاده کنید تا ببینید مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه jj --at-op=<operation_ID> st آنچه را که jj st در زمان پایان یافتن آن عملیات نشان می‌داد به شما نمایش می‌دهد. مقدار --at-op=@ تقریباً همانند حالت پیش‌فرض عمل می‌کند، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.

از دستور jj op log برای یافتن شناسه عملیات مورد نظر خود استفاده کنید. هر پیشوند یکتایی از شناسه عملیات کافی خواهد بود.

هنگام بارگذاری مخزن در یک عملیات پیشین، نسخهٔ کاری نادیده گرفته می‌شود، درست همان‌طور که گویی گزینهٔ --ignore-working-copy مشخص شده است.

اجرای دستورات تغییردهنده (mutating) هنگام بارگذاری مخزن در یک عملیات پیشین امکان‌پذیر است. انجام این کار معادل اجرای همزمان دستورات از مبدأ آن عملیات پیشین است. به‌ندرت دلیلی برای انجام چنین کاری وجود دارد، اما ممکن است.

فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging)
تعیین زمان استفاده از رنگ در خروجی

مقادیر ممکن:

  • always
  • never
  • debug
  • auto
بی‌صدا کردن خروجی‌های غیر اصلی دستور

برای نمونه، jj file list همچنان فایل‌ها را فهرست می‌کند، اما به شما نمی‌گوید که آیا از نسخهٔ کاری اسنپ‌شات گرفته شده یا نوادگان بازپایه‌ریزی شده‌اند یا خیر.

هشدارها و خطاها همچنان چاپ خواهند شد.

غیرفعال کردن صفحه‌بندی‌کننده (pager)
گزینه‌های پیکربندی اضافی (قابلیت تکرار دارد)

نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین شود. اگر مقدار رشته‌ای درون ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت‌های نقل‌قول صرف‌نظر کرد.

فایل‌های پیکربندی اضافی (قابلیت تکرار دارد)

jj(1), jj-rebase(1)

simplify-parents