jj-bookmark-track(1) General Commands Manual jj-bookmark-track(1)

jj-bookmark-track - شروع ردگیری بوک‌مارک‌های مشخص‌شده در مخزن راه دور

jj bookmark track [-R|--repository] [--remote] [--ignore-working-copy] [--no-integrate-operation] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help] <BOOKMARK[@REMOTE]>

شروع ردگیری بوک‌مارک‌های مشخص‌شده در مخزن راه دور (remote bookmarks).

یک بوک‌مارک راه دور ردیابی‌شده، به عنوان یک بوک‌مارک محلی با همان نام وارد (import) خواهد شد. تغییرات آن در دریافت‌های بعدی (pulls)، به بوک‌مارک محلی موجود منتقل می‌شود.

نام‌های مخزن راه دور (remotes) برای ردگیری

به‌طور پیش‌فرض، الگوی مشخص‌شده نام‌های مخزن راه دور را با نحو glob مطابقت می‌دهد. همچنین می‌توانید از سایر نحوهای الگوی رشته‌ای [string pattern syntax] استفاده کنید.

اگر هیچ نام مخزن راه دوری مشخص نشود، تمام بوک‌مارک‌های راه دوری که با نام‌های بوک‌مارک همخوانی داشته باشند ردگیری خواهند شد.

[string pattern syntax]: https://docs.jj-vcs.dev/latest/revsets/#string-patterns

چاپ راهنما (مشاهده خلاصه با '-h')
<BOOKMARK[@REMOTE]>
الگوهای نام بوک‌مارک یا نمادهای بوک‌مارک راه دور برای ردگیری

عبارت BOOKMARK به‌طور پیش‌فرض نام‌های بوک‌مارک را با استفاده از نحو glob مطابقت می‌دهد. همچنین می‌توانید از سایر نحوهای الگوی رشته‌ای [string pattern syntax] استفاده کنید.

عبارت BOOKMARK@REMOTE دقیقاً به یک بوک‌مارک مشخص در مخزن راه دور ارجاع داده می‌شود.

[string pattern syntax]: https://docs.jj-vcs.dev/latest/revsets/#string-patterns

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

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

از کپی کاری (working copy) اسنپ‌شات نمی‌گیرد و آن را به‌روزرسانی نمی‌کند

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

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

اجرای دستور به صورت عادی، اما عدم ادغام هیچ‌یک از عملیات‌ها

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

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

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

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

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

این گزینه فقط بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری (revset) 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 همچنان فایل‌ها را فهرست خواهد کرد، اما مشخص نمی‌کند که آیا از کپی کاری اسنپ‌شات گرفته شده یا نوادگان (descendants) بازپایه‌ریزی (rebase) شده‌اند یا خیر.

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

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

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

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

jj(1), jj-bookmark(1), jj-bookmark-untrack(1), jj-bookmark-list(1)

track