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

jj-bookmark-list - فهرست کردن نشانک‌ها و اهداف آن‌ها

jj bookmark 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]

فهرست کردن نشانک‌ها (bookmarks) و اهداف آن‌ها.

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

برای اطلاعات بیشتر به [`jj help -k bookmarks`] مراجعه کنید.

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

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

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

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

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

تنها نمایش نشانک‌های دوردست ردیابی‌شده.

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

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

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

رندر کردن هر نشانک با استفاده از الگوی داده‌شده.

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

الگوی پیش‌فرض را می‌توان با تنظیم templates.bookmark_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.bookmark-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/ در اجداد دایرکتوری کاری فعلی جستجو می‌کند.

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

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

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

دستور را طبق معمول اجرا می‌کند اما هیچ عملیاتی را یکپارچه‌سازی (integrate) نمی‌کند.

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

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

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

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

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

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

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

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

می‌توانید از --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 همچنان فایل‌ها را فهرست می‌کند، اما دیگر گزارشی مبنی بر اینکه آیا از نسخه کاری اسنپ‌شات گرفته شده یا فرزندان بازپایه‌ریزی (rebase) شده‌اند ارائه نمی‌دهد.

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

غیرفعال‌سازی صفحه‌بندی‌کننده (pager).
گزینه‌های پیکربندی اضافی (می‌تواند تکرار شود).

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

فایل‌های پیکربندی اضافی (می‌تواند تکرار شود).

jj(1), jj-bookmark(1)

list