نام (NAME)

jj - سامانه کنترل نسخه Jujutsu (یک سامانه کنترل نسخه آزمایشی)

خلاصه دستور (SYNOPSIS)

jj [-R|--repository] [--ignore-working-copy] [--no-integrate-operation] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help] [-V|--version] [subcommands]

توضیحات (DESCRIPTION)

Jujutsu (یک سامانه کنترل نسخه آزمایشی)

برای شروع، خودآموز [`jj help -k tutorial`] را ببینید.

[`jj help -k tutorial`]: https://docs.jj-vcs.dev/latest/tutorial

گزینه‌ها (OPTIONS)

-h, --help: چاپ راهنما (مشاهده خلاصه با '-h')
-V, --version: چاپ نسخه

گزینه‌های عمومی (GLOBAL OPTIONS)

-R, --repository <REPOSITORY>

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

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

--ignore-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

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

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

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

--at-operation <AT_OPERATION>

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

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

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

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

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

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

--debug

فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging)

--color <WHEN>

تعیین زمان استفاده از رنگ در خروجی

مقادیر ممکن:

always
never
debug
auto

--quiet

بی‌صدا کردن خروجی‌های غیر اصلی دستور

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

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

--no-pager

غیرفعال کردن صفحه‌بندی‌کننده (pager)

--config <NAME=VALUE>

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

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

--config-file <PATH>

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

زیردستورها (SUBCOMMANDS)

jj-abandon(1): رها کردن یک بازنگری
jj-absorb(1): انتقال تغییرات از یک بازنگری به پشتهٔ بازنگری‌های تغییرپذیر
jj-arrange(1): مرتب‌سازی تعاملی گراف کامیت‌ها
jj-bisect(1): یافتن یک بازنگری معیوب با روش دوبخشی (تنصیف)
jj-bookmark(1): مدیریت نشانک‌ها (بوک‌مارک‌ها) [نام مستعار پیش‌فرض: b]
jj-commit(1): به‌روزرسانی توضیحات و ایجاد یک تغییر جدید در بالا [نام مستعار پیش‌فرض: ci]
jj-config(1): مدیریت گزینه‌های پیکربندی
jj-converge(1): همگرا کردن تغییرات واگرا
jj-describe(1): به‌روزرسانی توضیحات تغییر یا سایر فراداده‌ها [نام مستعار پیش‌فرض: desc]
jj-diff(1): مقایسهٔ محتوای فایل‌ها میان دو بازنگری
jj-diffedit(1): اصلاح تغییرات محتوا در یک بازنگری با ویرایشگر تفاوت
jj-duplicate(1): ایجاد تغییرات جدید با محتوایی یکسان با تغییرات موجود
jj-edit(1): تنظیم بازنگری مشخص‌شده به‌عنوان بازنگری رونوشت کاری
jj-evolog(1): نمایش چگونگی تکامل یک تغییر در طول زمان
jj-file(1): عملیات‌های مربوط به فایل
jj-fix(1): به‌روزرسانی فایل‌ها با اصلاحات قالب‌بندی یا سایر تغییرات
jj-gerrit(1): تعامل با سامانه بررسی کد Gerrit
jj-git(1): دستورهایی برای کار با مخازن راه دور Git و مخزن زیربنایی Git
jj-help(1): چاپ این پیام یا راهنمای زیردستور(های) ارائه‌شده
jj-interdiff(1): نمایش تفاوت‌های میان diffهای دو بازنگری
jj-log(1): نمایش تاریخچهٔ بازنگری‌ها
jj-metaedit(1): ویرایش فرادادهٔ یک بازنگری بدون تغییر در محتوای آن
jj-new(1): ایجاد یک تغییر جدید و خالی و ویرایش آن در رونوشت کاری (به‌طور پیش‌فرض)
jj-next(1): انتقال کامیت رونوشت کاری به بازنگری فرزند
jj-operation(1): دستورهایی برای کار با تاریخچهٔ عملیات
jj-parallelize(1): موازی‌سازی بازنگری‌ها با تبدیل آن‌ها به هم‌نیای یکدیگر
jj-prev(1): تغییر بازنگری رونوشت کاری نسبت به بازنگری والد
jj-rebase(1): انتقال بازنگری‌ها به والد(های) متفاوت
jj-redo(1): انجام مجدد آخرین عملیات لغوشده
jj-resolve(1): حل ناسازگاری پرونده‌ها با یک ابزار ادغام خارجی
jj-restore(1): بازیابی مسیرها از یک بازنگری دیگر
jj-revert(1): اعمال معکوس بازنگری (یا بازنگری‌های) ارائه‌شده
jj-root(1): نمایش دایرکتوری ریشهٔ فضای کاری فعلی (میانبری برای `jj workspace root`)
jj-run(1): اجرای یک دستور در مجموعه‌ای از بازنگری‌ها
jj-show(1): نمایش فراداده و تفاوت‌های بازنگری
jj-sign(1): امضای رمزنگاری‌شدهٔ یک بازنگری
jj-simplify-parents(1): ساده‌سازی یال‌های والد برای بازنگری (یا بازنگری‌های) مشخص‌شده
jj-sparse(1): مدیریت مسیرهایی از کامیت رونوشت کاری که در رونوشت کاری وجود دارند
jj-split(1): تقسیم یک بازنگری به دو بخش
jj-squash(1): انتقال تغییرات از یک بازنگری به بازنگری دیگر
jj-status(1): نمایش وضعیت سطح بالای مخزن [نام مستعار پیش‌فرض: st]
jj-tag(1): مدیریت تگ‌ها
jj-undo(1): بازگرداندن (لغو) آخرین عملیات
jj-unsign(1): حذف امضای رمزنگاری‌شده
jj-util(1): دستورهای کم‌استفاده مانند تولید کدهای تکمیل خودکار پوسته
jj-version(1): نمایش اطلاعات نسخه
jj-workspace(1): دستورهایی برای کار با فضاهای کاری

اطلاعات اضافی (EXTRA)

دستور 'jj help --help' کلمات کلیدی موجود را فهرست می‌کند. برای نمایش راهنمای یکی از این کلمات کلیدی، از 'jj help -k' استفاده کنید.

نسخه (VERSION)

v0.45.1