jj-commit(1) General Commands Manual jj-commit(1) نام (NAME) jj-commit - به‌روزرسانی توضیحات و ایجاد یک تغییر جدید در بالا [نام مستعار پیش‌فرض: ci] خلاصه دستور (SYNOPSIS) jj commit [-i|--interactive] [-R|--repository] [--ignore-working-copy] [--tool] [-m|--message] [--no-integrate-operation] [--editor] [--ignore-immutable] [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config] [--config-file] [-h|--help] [FILESETS] توضیحات (DESCRIPTION) به‌روزرسانی توضیحات و ایجاد یک تغییر جدید در بالا [نام مستعار پیش‌فرض: ci] هنگامی که بدون آرگومان‌های مسیر یا --interactive فراخوانی شود، دستور jj commit معادل اجرای jj describe و به دنبال آن jj new است. هنگام استفاده از --interactive یا آرگومان‌های مسیر، تغییرات انتخاب‌شده در کامیت فعلی باقی می‌مانند، در حالی که باقی‌ماندهٔ تغییرات به یک کامیت نسخهٔ کاری جدید در بالا منتقل می‌شوند. این فرآیند بسیار شبیه به jj split است. تفاوت‌ها شامل موارد زیر است: * دستور jj commit به‌طور پیش‌فرض تعاملی نیست (تمام تغییرات را انتخاب می‌کند). * دستور jj commit فاقد گزینهٔ -r است. این دستور همیشه روی کامیت نسخهٔ کاری (@) عمل می‌کند. * دستور jj split (بدون گزینه‌های -o/-A/-B) نشانک‌ها (bookmarks) را از تغییر قدیمی به تغییر فرزند به جلو منتقل می‌کند. دستور jj commit نشانک‌ها را به جلو منتقل نمی‌کند. * دستور jj split به شما اجازه می‌دهد تا با استفاده از -o/-A/-B تغییرات انتخاب‌شده را به مقصدی متفاوت منتقل کنید. گزینه‌ها (OPTIONS) -i, --interactive انتخاب تعاملی تغییراتی که باید در کامیت فعلی گنجانده شوند --tool مشخص کردن ویرایشگر تفاوت (diff editor) مورد استفاده (به معنای --interactive است) -m, --message توضیحات تغییر جهت استفاده (ویرایشگر باز نشود) --editor باز کردن یک ویرایشگر برای ویرایش توضیحات تغییر هنگام استفاده از --message ویرایشگر را به اجبار باز می‌کند تا امکان ویرایش پیام پس از آن فراهم شود. -h, --help چاپ راهنما (مشاهده خلاصه با '-h') [FILESETS] قرار دادن این مسیرها در کامیت فعلی گزینه‌های عمومی (GLOBAL OPTIONS) -R, --repository مسیر مخزنی که باید روی آن کار شود به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در مسیرهای والد دایرکتوری کاری فعلی می‌گردد. --ignore-working-copy از نسخهٔ کاری اسنپ‌شات گرفته نشود و به‌روزرسانی نیز نگردد به‌طور پیش‌فرض، Jujutsu در ابتدای هر دستور از نسخهٔ کاری اسنپ‌شات می‌گیرد. همچنین در پایان دستور، اگر دستور کامیت نسخهٔ کاری (`@`) را تغییر داده باشد، نسخهٔ کاری به‌روزرسانی می‌شود. اگر می‌خواهید از اسنپ‌شات گرفتن از نسخهٔ کاری صرف‌نظر کنید و در عوض یک کامیت نسخهٔ کاری احتمالاً قدیمی را مشاهده کنید، می‌توانید از --ignore-working-copy استفاده کنید. این مورد می‌تواند برای مثال در خط فرمان (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 اجازه بازنویسی کامیت‌های تغییرناپذیر به‌طور پیش‌فرض، Jujutsu از بازنویسی کامیت‌های موجود در مجموعهٔ پیکربندی‌شدهٔ کامیت‌های تغییرناپذیر جلوگیری می‌کند. این گزینه بررسی مذکور را غیرفعال کرده و اجازه می‌دهد هر کامیتی به جز کامیت ریشه (root commit) را بازنویسی کنید. این گزینه فقط بر روی این بررسی تأثیر می‌گذارد و روی مجموعه بازبینی (revset) immutable_heads() یا کلمه کلیدی الگوی immutable اثری ندارد. --at-operation عملیاتی که مخزن بر مبنای آن بارگذاری شود عملیاتی که مخزن باید بر مبنای آن بارگذاری شود. به‌طور پیش‌فرض، Jujutsu مخزن را بر مبنای جدیدترین عملیات یا در صورت وجود، بر مبنای ادغام عملیات‌های واگرا بارگذاری می‌کند. می‌توانید از --at-op= استفاده کنید تا ببینید مخزن در یک عملیات پیشین به چه شکلی بوده است. برای مثال، دستور jj --at-op= st آنچه را که jj st بلافاصله پس از پایان عملیات مشخص‌شده نشان می‌داد، به شما نمایش می‌دهد. --at-op=@ تقریباً همانند حالت پیش‌فرض است، با این تفاوت که عملیات‌های واگرا هرگز ادغام نخواهند شد. از دستور jj op log برای یافتن شناسهٔ عملیات دلخواه خود استفاده کنید. هر پیشوند یکتایی از شناسهٔ عملیات کافی است. هنگام بارگذاری مخزن در یک عملیات قبلی، نسخهٔ کاری نادیده گرفته می‌شود، درست مانند اینکه --ignore-working-copy مشخص شده باشد. امکان اجرای دستورات تغییردهنده وضعیت (mutating) هنگام بارگذاری مخزن در یک عملیات قبلی وجود دارد. انجام این کار معادل اجرای دستورات همزمان با شروع از عملیات پیشین است. به‌ندرت دلیلی برای انجام این کار وجود دارد، اما امکان‌پذیر است. --debug فعال‌سازی گزارش‌گیری اشکال‌زدایی (debug logging) --color زمان رنگی‌سازی خروجی مقادیر مجاز: • always • never • debug • auto --quiet بی‌صدا کردن خروجی‌های غیر اصلی دستور برای نمونه، دستور jj file list همچنان فایل‌ها را فهرست می‌کند، اما به شما اطلاع نمی‌دهد که از نسخهٔ کاری اسنپ‌شات گرفته شده است یا نوادگان بازپایه‌ریزی (rebase) شده‌اند. هشدارها و خطاها همچنان چاپ خواهند شد. --no-pager غیرفعال کردن صفحه‌بندی (pager) --config گزینه‌های پیکربندی اضافی (قابل تکرار) نام باید به صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به عنوان یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای در هیچ‌یک از ساختارهای TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان علامت نقل‌قول را حذف کرد. --config-file فایل‌های پیکربندی اضافی (قابل تکرار) همچنین ببینید (SEE ALSO) jj(1) commit jj-commit(1)