.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH jj-gerrit-upload 1  "upload "
.SH "نام (NAME)"
jj\-gerrit\-upload \- بارگذاری تغییرات در Gerrit برای بازبینی کد، یا به‌روزرسانی تغییرات موجود
.SH "خلاصه دستور (SYNOPSIS)"
\fBjj gerrit upload\fR [\fB\-r\fR|\fB\-\-revision\fR] [\fB\-R\fR|\fB\-\-repository\fR] [\fB\-b\fR|\fB\-\-remote\-branch\fR] [\fB\-\-ignore\-working\-copy\fR] [\fB\-\-no\-integrate\-operation\fR] [\fB\-\-remote\fR] [\fB\-\-ignore\-immutable\fR] [\fB\-n\fR|\fB\-\-dry\-run\fR] [\fB\-\-at\-operation\fR] [\fB\-\-reviewer\fR] [\fB\-\-cc\fR] [\fB\-\-debug\fR] [\fB\-\-color\fR] [\fB\-l\fR|\fB\-\-label\fR] [\fB\-\-quiet\fR] [\fB\-\-topic\fR] [\fB\-\-hashtag\fR] [\fB\-\-no\-pager\fR] [\fB\-\-config\fR] [\fB\-m\fR|\fB\-\-message\fR] [\fB\-\-config\-file\fR] [\fB\-\-edit\fR] [\fB\-\-wip\fR] [\fB\-\-ready\fR] [\fB\-\-private\fR] [\fB\-\-remove\-private\fR] [\fB\-\-publish\-comments\fR] [\fB\-\-no\-publish\-comments\fR] [\fB\-\-notify\fR] [\fB\-\-submit\fR] [\fB\-\-skip\-validation\fR] [\fB\-\-merged\fR] [\fB\-\-ignore\-attention\-set\fR] [\fB\-\-deadline\fR] [\fB\-\-custom\fR] [\fB\-o\fR|\fB\-\-option\fR] [\fB\-\-trace\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH "توضیحات (DESCRIPTION)"
بارگذاری تغییرات در Gerrit برای بازبینی کد، یا به‌روزرسانی تغییرات موجود
.PP
بارگذاری مجموعه‌ای از بازبینی‌ها در Gerrit یک «تغییر» (change) مجزا برای هر بازبینی موجود در مجموعه بازبینی (revset) و تمام نیاکان تغییرپذیر آن‌ها ایجاد می‌کند. سپس این تغییرات برای بازبینی در نمونهٔ Gerrit شما در دسترس خواهند بود.
.PP
اگر تغییری از قبل برای یک بازبینی مشخص وجود داشته باشد (یعنی حاوی همان
.B Change\-Id
باشد)، این دستور محتویات تغییر موجود را به‌روزرسانی می‌کند تا با آن مطابقت داشته باشد.
.PP
نکته: هر کامیتی در مجموعه بازبینی مشخص‌شده که فاقد دنبالهٔ (trailer)
.B Change\-Id
باشد، بر اساس شناسهٔ تغییر Jujutsu یکی برای آن تولید خواهد شد. این دنباله فقط به کامیت بارگذاری‌شده اضافه می‌شود، به این معنی که شناسهٔ کامیت حاصل که در Gerrit بارگذاری شده ممکن است با شناسهٔ کامیت محلی شما مطابقت نداشته باشد. در نتیجه، هنگام واکشی یک تغییر ادغام‌شده به مخزن محلی خود، ممکن است با واگرایی مواجه شوید. برای رفع این مشکل، می‌توانید تغییر محلی خود را رها کنید یا آن را با دستور
.B jj rebase \-\-skip\-emptied ...
روی شاخهٔ اصلی (trunk) بازپایه‌ریزی (rebase) کنید که واگرایی را برطرف می‌کند. همچنین، می‌توانید پیکربندی زیر را به تنظیمات Jujutsu خود اضافه کنید تا پیش از اجرای
.B jj gerrit upload
دنباله‌های
.B Change\-Id
به‌طور خودکار به کامیت‌های محلی شما اضافه شوند:
.PP
.nf
[templates]
commit_trailers = \*(Aq\*(Aq\*(Aq
if(
  !trailers.contains_key("Change\-Id"),
  format_gerrit_change_id_trailer(self)
)
\*(Aq\*(Aq\*(Aq
.fi
.PP
همچنین به مستندات Jujutsu دربارهٔ Gerrit مراجعه کنید:
.PP
https://docs.jj\-vcs.dev/latest/gerrit
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-r\fR, \fB\-\-revision\fR \fI<REVSETS>\fR
بازبینی‌هایی که باید در Gerrit بارگذاری شوند
.sp
تمام نیاکان تغییرپذیر بازبینی‌های مشخص‌شده نیز ارسال خواهند شد. این بدان معناست که
.B jj gerrit upload \-r foo
معادل
.B jj gerrit upload \-r \*(Aqmutable()::foo\*(Aq
است.
.sp
اگر این گزینه مشخص نشود، در صورت وجود توضیحات،
.B @
و در غیر این صورت
.B @\-
بارگذاری خواهد شد.
.TP
\fB\-b\fR, \fB\-\-remote\-branch\fR \fI<REMOTE_BRANCH>\fR
موقعیتی که قرار است تغییرات شما در آن اعمال شوند
.sp
این باید یک شاخه در ریموت باشد. مقدار پیش‌فرض، تنظیم
.B gerrit.default\-remote\-branch
است.
.TP
\fB\-\-remote\fR \fI<REMOTE>\fR
ریموت Gerrit که باید تغییرات به آن ارسال (push) شوند
.sp
این گزینه می‌تواند به هر ریموت گیت پیکربندی‌شده اشاره کند یا یک نشانی کامل SSH باشد. مقدار پیش‌فرض، تنظیم
.B gerrit.default\-remote
است.
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
فقط نمایش مواردی که در ریموت تغییر خواهند کرد؛ تغییرات به Gerrit ارسال نشوند
.TP
\fB\-\-reviewer\fR \fI<REVIEWER>\fR
افزودن این نشانی‌های ایمیل به عنوان بازبین (قابل تکرار)
.TP
\fB\-\-cc\fR \fI<CC>\fR
رونوشت (CC) این نشانی‌های ایمیل در تغییر (قابل تکرار)
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
افزودن برچسب‌های زیر که توسط Gerrit پیکربندی شده‌اند (قابل تکرار)
.sp
هر برچسب می‌تواند یک پسوند از مقداری که باید تنظیم شود داشته باشد، مانند "+2". در صورتی که مقداری تنظیم نشده باشد، مقدار پیش‌فرض "+1" است.
.sp
توجه داشته باشید که Gerrit برچسب‌هایی را که روی میزبان Gerrit شما موجود نیستند، نادیده می‌گیرد.
.sp
مثال‌ها:
.br
\-
.B \-\-label=Commit\-Queue
برچسب
.B Commit\-Queue
را روی +1 تنظیم می‌کند.
.br
\-
.B \-\-label=Commit\-Queue+2
آن را روی +2 تنظیم می‌کند.
.TP
\fB\-\-topic\fR \fI<TOPIC>\fR
اعمال یک موضوع (topic) روی تغییر
.sp
تغییرات را می‌توان بر اساس موضوع گروه‌بندی کرد، و Gerrit می‌تواند طوری پیکربندی شود که تمام تغییرات یک موضوع را با یک کلیک با هم ثبت کند.
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/intro\-user.html#topics
.TP
\fB\-\-hashtag\fR \fI<HASHTAG>\fR
اعمال یک هشتگ روی تغییر (قابل تکرار)
.sp
هشتگ‌ها رشته‌های متنی آزاد هستند که همانند شبکه‌های اجتماعی با یک تغییر مرتبط می‌شوند. مشابه موضوعات، از هشتگ‌ها می‌توان برای گروه‌بندی تغییرات مرتبط به هم و جستجو با عملگر
.B hashtag:
استفاده کرد. برخلاف موضوعات، یک تغییر می‌تواند چندین هشتگ داشته باشد و آن‌ها تنها برای گروه‌بندی اطلاعاتی استفاده می‌شوند. تغییرات دارای هشتگ یکسان لزوماً با هم ثبت نمی‌شوند.
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/intro\-user.html#hashtags
.TP
\fB\-m\fR, \fB\-\-message\fR \fI<MESSAGE>\fR
توضیحات مربوط به مجموعه وصله (patch set)
.TP
\fB\-\-edit\fR
ارسال تغییر به عنوان ویرایش تغییر (change edit)
.sp
برای ارسال یک ویرایش تغییر، تغییر اصلی باید از قبل روی سرور Gerrit وجود داشته باشد. ویرایش‌های تغییر بلافاصله یک مجموعه وصلهٔ جدید ایجاد نمی‌کنند، بلکه ابتدا باید از طریق رابط کاربری وب منتشر شوند. برای هر تغییر تنها یک ویرایش می‌تواند وجود داشته باشد. ارسال یک ویرایش تغییر جدید، ویرایش قبلی را جایگزین خواهد کرد.
.TP
\fB\-\-wip\fR
علامت‌گذاری تغییر به عنوان کار در حال انجام (WIP)
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/intro\-user.html#wip
.TP
\fB\-\-ready\fR
علامت‌گذاری تغییر به عنوان آماده (دیگر در حال انجام نیست)
.TP
\fB\-\-private\fR
علامت‌گذاری تغییر به عنوان خصوصی (private)
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/intro\-user.html#private\-changes
.TP
\fB\-\-remove\-private\fR
خارج کردن تغییر از حالت خصوصی
.TP
\fB\-\-publish\-comments\fR
انتشار نظرات پیش‌نویس برای تغییر مشخص‌شده
.TP
\fB\-\-no\-publish\-comments\fR
عدم انتشار نظرات پیش‌نویس برای تغییر مشخص‌شده
.sp
این گزینه تنها زمانی مفید است که کاربر Gerrit را طوری پیکربندی کرده باشد که نظرات را به طور پیش‌فرض منتشر کند.
.TP
\fB\-\-notify\fR \fI<NOTIFY>\fR
اعلان‌های ایمیلی به چه کسانی ارسال شود (پیش‌فرض: all)
.br

.br
\fIمقادیر مجاز:\fR
.RS 14
.IP \(bu 2
none: هیچ ایمیلی ارسال نشود
.IP \(bu 2
owner: تنها به مالک تغییر اطلاع داده شود
.IP \(bu 2
owner\-reviewers: تنها به مالک تغییر و بازبین‌ها اطلاع داده شود
.IP \(bu 2
all: تمام کاربران مرتبط، از جمله مالک، بازبین‌ها، افراد رونوشت‌شده (cc)، کاربرانی که تغییر را ستاره‌دار کرده‌اند و کاربرانی که روی فایل‌های تغییر رصد تنظیم کرده‌اند
.RE
.TP
\fB\-\-submit\fR
ثبت مستقیم تغییرات با دور زدن فرآیند بازبینی کد
.TP
\fB\-\-skip\-validation\fR
هنگامی که \-\-submit مشخص شده باشد، اعتبارسنجی‌ها نادیده گرفته شوند
.TP
\fB\-\-merged\fR
ایجاد یک تغییر جدید، حتی اگر تغییر از قبل ادغام شده باشد
.TP
\fB\-\-ignore\-attention\-set\fR
مجموعه توجه (attention set) هنگام بارگذاری دستکاری نشود
.TP
\fB\-\-deadline\fR \fI<DEADLINE>\fR
مهلت زمانی که پس از آن عملیات ارسال (push) باید لغو شود
.TP
\fB\-\-custom\fR \fI<CUSTOM>\fR
ارسال مقادیر سفارشی کلیددار زیر به Gerrit (قابل تکرار)
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/user\-upload.html#custom_keyed_values
.TP
\fB\-o\fR, \fB\-\-option\fR \fI<OPTION>\fR
ارسال یک گزینهٔ `git push \-o` (قابل تکرار)
.TP
\fB\-\-trace\fR \fI<TRACE>\fR
برای اشکال‌زدایی Gerrit
.sp
ببینید:
https://gerrit\-review.googlesource.com/Documentation/user\-upload.html#trace
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
\fB\-R\fR, \fB\-\-repository\fR \fI<REPOSITORY>\fR
مسیر مخزنی که باید روی آن کار شود
.sp
به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در مسیرهای والد دایرکتوری کاری فعلی می‌گردد.
.TP
\fB\-\-ignore\-working\-copy\fR
از نسخهٔ کاری اسنپ‌شات گرفته نشود و به‌روزرسانی نیز نگردد
.sp
به‌طور پیش‌فرض، Jujutsu در ابتدای هر دستور از نسخهٔ کاری اسنپ‌شات می‌گیرد. همچنین در پایان دستور، اگر دستور کامیت نسخهٔ کاری (`@`) را تغییر داده باشد، نسخهٔ کاری به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از نسخهٔ کاری صرف‌نظر کنید و در عوض یک کامیت نسخهٔ کاری احتمالاً قدیمی را مشاهده کنید، می‌توانید از
.B \-\-ignore\-working\-copy
استفاده کنید. این مورد می‌تواند برای مثال در خط فرمان (prompt) مفید باشد، به‌ویژه اگر فرآیند دیگری داشته باشید که نسخهٔ کاری را کامیت می‌کند.
.sp
بارگذاری مخزن در یک عملیات خاص با
.B \-\-at\-operation
به معنای فعال بودن
.B \-\-ignore\-working\-copy
است.
.TP
\fB\-\-no\-integrate\-operation\fR
اجرای دستور به صورت معمول اما بدون ادغام عملیات‌ها
.sp
هنگامی که این گزینه ارائه شود، عملیات‌ها همچنان مثل همیشه ایجاد می‌شوند اما در گزارش عملیات (operation log) ادغام نخواهند شد. همچنین نسخهٔ کاری به‌روزرسانی نخواهد شد.
.sp
این دستور شناسهٔ عملیات حاصل را چاپ می‌کند. می‌توانید آن را مثلاً به
.B jj \-\-at\-op
ارسال کنید تا وضعیت مخزن حاصل را بررسی کنید، یا آن را به
.B jj op restore
بدهید تا مخزن را به آن وضعیت بازیابی کند. همچنین می‌توانید شناسه را به
.B jj op integrate
بدهید تا عملیات را ادغام نماید.
.sp
توجه داشته باشید که این گزینه مانع اثرات جانبی بیرون از مخزن *نمی‌شود*. برای نمونه، دستور
.B jj git push \-\-no\-integrate\-operation
همچنان عملیات ارسال (push) را انجام خواهد داد.
.TP
\fB\-\-ignore\-immutable\fR
اجازه بازنویسی کامیت‌های تغییرناپذیر
.sp
به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌های موجود در مجموعهٔ پیکربندی‌شدهٔ کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه بررسی مذکور را غیرفعال کرده و اجازه می‌دهد هر کامیتی به جز کامیت ریشه (root commit) را بازنویسی کنید.
.sp
این گزینه فقط بر روی این بررسی تأثیر می‌گذارد و روی مجموعه بازبینی (revset)
.B immutable_heads()
یا کلمه کلیدی الگوی
.B immutable
اثری ندارد.
.TP
\fB\-\-at\-operation\fR \fI<AT_OPERATION>\fR
عملیاتی که مخزن بر مبنای آن بارگذاری شود
.sp
عملیاتی که مخزن باید بر مبنای آن بارگذاری شود. به‌طور پیش‌فرض، Jujutsu مخزن را بر مبنای جدیدترین عملیات یا در صورت وجود، بر مبنای ادغام عملیات‌های واگرا بارگذاری می‌کند.
.sp
می‌توانید از
.BI \-\-at\-op= <operation\~ID>
استفاده کنید تا ببینید مخزن در یک عملیات پیشین به چه شکلی بوده است. برای مثال، دستور
.BI "jj \-\-at\-op=" <operation\~ID> " st"
آنچه را که
.B jj st
بلافاصله پس از پایان عملیات مشخص‌شده نشان می‌داد، به شما نمایش می‌دهد.
.B \-\-at\-op=@
تقریباً همانند حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد.
.sp
از دستور
.B jj op log
برای یافتن شناسهٔ عملیات دلخواه خود استفاده کنید. هر پیشوند یکتایی از شناسهٔ عملیات کافی است.
.sp
هنگام بارگذاری مخزن در یک عملیات قبلی، نسخهٔ کاری نادیده گرفته می‌شود، درست مانند اینکه
.B \-\-ignore\-working\-copy
مشخص شده باشد.
.sp
امکان اجرای دستورات تغییردهنده وضعیت (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
بی‌صدا کردن خروجی‌های غیر اصلی دستور
.sp
برای نمونه، دستور
.B jj file list
همچنان فایل‌ها را فهرست می‌کند، اما به شما اطلاع نمی‌دهد که از نسخهٔ کاری اسنپ‌شات گرفته شده است یا نوادگان بازپایه‌ریزی شده‌اند.
.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
فایل‌های پیکربندی اضافی (قابل تکرار)
.SH "همچنین ببینید (SEE ALSO)"
.BR jj (1),
.BR jj\-gerrit (1)