.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj-sparse-set 1  "set " 
.SH "نام (NAME)"
jj\-sparse\-set \- به‌روزرسانی الگوهای موجود در رونوشت کاری
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj sparse set\fR [\fB\-\-add\fR] [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-\-ignore\-working\-copy\fR] [\fB\-\-remove\fR] [\fB\-\-clear\fR] [\fB\-\-no\-integrate\-operation\fR] [\fB\-\-ignore\-immutable\fR] [\fB\-\-at\-operation\fR] [\fB\-\-debug\fR] [\fB\-\-color\fR] [\fB\-\-quiet\fR] [\fB\-\-no\-pager\fR] [\fB\-\-config\fR] [\fB\-\-config\-file\fR] [\fB\-h\fR|\fB\-\-help\fR] 
.SH "توضیحات (DESCRIPTION)"
به‌روزرسانی الگوهای موجود در رونوشت کاری
.PP
برای نمونه، اگر تمام آنچه نیاز دارید فایل `README.md` و پوشهٔ `lib/` است، از دستور `jj sparse set \-\-clear \-\-add README.md \-\-add lib` استفاده کنید. اگر دیگر به پوشهٔ `lib` نیاز ندارید، از دستور `jj sparse set \-\-remove lib` استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-add\fR \fI<ADD>\fR
الگوهایی برای افزودن به رونوشت کاری
.TP
\fB\-\-remove\fR \fI<REMOVE>\fR
الگوهایی برای حذف از رونوشت کاری
.TP
\fB\-\-clear\fR
هیچ فایلی در رونوشت کاری گنجانده نشود (ترکیب با \-\-add)
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که عملیات روی آن انجام می‌شود

به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در مسیرهای والد دایرکتوری کاری فعلی می‌گردد.
.TP
\fB\-\-ignore\-working\-copy\fR
از رونوشت کاری اسنپ‌شات گرفته نشود و به‌روزرسانی نیز نگردد

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

بارگذاری مخزن در یک عملیات خاص با `\-\-at\-operation` به معنای فعال بودن `\-\-ignore\-working\-copy` است.
.TP
\fB\-\-no\-integrate\-operation\fR
اجرای دستور طبق معمول اما بدون ادغام عملیات‌ها

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

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

توجه داشته باشید که این گزینه مانع اثرات جانبی خارج از مخزن *نمی‌شود*. برای نمونه، دستور `jj git push \-\-no\-integrate\-operation` همچنان عملیات ارسال (push) را انجام خواهد داد.
.TP
\fB\-\-ignore\-immutable\fR
اجازه بازنویسی کامیت‌های تغییرناپذیر

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

این گزینه فقط بر روی این بررسی تأثیر می‌گذارد و روی مجموعه بازبینی `immutable_heads()` یا کلمهٔ کلیدی الگوی `immutable` اثری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن بر مبنای آن بارگذاری شود

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

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

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

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

امکان اجرای دستورات تغییردهنده (mutating) هنگام بارگذاری مخزن در یک عملیات قبلی وجود دارد. انجام این کار معادل اجرای دستورات همزمان با شروع از عملیات پیشین است. به‌ندرت دلیلی برای انجام این کار وجود دارد، اما امکان‌پذیر است.
.TP
\fB\-\-debug\fR
فعال‌سازی گزارش‌گیری اشکال‌زدایی (debug logging)
.TP
\fB\-\-color\fR \fI<WHEN>\fR
زمان رنگی‌سازی خروجی
.br

.br
\fIمقادیر مجاز:\fR
.RS 14
.IP \(bu 2
always
.IP \(bu 2
never
.IP \(bu 2
debug
.IP \(bu 2
auto
.RE
.TP
\fB\-\-quiet\fR
بی‌صدا کردن خروجی‌های غیر اصلی دستور

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

هشدارها و خطاها همچنان چاپ خواهند شد.
.TP
\fB\-\-no\-pager\fR
غیرفعال کردن صفحه‌بندی‌کننده (pager)
.TP
\fB\-\-config\fR \fI<NAME=VALUE>\fR
گزینه‌های پیکربندی اضافی (قابل تکرار)

نام باید به صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به عنوان یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای در هیچ‌یک از ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت نقل‌قول صرف‌نظر کرد.
.TP
\fB\-\-config\-file\fR \fI<PATH>\fR
فایل‌های پیکربندی اضافی (قابل تکرار)