jj-file-track(1)            General Commands Manual           jj-file-track(1)

نام (NAME)
       jj-file-track - شروع ردیابی مسیرهای مشخص‌شده در رونوشت کاری

خلاصه دستور (SYNOPSIS)
       jj file track [--include-ignored] [-R|--repository]
       [--ignore-working-copy] [--no-integrate-operation] [--ignore-immutable]
       [--at-operation] [--debug] [--color] [--quiet] [--no-pager] [--config]
       [--config-file] [-h|--help] <FILESETS>

توضیحات (DESCRIPTION)
       شروع ردیابی مسیرهای مشخص‌شده در رونوشت کاری

       بدون آرگومان، تمام مسیرهایی که نادیده گرفته نشده‌اند ردیابی خواهند شد.

       به‌طور پیش‌فرض، فایل‌های جدید در رونوشت کاری به‌طور خودکار ردیابی می‌شوند،
       بنابراین این دستور اثری ندارد. می‌توانید با تنظیم snapshot.auto-track
       (برای مثال به "none()" یا "glob:**/*.rs") تعیین کنید که کدام مسیرها
       به‌طور خودکار ردیابی شوند. فایل‌هایی که با الگو مطابقت ندارند را می‌توان
       به‌صورت دستی با استفاده از این دستور ردیابی کرد. الگوی پیش‌فرض all() است.

گزینه‌ها (OPTIONS)
       --include-ignored
              ردیابی مسیرها حتی اگر نادیده گرفته شده یا بیش از حد بزرگ باشند

              به‌طور پیش‌فرض، jj file track فایل‌هایی را که توسط .gitignore
              نادیده گرفته شده‌اند یا از حداکثر اندازهٔ مجاز فایل فراتر می‌روند
              ردیابی نخواهد کرد. این پرچم آن محدودیت‌ها را لغو کرده و مسیرهای
              مشخص‌شده را به‌طور صریح ردیابی می‌کند.

       -h, --help
              چاپ راهنما (مشاهده خلاصه با '-h')

       <FILESETS>
              مسیرها برای ردیابی

گزینه‌های عمومی (GLOBAL OPTIONS)
       -R, --repository <REPOSITORY>
              مسیر مخزنی که عملیات روی آن انجام می‌شود

              به‌طور پیش‌فرض، Jujutsu به دنبال نزدیک‌ترین دایرکتوری .jj/ در اجداد
              دایرکتوری کاری فعلی می‌گردد.

       --ignore-working-copy
              از رونوشت کاری (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) را بازنویسی کنید.

              این گزینه تنها بر این بررسی تأثیر می‌گذارد و روی مجموعه بازنگری
              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 همچنان فایل‌ها را فهرست می‌کند، اما به
              شما اطلاع نمی‌دهد که آیا از رونوشت کاری اسنپ‌شات گرفته شده یا
              نوادگان بازپایه‌ریزی شده‌اند یا خیر.

              هشدارها و خطاها همچنان چاپ خواهند شد.

       --no-pager
              غیرفعال کردن صفحه‌بندی‌کننده (pager)

       --config <NAME=VALUE>
              گزینه‌های پیکربندی اضافی (قابلیت تکرار دارد)

              نام باید به‌صورت کلیدهای نقطه‌دار TOML مشخص شود. مقدار باید به‌صورت
              یک عبارت TOML تعیین شود. در صورتی که مقدار رشته‌ای درون ساختارهای
              TOML (مانند نشانه‌گذاری آرایه) محصور نشده باشد، می‌توان از
              علامت‌های نقل‌قول صرف‌نظر کرد.

       --config-file <PATH>
              فایل‌های پیکربندی اضافی (قابلیت تکرار دارد)

همچنین ببینید (SEE ALSO)
       jj(1), jj-file(1), jj-file-untrack(1)

                                    track                     jj-file-track(1)