jj-tag-list(1) General Commands Manual jj-tag-list(1)

jj-tag-list - فهرست کردن تگ‌ها و هدف‌های آن‌ها

jj tag list [-a|--all-remotes] [-R|--repository] [--ignore-working-copy] [--remote] [--no-integrate-operation] [-t|--tracked] [-c|--conflicted] [--ignore-immutable] [--at-operation] [-r|--revision] [--debug] [-T|--template] [--color] [--sort] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help] [NAMES]

فهرست کردن تگ‌ها و هدف‌های آن‌ها

به‌طور پیش‌فرض، یک تگ راه دور ردیابی‌شده تنها در صورتی گنجانده می‌شود که هدف آن با تگ محلی متفاوت باشد. یک تگ راه دور ردیابی‌نشده فهرست نخواهد شد. برای یک تگ دارای تداخل (هم محلی و هم راه دور)، بازنگری‌های هدف قبلی با یک علامت "-" و بازنگری‌های هدف جدید با یک علامت "+" مشخص می‌شوند.

فلگ `-r` در ترکیب با عبارت‌های مجموعه‌بازنگری (revset) می‌تواند برای پالایش استفاده شود. برای مثال:

* `jj tag list -r 'REV::'` تگ‌هایی را نشان می‌دهد که هدف‌های آن‌ها از نوادگان REV هستند (مشابه `git tag --contains REV`).

* `jj tag list -r '::REV'` تگ‌هایی را نشان می‌دهد که هدف‌های آن‌ها از اجداد REV هستند (مشابه `git tag --merged REV`).

نمایش همه تگ‌های راه دور ردیابی‌شده و ردیابی‌نشده، از جمله مواردی که هدف‌های آن‌ها با تگ‌های محلی همگام شده‌اند
نمایش همه تگ‌های راه دور ردیابی‌شده و ردیابی‌نشده متعلق به این مخزن راه دور

می‌تواند با `--tracked` یا `--conflicted` برای پالایش تگ‌های نمایش‌داده‌شده ترکیب شود (قابل تکرار است).

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

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

تنها نمایش تگ‌های راه دور ردیابی‌شده

این گزینه به‌طور پیش‌فرض تگ‌های محلی ردیابی‌کننده Git را حذف می‌کند.

تنها نمایش تگ‌های دارای تداخل
نمایش تگ‌هایی که هدف‌های محلی آن‌ها در بازنگری‌های مشخص‌شده قرار دارند

توجه داشته باشید که `-r deleted_tag` کار نخواهد کرد زیرا `deleted_tag` هدف محلی نخواهد داشت.

رندر کردن هر تگ با استفاده از قالب داده‌شده

تمام متدهای بدون آرگومان نوع [`CommitRef` type] به عنوان کلیدواژه در عبارت قالب در دسترس هستند. برای اطلاعات بیشتر [`jj help -k templates`] را ببینید.

قالب پیش‌فرض را می‌توان با تنظیم `templates.tag_list` تعیین کرد.

[`CommitRef` type]: https://docs.jj-vcs.dev/latest/templates/#commitref-type

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

مرتب‌سازی تگ‌ها بر اساس کلید داده‌شده (یا چند کلید)

برای مرتب‌سازی نزولی، به انتهای کلید `-` اضافه کنید (مثلاً `--sort name-`). توجه داشته باشید که هنگام استفاده از چند کلید، اولین کلید بیشترین اولویت را دارد.

پیش‌فرض این گزینه بر اساس تنظیم `ui.tag-list-sort-keys` تعیین می‌شود.

مقادیر ممکن:

  • name
  • name-
  • author-name
  • author-name-
  • author-email
  • author-email-
  • author-date
  • author-date-
  • committer-name
  • committer-name-
  • committer-email
  • committer-email-
  • committer-date
  • committer-date-
چاپ راهنما (مشاهده خلاصه با '-h')
[NAMES]
نمایش تگ‌هایی که نام محلی آن‌ها مطابقت دارد

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

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

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

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

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

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

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

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

هنگامی که این گزینه ارائه شود، عملیات‌ها همچنان مثل همیشه ایجاد می‌شوند، اما در لاگ عملیات ادغام نخواهند شد. همچنین رونوشت کاری به‌روزرسانی نمی‌شود.

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

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

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

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

این گزینه فقط بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری (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` مشخص شده است.

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

فعال‌سازی لاگ اشکال‌زدایی
زمان رنگی‌کردن خروجی

مقادیر ممکن:

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

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

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

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

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

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