.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj-config-set 1  "set " 
.SH "نام (NAME)"
jj\-config\-set \- به‌روزرسانی یک فایل پیکربندی برای تنظیم گزینهٔ داده‌شده روی یک مقدار مشخص
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj config set\fR [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-\-ignore\-working\-copy\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] <\fB\-\-user\fR|\fB\-\-repo\fR|\fB\-\-workspace\fR|\fB\-\-file\fR> <\fINAME\fR> <\fIVALUE\fR> 
.SH "توضیحات (DESCRIPTION)"
به‌روزرسانی یک فایل پیکربندی برای تنظیم گزینهٔ داده‌شده روی یک مقدار مشخص.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-user\fR
هدف قرار دادن فایل پیکربندی در سطح کاربر (user-level)
.TP
\fB\-\-repo\fR
هدف قرار دادن فایل پیکربندی در سطح مخزن (repo-level)
.TP
\fB\-\-workspace\fR
هدف قرار دادن فایل پیکربندی در سطح فضای کاری (workspace-level)
.TP
\fB\-\-file\fR \fI<PATH>\fR
هدف قرار دادن فایل پیکربندی مشخص‌شده با مسیر داده‌شده
.sp
مسیر باید به یک مکان معتبر فایل پیکربندی اشاره داشته باشد که توسط Jujutsu شناسایی می‌شود (مانند پیکربندی کاربر/مخزن/فضای‌کاری، فایلی درون دایرکتوری `conf.d/`، یا هر فایلی که از طریق پیکربندی‌های سیستم، `$JJ_CONFIG` یا `\-\-config\-file` بارگذاری شده است).
.sp
برخلاف گزینهٔ عمومی `\-\-config\-file` (که هنگام اجرای دستورات یک فایل پیکربندی اضافی را بارگذاری می‌کند)، این گزینه مشخص می‌کند که کدام فایل روی دیسک بررسی، ویرایش یا اصلاح شود.
.sp
اگر فایل وجود نداشته باشد، دستوراتی مانند `set` و `edit` آن فایل و هرگونه دایرکتوری والد ناموجود را ایجاد خواهند کرد.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
<\fINAME\fR>
نام گزینهٔ پیکربندی مورد نظر برای تنظیم
.TP
<\fIVALUE\fR>
مقدار جدید برای تنظیم
.sp
مقدار باید به‌صورت یک عبارت TOML مشخص شود. اگر مقدار رشته‌ای درون ساختارهای TOML (مانند آپاستروف‌ها یا نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از علامت‌های نقل‌قول صرف‌نظر کرد. توجه داشته باشید که ممکن است مقدار به نقل‌قول‌گذاری پوسته (shell quoting) نیز نیاز داشته باشد. رشته‌های چندخطی TOML می‌توانند در صورتی که مقدار حاوی آپاستروف باشد، مفید واقع شوند. برای نمونه، برای تنظیم `foo.bar` روی رشتهٔ "{don\*(Aqt}" از `jj config set \-\-user foo.bar "\*(Aq\*(Aq\*(Aq{don\*(Aqt}\*(Aq\*(Aq\*(Aq"` استفاده کنید. این عبارت در هر دو پوستهٔ Bash و Fish معتبر است.
.sp
به عنوان روشی جایگزین، مثلاً برای اجتناب از درگیر شدن با نقل‌قول‌گذاری‌های پوسته، می‌توانید از `jj config edit` برای ویرایش مستقیم فایل TOML استفاده کنید.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که عملیات روی آن انجام می‌شود
.sp
به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین پوشهٔ .jj/ در اجداد دایرکتوری کاری فعلی می‌گردد.
.TP
\fB\-\-ignore\-working\-copy\fR
از رونوشت کاری اسنپ‌شات نمی‌گیرد و آن را به‌روزرسانی نمی‌کند
.sp
به‌طور پیش‌فرض، Jujutsu در آغاز هر دستور از رونوشت کاری یک اسنپ‌شات تهیه می‌کند. همچنین اگر دستور، کامیت رونوشت کاری (`@`) را تغییر داده باشد، رونوشت کاری در پایان دستور به‌روزرسانی می‌شود. اگر می‌خواهید از گرفتن اسنپ‌شات از رونوشت کاری صرف‌نظر کنید و در عوض یک کامیت احتمالاً قدیمی از رونوشت کاری را ببینید، می‌توانید از `\-\-ignore\-working\-copy` استفاده کنید. این گزینه برای نمونه در خط اعلان (command prompt) می‌تواند مفید باشد، به‌ویژه اگر فرآیند دیگری داشته باشید که از رونوشت کاری کامیت تهیه می‌کند.
.sp
بارگذاری مخزن در یک عملیات مشخص با `\-\-at\-operation` به‌طور ضمنی شامل `\-\-ignore\-working\-copy` می‌شود.
.TP
\fB\-\-no\-integrate\-operation\fR
اجرای دستور به صورت عادی، اما بدون یکپارچه‌سازی هیچ عملیاتی
.sp
هنگامی که این گزینه مشخص شود، عملیات‌ها همچنان مثل همیشه ایجاد می‌شوند اما در لاگ عملیات (operation log) یکپارچه نخواهند شد. همچنین رونوشت کاری به‌روزرسانی نمی‌شود.
.sp
دستور شناسهٔ عملیات حاصل را چاپ خواهد کرد. می‌توانید آن را به عنوان مثال به `jj \-\-at\-op` ارسال کنید تا وضعیت به‌دست‌آمده در مخزن را بررسی کنید، یا آن را به `jj op restore` بدهید تا مخزن را به آن وضعیت بازگرداند. همچنین می‌توانید این شناسه را به `jj op integrate` بدهید تا عملیات یکپارچه شود.
.sp
توجه داشته باشید که این کار مانع از اثرات جانبی خارج از مخزن *نمی‌شود*. برای نمونه، `jj git push \-\-no\-integrate\-operation` همچنان عملیات push را انجام خواهد داد.
.TP
\fB\-\-ignore\-immutable\fR
اجازهٔ بازنویسی کامیت‌های تغییرناپذیر
.sp
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌ها در مجموعهٔ پیکربندی‌شده از کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه این بررسی را غیرفعال کرده و اجازه می‌دهد هر کامیتی به‌جز کامیت ریشه (root commit) را بازنویسی کنید.
.sp
این گزینه فقط بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری (revset) عبارت `immutable_heads()` یا کلیدواژهٔ الگوی `immutable` اثری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن بر اساس آن بارگذاری شود
.sp
عملیاتی که مخزن بر اساس آن بارگذاری می‌شود. به‌طور پیش‌فرض، Jujutsu مخزن را بر اساس تازه‌ترین عملیات، یا در صورت وجود عملیات‌های واگرا، ادغام آن‌ها بارگذاری می‌کند.
.sp
می‌توانید از `\-\-at\-op=<operation ID>` استفاده کنید تا ببینید وضعیت مخزن در یک عملیات پیشین چگونه بوده است. برای نمونه، `jj \-\-at\-op=<operation ID> st` آنچه را که `jj st` در زمان پایان یافتن آن عملیات نشان می‌داد، نمایش خواهد داد. مقدار `\-\-at\-op=@` تقریباً مشابه حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.
.sp
از دستور `jj op log` برای یافتن شناسهٔ عملیات مورد نظر خود استفاده کنید. هر پیشوند یکتایی از شناسهٔ عملیات کافی است.
.sp
هنگام بارگذاری مخزن بر اساس یک عملیات پیشین، رونوشت کاری نادیده گرفته خواهد شد، گویی گزینهٔ `\-\-ignore\-working\-copy` مشخص شده است.
.sp
امکان اجرای دستورهای تغییردهنده (mutating) هنگام بارگذاری مخزن بر اساس یک عملیات پیشین وجود دارد. انجام این کار معادل اجرای همزمان دستورات از مبدأ آن عملیات پیشین است. به‌ندرت دلیلی برای انجام این کار وجود دارد، اما امکان‌پذیر است.
.TP
\fB\-\-debug\fR
فعال‌سازی ثبت وقایع اشکال‌زدایی (debug logging)
.TP
\fB\-\-color\fR \fI<WHEN>\fR
زمان رنگی‌کردن خروجی
.br
.sp
\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
بی‌صدا کردن خروجی‌های غیراصلی دستور
.sp
برای نمونه، `jj file list` همچنان فایل‌ها را فهرست خواهد کرد، اما مشخص نمی‌کند که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا نوادگان بازپایه‌ریزی (rebase) شده‌اند یا خیر.
.sp
هشدارها و خطاها همچنان چاپ خواهند شد.
.TP
\fB\-\-no\-pager\fR
غیرفعال کردن صفحه‌بندی‌کننده (pager)
.TP
\fB\-\-config\fR \fI<NAME=VALUE>\fR
گزینه‌های پیکربندی اضافی (قابل تکرار)
.sp
نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت یک عبارت TOML تعیین گردد. در صورتی که مقدار رشته‌ای درون ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان علامت‌های نقل‌قول را حذف کرد.
.TP
\fB\-\-config\-file\fR \fI<PATH>\fR
فایل‌های پیکربندی اضافی (قابل تکرار)