| jj-workspace(1) | General Commands Manual | jj-workspace(1) |
نام (NAME)
jj-workspace - دستورهایی برای کار با فضاهای کاری
خلاصه دستور (SYNOPSIS)
jj workspace [-R|--repository] [--ignore-working-copy] [--no-integrate-operation] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help] <subcommands>
توضیحات (DESCRIPTION)
دستورهایی برای کار با فضاهای کاری (workspaces).
فضاهای کاری به شما امکان می‌دهند رونوشت‌های کاری (working copies) بیشتری متصل به همان مخزن اضافه کنید. یک کاربرد معمول این است که بتوانید یک ساخت (build) یا آزمون کُند را در یک فضای کاری اجرا کنید، در حالی که در فضای کاری دیگر به نوشتن کد ادامه می‌دهید.
هر فضای کاری دارای کامیت رونوشت کاری (working-copy commit) اختصاصی خود است. هنگامی که بیش از یک فضای کاری متصل به مخزن داشته باشید، در دستور jj log با عبارت <workspace name>@ مشخص می‌شوند.
هر فضای کاری همچنین دارای الگوهای پراکنده (sparse patterns) اختصاصی خود است.
گزینه‌ها (OPTIONS)
- -h, --help
- چاپ راهنما (مشاهده خلاصه با '-h')
گزینه‌های عمومی (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
- اجازه
بازنویسی
کامیت‌های
تغییرناپذیر
(immutable)
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌ها در مجموعه پیکربندی‌شده کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه این بررسی را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.
این گزینه فقط بر بررسی یادشده تأثیر می‌گذارد و روی مجموعه بازنگری (revset) 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 همچنان فایل‌ها را فهرست خواهد کرد، اما مشخص نمی‌کند که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا نوادگان (descendants) ریبیس شده‌اند یا خیر.
هشدارها و خطاها همچنان چاپ خواهند شد.
- --no-pager
- غیرفعال کردن صفحه‌بندی‌کننده (pager)
- --config <NAME=VALUE>
- گزینه‌های
پیکربندی
اضافی (قابل
تکرار)
نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای درون ساختارهای TOML (مانند آرایه‌ها) قرار نگرفته باشد، می‌توان علامت‌های نقل‌قول را حذف کرد.
- --config-file <PATH>
- فایل‌های پیکربندی اضافی (قابل تکرار)
زیردستورها (SUBCOMMANDS)
- jj-workspace-add(1)
- افزودن یک فضای کاری
- jj-workspace-forget(1)
- توقف ردیابی کامیت رونوشت کاری یک فضای کاری در مخزن
- jj-workspace-list(1)
- فهرست کردن فضاهای کاری
- jj-workspace-rename(1)
- تغییر نام فضای کاری فعلی
- jj-workspace-root(1)
- نمایش دایرکتوری ریشهٔ فضای کاری
- jj-workspace-update-stale(1)
- به‌روزرسانی یک فضای کاری که قدیمی شده است
همچنین ببینید (SEE ALSO)
jj(1), jj-workspace-add(1), jj-workspace-forget(1), jj-workspace-list(1), jj-workspace-rename(1), jj-workspace-root(1), jj-workspace-update-stale(1)
| workspace |