'\" t
.\"     Title: git-worktree
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-WORKTREE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-worktree \- مدیریت چندین درخت کاری
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBworktree\fR \fBadd\fR [\fB\-f\fR] [\fB\-\-detach\fR] [\fB\-\-checkout\fR] [\fB\-\-lock\fR [\fB\-\-reason\fR \fI<string>\fR]]
                 [\fB\-\-orphan\fR] [(\fB\-b\fR | \fB\-B\fR) \fI<new\-branch>\fR] \fI<path>\fR [\fI<commit\-ish>\fR]
\fBgit\fR \fBworktree\fR \fBlist\fR [\fB\-v\fR | \fB\-\-porcelain\fR [\fB\-z\fR]]
\fBgit\fR \fBworktree\fR \fBlock\fR [\fB\-\-reason\fR \fI<string>\fR] \fI<worktree>\fR
\fBgit\fR \fBworktree\fR \fBmove\fR \fI<worktree>\fR \fI<new\-path>\fR
\fBgit\fR \fBworktree\fR \fBprune\fR [\fB\-n\fR] [\fB\-v\fR] [\fB\-\-expire\fR \fI<expire>\fR]
\fBgit\fR \fBworktree\fR \fBremove\fR [\fB\-f\fR] \fI<worktree>\fR
\fBgit\fR \fBworktree\fR \fBrepair\fR [\fI<path>\fR\&...]
\fBgit\fR \fBworktree\fR \fBunlock\fR \fI<worktree>\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
مدیریت چندین درخت کاری متصل به یک مخزن مشترک\&.
.sp
یک مخزن گیت می‌تواند از چندین درخت کاری پشتیبانی کند و به شما اجازه می‌دهد بیش از یک شاخه را به طور هم‌زمان دریافت و بازبینی (checkout) کنید\&. با دستور
\fBgit\fR \fBworktree\fR \fBadd\fR
یک درخت کاری جدید با مخزن مرتبط می‌شود، همراه با فراداده‌های اضافی که آن درخت کاری را از بقیه درخت‌های کاری موجود در همان مخزن متمایز می‌کند\&. درخت کاری همراه با این فراداده‌ها، یک «worktree» نامیده می‌شود\&.
.sp
این درخت کاری جدید در مقایسه با «درخت کاری اصلی» (main worktree) که توسط
\fBgit-init\fR(1)
یا
\fBgit-clone\fR(1)
ایجاد شده است، «درخت کاری پیوند‌یافته» (linked worktree) نامیده می‌شود\&. یک مخزن دارای یک درخت کاری اصلی (در صورتی که یک مخزن bare نباشد) و صفر یا چند درخت کاری پیوند‌یافته است\&. هنگامی که کار شما با یک درخت کاری پیوند‌یافته به پایان رسید، آن را با دستور
\fBgit\fR \fBworktree\fR \fBremove\fR
حذف کنید\&.
.sp
در ساده‌ترین حالت، دستور
\fBgit\fR \fBworktree\fR \fBadd\fR \fI<path>\fR
به‌طور خودکار شاخه جدیدی ایجاد می‌کند که نام آن آخرین مؤلفه از
\fI<path>\fR
است؛ این قابلیت هنگامی که قصد دارید روی یک مبحث جدید کار کنید بسیار کاربردی است\&. برای نمونه، دستور
\fBgit\fR \fBworktree\fR \fBadd\fR \fB\&.\&.\fR\fB/hotfix\fR
شاخه جدید
\fBhotfix\fR
را می‌سازد و آن را در مسیر
\fB\&.\&.\fR\fB/hotfix\fR
دریافت می‌کند\&. اگر می‌خواهید در درخت کاری جدید روی یک شاخه از پیش موجود کار کنید، از
\fBgit\fR \fBworktree\fR \fBadd\fR \fI<path>\fR \fI<branch>\fR
استفاده کنید\&. از سوی دیگر، چنانچه تنها قصد دارید تغییرات آزمایشی انجام دهید یا بدون به هم ریختن روند توسعه جاری آزمایشی انجام دهید، ایجاد یک درخت کاری دورریختنی (\fIthrowaway\fR) که به هیچ شاخه‌ای وابسته نیست مناسب خواهد بود\&. به عنوان مثال، دستور
\fBgit\fR \fBworktree\fR \fBadd\fR \fB\-d\fR \fI<path>\fR
یک درخت کاری جدید با
\fBHEAD\fR
جداشده (detached) در همان کامیت شاخه جاری ایجاد می‌کند\&.
.sp
اگر یک درخت کاری بدون استفاده از دستور
\fBgit\fR \fBworktree\fR \fBremove\fR
حذف شود، فایل‌های مدیریتی مرتبط با آن که درون مخزن قرار دارند (بخش «جزئیات (DETAILS)» را در ادامه ببینید) در نهایت به صورت خودکار حذف خواهند شد (گزینه
\fBgc\&.worktreePruneExpire\fR
در
\fBgit-config\fR(1)
را ببینید)، یا می‌توانید دستور
\fBgit\fR \fBworktree\fR \fBprune\fR
را در درخت کاری اصلی یا هر درخت کاری پیوند‌یافته دیگری اجرا کنید تا فایل‌های مدیریتی منسوخ پاکسازی شوند\&.
.sp
اگر درخت کاری برای یک درخت کاری پیوند‌یافته بر روی یک دستگاه حافظه قابل‌حمل یا یک پوشه به اشتراک گذاشته شده در شبکه قرار داشته باشد که همواره متصل (mount) نیست، می‌توانید با اجرای دستور
\fBgit\fR \fBworktree\fR \fBlock\fR
از هرس شدن فایل‌های مدیریتی آن جلوگیری نمایید و به دلخواه با سوییچ
\fB\-\-reason\fR
دلیل قفل بودن درخت کاری را شرح دهید\&.
.SH "دستورها (COMMANDS)"
.PP
\fBadd\fR \fI<path>\fR [\fI<commit\-ish>\fR]
.RS 4
یک درخت کاری در
\fI<path>\fR
ایجاد کرده و
\fI<commit\-ish>\fR
را در آن دریافت و مستقر می‌کند\&. درخت کاری جدید به مخزن جاری متصل شده و همه چیز را به جز فایل‌های مختص هر درخت کاری نظیر
\fBHEAD\fR،
\fBindex\fR
و غیره به اشتراک می‌گذارد\&. برای راحتی کار،
\fI<commit\-ish>\fR
می‌تواند یک «\fB\-\fR» تنها باشد که مترادف با
\fB@\fR{\-1}
است\&.
.sp
اگر
\fI<commit\-ish>\fR
نام یک شاخه باشد (فرض کنید
\fI<branch>\fR)
و یافت نشود، و هیچ‌یک از گزینه‌های
\fB\-b\fR
یا
\fB\-B\fR
یا
\fB\-\-detach\fR
به کار نرفته باشند، اما یک شاخه ردیابی دقیقاً در یک ریموت (فرض کنید
\fI<remote>\fR)
با نام منطبق موجود باشد، معادل دستور زیر در نظر گرفته می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree add \-\-track \-b <branch> <path> <remote>/<branch>
.fi
.if n \{\
.RE
.\}
.sp
اگر شاخه در چندین ریموت وجود داشته باشد و یکی از آن‌ها با متغیر پیکربندی
\fBcheckout\&.defaultRemote\fR
نام‌گذاری شده باشد، برای ابهام‌زدایی از آن استفاده خواهد شد، حتی اگر
\fI<branch>\fR
در بین تمام ریموت‌ها یکتا نباشد\&. برای نمونه آن را روی
\fBcheckout\&.defaultRemote=origin\fR
تنظیم کنید تا چنانچه
\fI<branch>\fR
مبهم بود اما در ریموت
\fBorigin\fR
وجود داشت، همیشه شاخه‌های ریموت از آنجا دریافت شوند\&. همچنین
\fBcheckout\&.defaultRemote\fR
را در
\fBgit-config\fR(1)
ببینید\&.
.sp
اگر
\fI<commit\-ish>\fR
حذف شود و هیچ‌یک از گزینه‌های
\fB\-b\fR،
\fB\-B\fR
یا
\fB\-\-detach\fR
استفاده نشوند، برای سهولت کار، درخت کاری جدید با شاخه‌ای (فرض کنید
\fI<branch>\fR)
هم‌نام با
\fB$\fR(\fBbasename\fR
\fI<path>\fR)
مرتبط می‌شود\&. اگر
\fI<branch>\fR
وجود نداشته باشد، شاخه جدیدی بر پایه
\fBHEAD\fR
به‌طور خودکار ایجاد می‌گردد، گویی گزینه
\fB\-b\fR
\fI<branch>\fR
داده شده است\&. اگر
\fI<branch>\fR
وجود داشته باشد، در صورتی که در جای دیگری دریافت نشده باشد، در درخت کاری جدید بازبینی می‌شود؛ در غیر این صورت دستور از ایجاد درخت کاری خودداری خواهد کرد (مگر آنکه از گزینه
\fB\-\-force\fR
استفاده شود)\&.
.sp
اگر
\fI<commit\-ish>\fR
حذف شود، هیچ‌یک از گزینه‌های
\fB\-\-detach\fR
یا
\fB\-\-orphan\fR
به کار نروند، و هیچ شاخه محلی معتبری وجود نداشته باشد (یا شاخه‌های ریموت در صورتی که
\fB\-\-guess\-remote\fR
مشخص شده باشد)، برای سهولت، درخت کاری جدید به یک شاخه جدید هنوز متولدنشده با نام
\fI<branch>\fR
(بر اساس
\fB$\fR(\fBbasename\fR
\fI<path>\fR)
در صورتی که هیچ‌یک از
\fB\-b\fR
یا
\fB\-B\fR
استفاده نشده باشند) مرتبط می‌شود، گویی سوییچ
\fB\-\-orphan\fR
به دستور ارسال شده است\&. در حالتی که مخزن دارای یک ریموت باشد و
\fB\-\-guess\-remote\fR
استفاده شود، اما هیچ شاخه ریموت یا محلی وجود نداشته باشد، دستور با هشداری با خطا مواجه می‌شود و به کاربر یادآوری می‌کند ابتدا از ریموت واکشی (fetch) کند (یا با استفاده از
\fB\-f\fR/\fB\-\-force\fR
این رفتار را نادیده بگیرد)\&.
.RE
.PP
\fBlist\fR
.RS 4
جزئیات هر درخت کاری را فهرست می‌کند\&. ابتدا درخت کاری اصلی فهرست می‌شود و پس از آن هر یک از درخت‌های کاری پیوند‌یافته قرار می‌گیرند\&. جزئیات خروجی شامل مواردی نظیر bare بودن درخت کاری، بازنگری (revision) که هم‌اکنون دریافت شده است، شاخه‌ای که در حال حاضر دریافت شده (یا «detached HEAD» در صورت نبود شاخه)، عبارت «locked» در صورت قفل بودن درخت کاری، و عبارت «prunable» در صورتی که درخت کاری قابل هرس توسط دستور
\fBprune\fR
باشد، است\&.
.RE
.PP
\fBlock\fR
.RS 4
اگر یک درخت کاری بر روی یک حافظه قابل‌حمل یا یک اشتراک شبکه قرار دارد که همواره متصل نیست، آن را قفل کنید تا از هرس شدن خودکار فایل‌های مدیریتی‌اش جلوگیری شود\&. این کار همچنین مانع جابه‌جا شدن یا حذف آن می‌گردد\&. به صورت اختیاری، دلیل قفل کردن را با گزینه
\fB\-\-reason\fR
مشخص نمایید\&.
.RE
.PP
\fBmove\fR
.RS 4
یک درخت کاری را به مکان جدیدی جابه‌جا می‌کند\&. توجه داشته باشید که درخت کاری اصلی یا درخت‌های کاری پیوند‌یافته شامل زیرماژول‌ها را نمی‌توان با این دستور جابه‌جا کرد\&. (با این حال، در صورتی که درخت کاری اصلی را به‌صورت دستی جابه‌جا کنید، دستور
\fBgit\fR
\fBworktree\fR
\fBrepair\fR
می‌تواند پیوند با درخت‌های کاری متصل را دوباره برقرار سازد\&.)
.RE
.PP
\fBprune\fR
.RS 4
اطلاعات درخت کاری را در مسیر
\fB$GIT_DIR/worktrees\fR
برای درخت‌های کاری که درخت کاری فیزیکی آن‌ها وجود ندارد حذف می‌کند\&. این دستور پس از حذف دستی یک درخت کاری که دیگر نیازی به آن نیست مفید است (هرچند دفعات بعد بهتر است از «git worktree remove» برای این منظور استفاده کنید)\&. همچنین اگر یک درخت کاری را به جای دیگری
\fIمنتقل کرده‌اید\fR
و موجب شده‌اید اطلاعات درخت کاری معلق بماند، برای اتصال مجدد درخت کاری به مکان جدید آن، به «git worktree repair» مراجعه کنید\&.
.RE
.PP
\fBremove\fR
.RS 4
یک درخت کاری را حذف می‌کند\&. فقط درخت‌های کاری تمیز (بدون فایل‌های ردگیری‌نشده و بدون هیچ‌گونه تغییر در فایل‌های ردگیری‌شده) قابل حذف هستند\&. درخت‌های کاری ناپاک یا درخت‌های حاوی زیرماژول‌ها را می‌توان با سوییچ
\fB\-\-force\fR
حذف کرد\&. درخت کاری اصلی هرگز قابل حذف نیست\&.
.RE
.PP
\fBrepair\fR [\fI<path>\fR\&.\&.\&.]
.RS 4
در صورت امکان، فایل‌های مدیریتی درخت کاری را که به دلیل عوامل خارجی خراب یا قدیمی شده‌اند تعمیر می‌کند\&.
.sp
برای نمونه، اگر درخت کاری اصلی (یا مخزن bare) جابه‌جا شود، درخت‌های کاری پیوند‌یافته قادر به پیدا کردن آن نخواهند بود\&. اجرای دستور
\fBrepair\fR
در درخت کاری اصلی، اتصال را از درخت‌های کاری پیوند‌یافته به درخت کاری اصلی بازسازی می‌کند\&.
.sp
مشابهاً، اگر درخت کاریِ یک درخت کاری پیوند‌یافته بدون استفاده از دستور
\fBgit\fR
\fBworktree\fR
\fBmove\fR
جابه‌جا شود، درخت کاری اصلی (یا مخزن bare) قادر به مکان‌یابی آن نخواهد بود\&. اجرای دستور
\fBrepair\fR
درون درخت کاری تازه جابه‌جاشده، اتصال را دوباره برقرار می‌سازد\&. اگر چندین درخت کاری پیوند‌یافته جابه‌جا شده باشند، اجرای دستور
\fBrepair\fR
از هر درخت کاری با قرار دادن
\fI<path>\fR
جدید هر درخت به عنوان آرگومان، اتصال به تمام مسیرهای مشخص‌شده را مجدداً برقرار می‌کند\&.
.sp
اگر هم درخت کاری اصلی و هم درخت‌های کاری پیوند‌یافته به صورت دستی منتقل یا کپی شده باشند، اجرای
\fBrepair\fR
در درخت کاری اصلی و تعیین مسیر
\fI<path>\fR
جدید هر درخت کاری پیوند‌یافته، کلیه ارتباطات را در هر دو سو بازسازی خواهد کرد\&.
.RE
.PP
\fBunlock\fR
.RS 4
قفل یک درخت کاری را باز می‌کند و امکان هرس شدن، جابه‌جایی یا حذف آن را فراهم می‌آورد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
به‌طور پیش‌فرض،
\fBadd\fR
از ایجاد یک درخت کاری جدید خودداری می‌کند هنگامی که
\fI<commit\-ish>\fR
نام یک شاخه باشد و از پیش توسط درخت کاری دیگری دریافت شده باشد، یا اگر
\fI<path>\fR
قبلاً به درخت کاری اختصاص داده شده اما موجود نباشد (مثلاً اگر
\fI<path>\fR
به صورت دستی پاک شده باشد)\&. این گزینه این تدابیر حفاظتی را نادیده می‌گیرد\&. برای افزودن مسیر درخت کاری مفقود اما قفل‌شده، سوییچ
\fB\-\-force\fR
را دو بار مشخص کنید\&.
.sp
دستور
\fBmove\fR
از انتقال یک درخت کاری قفل‌شده خودداری می‌ورزد مگر آنکه سوییچ
\fB\-\-force\fR
دو بار مشخص شده باشد\&. اگر مقصد از قبل به درخت کاری دیگری منتسب شده اما مفقود باشد (برای نمونه اگر
\fI<new\-path>\fR
به‌صورت دستی حذف شده باشد)، آنگاه
\fB\-\-force\fR
اجازه انجام انتقال را می‌دهد؛ در صورتی که مقصد قفل باشد، سوییچ
\fB\-\-force\fR
را دو بار به کار ببرید\&.
.sp
دستور
\fBremove\fR
از پاک کردن یک درخت کاری ناپاک خودداری می‌کند مگر اینکه گزینه
\fB\-\-force\fR
استفاده شود\&. جهت حذف یک درخت کاری قفل‌شده، گزینه
\fB\-\-force\fR
را دو بار مشخص کنید\&.
.RE
.PP
\fB\-b\fR \fI<new\-branch>\fR, \fB\-B\fR \fI<new\-branch>\fR
.RS 4
همراه با دستور
\fBadd\fR،
یک شاخه جدید به نام
\fI<new\-branch>\fR
با شروع از
\fI<commit\-ish>\fR
ایجاد نموده و
\fI<new\-branch>\fR
را درون درخت کاری جدید دریافت می‌کند\&. اگر
\fI<commit\-ish>\fR
حذف شود، مقدار پیش‌فرض آن
\fBHEAD\fR
خواهد بود\&. به‌طور پیش‌فرض، گزینه
\fB\-b\fR
اگر شاخه از قبل وجود داشته باشد از ایجاد آن خودداری می‌کند\&. گزینه
\fB\-B\fR
این محافظت را لغو کرده و
\fI<new\-branch>\fR
را به
\fI<commit\-ish>\fR
بازنشانی می‌نماید\&.
.RE
.PP
\fB\-d\fR, \fB\-\-detach\fR
.RS 4
همراه با دستور
\fBadd\fR،
\fBHEAD\fR
را در درخت کاری جدید جدا می‌کند\&. بخش «DETACHED HEAD» را در
\fBgit-checkout\fR(1)
ببینید\&.
.RE
.PP
\fB\-\-checkout\fR, \fB\-\-no\-checkout\fR
.RS 4
به‌طور پیش‌فرض، دستور
\fBadd\fR
محتوای
\fI<commit\-ish>\fR
را دریافت می‌کند؛ با این وجود، می‌توان از گزینه
\fB\-\-no\-checkout\fR
جهت صرف‌نظر کردن از دریافت به منظور انجام تنظیمات سفارشی (مانند پیکربندی sparse\-checkout) استفاده کرد\&. بخش «Sparse checkout» را در
\fBgit-read-tree\fR(1)
ببینید\&.
.RE
.PP
\fB\-\-guess\-remote\fR, \fB\-\-no\-guess\-remote\fR
.RS 4
همراه با دستور
\fBworktree\fR
\fBadd\fR
\fI<path>\fR،
بدون درج
\fI<commit\-ish>\fR،
به جای ایجاد شاخه جدید بر مبنای
\fBHEAD\fR،
چنانچه شاخه ردیابی دقیقاً در یک ریموت وجود داشته باشد که با نام پایه مسیر
\fI<path>\fR
مطابقت دارد، شاخه جدید را بر پایه آن شاخه ردیابی ریموت قرار می‌دهد و شاخه ردیابی ریموت را به عنوان بالادست («upstream») شاخه جدید علامت‌گذاری می‌کند\&.
.sp
این حالت همچنین می‌تواند با استفاده از گزینه پیکربندی
\fBworktree\&.guessRemote\fR
به عنوان رفتار پیش‌فرض تنظیم شود\&.
.RE
.PP
\fB\-\-relative\-paths\fR, \fB\-\-no\-relative\-paths\fR
.RS 4
درخت‌های کاری را با استفاده از مسیرهای نسبی یا مسیرهای مطلق (پیش‌فرض) پیوند می‌دهد\&. این گزینه بر متغیر پیکربندی
\fBworktree\&.useRelativePaths\fR
ارجحیت دارد؛ به
\fBgit-config\fR(1)
مراجعه کنید\&.
.sp
همراه با دستور
\fBrepair\fR،
در صورت عدم تطابق نسبی/مطلق، فایل‌های پیوند به‌روزرسانی می‌شوند، حتی اگر پیوندها صحیح باشند\&.
.RE
.PP
\fB\-\-track\fR, \fB\-\-no\-track\fR
.RS 4
هنگام ساخت یک شاخه جدید، در صورتی که
\fI<commit\-ish>\fR
یک شاخه باشد، آن را به عنوان بالادست شاخه جدید نشانه‌گذاری می‌کند\&. اگر
\fI<commit\-ish>\fR
یک شاخه ردیابی ریموت باشد، این رفتار پیش‌فرض است\&. برای جزئیات به
\fB\-\-track\fR
در
\fBgit-branch\fR(1)
مراجعه نمایید\&.
.RE
.PP
\fB\-\-lock\fR
.RS 4
درخت کاری را پس از ایجاد در وضعیت قفل‌شده نگه می‌دارد\&. این عمل معادل اجرای دستور
\fBgit\fR
\fBworktree\fR
\fBlock\fR
پس از
\fBgit\fR
\fBworktree\fR
\fBadd\fR
است، اما بدون خطر شرایط رقابتی (race condition)\&.
.RE
.PP
\fB\-n\fR, \fB\-\-dry\-run\fR
.RS 4
همراه با دستور
\fBprune\fR،
هیچ چیزی را پاک نمی‌کند؛ صرفاً مواردی را که حذف می‌شدند گزارش می‌دهد\&.
.RE
.PP
\fB\-\-orphan\fR
.RS 4
همراه با دستور
\fBadd\fR،
درخت کاری جدید و ایندکس را خالی کرده و درخت کاری را با یک شاخه متولدنشده به نام
\fI<new\-branch>\fR
مرتبط می‌سازد\&.
.RE
.PP
\fB\-\-porcelain\fR
.RS 4
همراه با دستور
\fBlist\fR،
خروجی را در قالبی با پردازش آسان برای اسکریپت‌ها تولید می‌کند\&. این قالب در بین نسخه‌های گیت و بدون توجه به پیکربندی‌های کاربر پایدار باقی می‌ماند\&. توصیه می‌شود این سوییچ با گزینه
\fB\-z\fR
همراه شود\&. برای جزئیات به ادامه متن رجوع کنید\&.
.RE
.PP
\fB\-z\fR
.RS 4
هنگامی که گزینه
\fB\-\-porcelain\fR
همراه با
\fBlist\fR
مشخص شده باشد، پایان هر خط را به جای خط جدید با یک کاراکتر
\fINUL\fR
علامت می‌زند\&. این ویژگی تجزیه خروجی را هنگامی که مسیر درخت کاری حاوی نویسه خط جدید باشد ممکن می‌سازد\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
همراه با دستور
\fBadd\fR،
پیام‌های بازخورد را مهار و ناپیدا می‌کند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
همراه با دستور
\fBprune\fR،
تمام حذفیات را گزارش می‌دهد\&.
.sp
همراه با دستور
\fBlist\fR،
اطلاعات اضافه‌ای درباره درخت‌های کاری ارائه می‌کند (در ادامه ببینید)\&.
.RE
.PP
\fB\-\-expire\fR \fI<time>\fR
.RS 4
همراه با دستور
\fBprune\fR،
فقط در صورتی درخت‌های کاری مفقود را هرس می‌کند که قدیمی‌تر از زمان
\fI<time>\fR
باشند\&.
.sp
همراه با دستور
\fBlist\fR،
درخت‌های کاری مفقود را در صورتی که از
\fI<time>\fR
قدیمی‌تر باشند، به عنوان قابل‌هرس نشانه‌گذاری می‌کند\&.
.RE
.PP
\fB\-\-reason\fR \fI<string>\fR
.RS 4
همراه با دستور
\fBlock\fR
یا همراه با
\fBadd\fR
\fB\-\-lock\fR،
دلیلی برای قفل بودن درخت کاری ارائه می‌دهد\&.
.RE
.PP
\fI<worktree>\fR
.RS 4
درخت‌های کاری می‌توانند با مسیر، چه نسبی و چه مطلق، مشخص گردند\&.
.sp
اگر آخرین مؤلفه مسیر در مسیر درخت کاری، در میان سایر درخت‌های کاری منحصربه‌فرد باشد، می‌تواند برای شناسایی درخت کاری استفاده شود\&. به عنوان مثال اگر شما فقط دو درخت کاری در
\fB/abc/def/ghi\fR
و
\fB/abc/def/ggg\fR
دارید، آنگاه
\fBghi\fR
یا
\fBdef/ghi\fR
برای اشاره به درخت کاری اول کفایت می‌کند\&.
.RE
.SH "مراجع (REFS)"
.sp
هنگام استفاده از چندین درخت کاری، برخی مراجع (refs) بین تمام درخت‌های کاری به اشتراک گذاشته می‌شوند، اما مراجع دیگر مختص به یک درخت کاری خاص هستند\&. یک نمونه
\fBHEAD\fR
است که برای هر درخت کاری متفاوت است\&. این بخش در مورد قواعد اشتراک‌گذاری و نحوه دسترسی به مراجع یک درخت کاری از درخت کاری دیگر بحث می‌کند\&.
.sp
به‌طور کلی، همه شبه‌مراجع (pseudo refs) به ازای هر درخت کاری اختصاصی هستند و همه مراجعی که با
\fBrefs/\fR
شروع می‌شوند مشترک هستند\&. شبه‌مراجع آن‌هایی هستند که مانند
\fBHEAD\fR
مستقیماً در
\fB$GIT_DIR\fR
قرار می‌گیرند، نه درون پوشه
\fB$GIT_DIR/refs\fR\&.
با این وجود استثنائاتی وجود دارد: مراجع درون
\fBrefs/bisect\fR،
\fBrefs/worktree\fR
و
\fBrefs/rewritten\fR
به اشتراک گذاشته نمی‌شوند\&.
.sp
مراجع مختص هر درخت کاری همچنان می‌توانند از یک درخت کاری دیگر و از طریق دو مسیر خاص به نام‌های
\fBmain\-worktree\fR
و
\fBworktrees\fR
در دسترس باشند\&. اولی امکان دسترسی به مراجع اختصاصی درخت کاری اصلی را فراهم می‌آورد، در حالی که دومی به تمام درخت‌های کاری پیوند‌یافته دسترسی می‌دهد\&.
.sp
به عنوان مثال،
\fBmain\-worktree/HEAD\fR
یا
\fBmain\-worktree/refs/bisect/good\fR
به مقادیر مشابه
\fBHEAD\fR
و
\fBrefs/bisect/good\fR
درخت کاری اصلی ارجاع پیدا می‌کنند\&. به همین ترتیب،
\fBworktrees/foo/HEAD\fR
یا
\fBworktrees/bar/refs/bisect/bad\fR
مشابه
\fB$GIT_COMMON_DIR/worktrees/foo/HEAD\fR
و
\fB$GIT_COMMON_DIR/worktrees/bar/refs/bisect/bad\fR
هستند\&.
.sp
جهت دسترسی به مراجع، بهتر است مستقیماً به درون پوشه
\fB$GIT_DIR\fR
نگاه نکنید\&. در عوض از دستوراتی مانند
\fBgit-rev-parse\fR(1)
یا
\fBgit-update-ref\fR(1)
بهره ببرید که مراجع را به شیوه صحیح اداره می‌کنند\&.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
.sp
به‌طور پیش‌فرض، فایل پیکربندی (\fBconfig\fR) مخزن بین کلیه درخت‌های کاری مشترک است\&. اگر متغیرهای پیکربندی
\fBcore\&.bare\fR
یا
\fBcore\&.worktree\fR
در فایل پیکربندی عمومی وجود داشته باشند و
\fBextensions\&.worktreeConfig\fR
غیرفعال باشد، آنگاه فقط بر درخت کاری اصلی اعمال می‌گردند\&.
.sp
جهت برخورداری از پیکربندی اختصاصی برای هر درخت کاری، می‌توانید افزونه
\fBworktreeConfig\fR
را فعال کنید، برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git config extensions\&.worktreeConfig true
.fi
.if n \{\
.RE
.\}
.sp
.sp
در این حالت، پیکربندی اختصاصی در مسیری که توسط دستور
\fBgit\fR \fBrev\-parse\fR \fB\-\-git\-path\fR \fBconfig\&.worktree\fR
تعیین می‌شود قرار می‌گیرد\&. می‌توانید پیکربندی را با دستور
\fBgit\fR \fBconfig\fR \fB\-\-worktree\fR
در این فایل اضافه یا به‌روزرسانی کنید\&. نسخه‌های قدیمی‌تر گیت از دسترسی به مخازن دارای این افزونه امتناع خواهند کرد\&.
.sp
توجه داشته باشید که در این فایل، استثنای در نظر گرفته شده برای
\fBcore\&.bare\fR
و
\fBcore\&.worktree\fR
حذف می‌شود\&. چنانچه آن‌ها در
\fB$GIT_DIR/config\fR
وجود دارند، باید آن‌ها را به فایل
\fBconfig\&.worktree\fR
درخت کاری اصلی انتقال دهید\&. همچنین می‌توانید از این فرصت جهت بازبینی و انتقال سایر تنظیماتی که مایل نیستید در تمام درخت‌های کاری مشترک باشند استفاده نمایید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcore\&.worktree\fR
هرگز نباید به اشتراک گذاشته شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcore\&.bare\fR
در صورتی که مقدار آن برابر با
\fBcore\&.bare=true\fR
باشد، نباید مشترک شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcore\&.sparseCheckout\fR
نباید مشترک شود، مگر آنکه اطمینان داشته باشید همواره برای تمامی درخت‌های کاری از sparse checkout استفاده می‌کنید\&.
.RE
.sp
برای جزئیات بیشتر به مستندات
\fBextensions\&.worktreeConfig\fR
در
\fBgit-config\fR(1)
مراجعه نمایید\&.
.SH "جزئیات (DETAILS)"
.sp
هر درخت کاری پیوند‌یافته، دارای یک زیرپوشه اختصاصی در پوشه
\fB$GIT_DIR/worktrees\fR
مخزن است\&. نام این زیرپوشه اختصاصی معمولاً نام پایه مسیر درخت کاری پیوند‌یافته است و احتمالاً عددی به انتهای آن افزوده می‌شود تا یکتا گردد\&. برای مثال وقتی
\fB$GIT_DIR=/path/main/\&.git\fR
باشد، دستور
\fBgit\fR \fBworktree\fR \fBadd\fR \fB/path/other/test\-next\fR \fBnext\fR
درخت کاری پیوند‌یافته را در مسیر
\fB/path/other/test\-next\fR
می‌سازد و همچنین پوشه
\fB$GIT_DIR/worktrees/test\-next\fR
را ایجاد می‌کند (یا
\fB$GIT_DIR/worktrees/test\-next1\fR
در صورتی که
\fBtest\-next\fR
پیش‌تر گرفته شده باشد)\&.
.sp
درون یک درخت کاری پیوند‌یافته، متغیر
\fB$GIT_DIR\fR
به نحوی تنظیم می‌شود که به این پوشه خصوصی اشاره کند (مانند
\fB/path/main/\&.git/worktrees/test\-next\fR
در این مثال) و
\fB$GIT_COMMON_DIR\fR
به گونه‌ای تعیین می‌شود که به
\fB$GIT_DIR\fR
درخت کاری اصلی اشاره نماید (مانند
\fB/path/main/\&.git\fR)\&.
این تنظیمات در فایلی به نام
\fB\&.git\fR
که در بالاترین دایرکتوری درخت کاری پیوند‌یافته مستقر است اعمال می‌گردند\&.
.sp
تحلیل مسیر از طریق دستور
\fBgit\fR \fBrev\-parse\fR \fB\-\-git\-path\fR
بسته به نوع مسیر، از
\fB$GIT_DIR\fR
یا
\fB$GIT_COMMON_DIR\fR
بهره می‌گیرد\&. برای نمونه، در یک درخت کاری پیوند‌یافته، دستور
\fBgit\fR \fBrev\-parse\fR \fB\-\-git\-path\fR \fBHEAD\fR
مسیر
\fB/path/main/\&.git/worktrees/test\-next/HEAD\fR
را بازمی‌گرداند (نه مسیر
\fB/path/other/test\-next/\&.git/HEAD\fR
یا
\fB/path/main/\&.git/HEAD\fR)
در حالی که دستور
\fBgit\fR \fBrev\-parse\fR \fB\-\-git\-path\fR \fBrefs/heads/master\fR
از
\fB$GIT_COMMON_DIR\fR
استفاده نموده و
\fB/path/main/\&.git/refs/heads/master\fR
را برمی‌گرداند، چرا که مراجع در بین تمام درخت‌های کاری مشترک هستند، به جز
\fBrefs/bisect\fR،
\fBrefs/worktree\fR
و
\fBrefs/rewritten\fR\&.
.sp
برای اطلاعات بیشتر،
\fBgitrepository-layout\fR(5)
را بررسی نمایید\&. قاعده سرانگشتی این است که هرگاه نیاز به دسترسی مستقیم به داده‌های درون
\fB$GIT_DIR\fR
دارید، هیچ پیش‌فرضی درباره اینکه آیا مسیر متعلق به
\fB$GIT_DIR\fR
یا
\fB$GIT_COMMON_DIR\fR
است در نظر نگیرید\&. همواره از دستور
\fBgit\fR \fBrev\-parse\fR \fB\-\-git\-path\fR
جهت به دست آوردن مسیر نهایی استفاده کنید\&.
.sp
چنانچه یک درخت کاری پیوند‌یافته را به‌صورت دستی انتقال دهید، باید فایل
\fBgitdir\fR
موجود در دایرکتوری آن مدخل را به‌روزرسانی کنید\&. به عنوان مثال، چنانچه درخت کاری پیوند‌یافته به مسیر
\fB/newpath/test\-next\fR
جابه‌جا شود و فایل
\fB\&.git\fR
آن به
\fB/path/main/\&.git/worktrees/test\-next\fR
اشاره دارد، فایل
\fB/path/main/\&.git/worktrees/test\-next/gitdir\fR
را به‌روزرسانی نمایید تا به مسیر
\fB/newpath/test\-next\fR
اشاره کند\&. روشی حتی بهتر این است که دستور
\fBgit\fR \fBworktree\fR \fBrepair\fR
را اجرا کنید تا پیوندها به‌طور خودکار احیا شوند\&.
.sp
به منظور جلوگیری از هرس شدن یک مدخل در
\fB$GIT_DIR/worktrees\fR
(که در برخی موقعیت‌ها، نظیر ذخیره بودن درخت کاری روی یک حافظه قابل‌حمل مفید است)، از دستور
\fBgit\fR \fBworktree\fR \fBlock\fR
بهره بگیرید؛ این دستور فایلی با نام
\fBlocked\fR
در دایرکتوری آن مدخل ایجاد می‌کند\&. فایل مزبور حاوی دلیل قفل به صورت متن ساده است\&. برای نمونه، چنانچه فایل
\fB\&.git\fR
یک درخت کاری پیوند‌یافته به
\fB/path/main/\&.git/worktrees/test\-next\fR
اشاره کند، ایجاد فایل
\fB/path/main/\&.git/worktrees/test\-next/locked\fR
مانع از هرس شدن مدخل
\fBtest\-next\fR
می‌گردد\&. برای توضیحات تکمیلی به
\fBgitrepository-layout\fR(5)
مراجعه فرمایید\&.
.sp
هنگامی که افزونه
\fBextensions\&.worktreeConfig\fR
فعال باشد، فایل پیکربندی
\fB\&.git/worktrees/\fR\fI<id>\fR\fB/config\&.worktree\fR
پس از فایل
\fB\&.git/config\fR
خوانده خواهد شد\&.
.SH "قالب خروجی دستور LIST (LIST OUTPUT FORMAT)"
.sp
دستور
\fBworktree\fR \fBlist\fR
دو قالب خروجی دارد\&. قالب پیش‌فرض، جزئیات را در قالب تک‌خطی به همراه ستون‌ها ارائه می‌کند\&. برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree list
/path/to/bare\-source            (bare)
/path/to/linked\-worktree        abcd1234 [master]
/path/to/other\-linked\-worktree  1234abc  (detached HEAD)
.fi
.if n \{\
.RE
.\}
.sp
.sp
این دستور همچنین نشانه‌گذاری‌هایی را با توجه به وضعیت هر درخت کاری نمایش می‌دهد\&. این نشانه‌ها عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlocked\fR،
چنانچه درخت کاری قفل باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBprunable\fR،
چنانچه درخت کاری قابلیت هرس شدن با دستور
\fBgit\fR
\fBworktree\fR
\fBprune\fR
را داشته باشد\&.
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree list
/path/to/linked\-worktree    abcd1234 [master]
/path/to/locked\-worktree    acbd5678 (brancha) locked
/path/to/prunable\-worktree  5678abc  (detached HEAD) prunable
.fi
.if n \{\
.RE
.\}
.sp
.sp
برای این نشانه‌گذاری‌ها، ممکن است دلیلی نیز ارائه شده باشد که از طریق حالت پرگویی (verbose) قابل مشاهده است\&. در این حالت نشانه‌گذاری به خط بعدی با تورفتگی انتقال یافته و به دنبال آن جزئیات تکمیلی درج می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree list \-\-verbose
/path/to/linked\-worktree              abcd1234 [master]
/path/to/locked\-worktree\-no\-reason    abcd5678 (detached HEAD) locked
/path/to/locked\-worktree\-with\-reason  1234abcd (brancha)
        locked: worktree path is mounted on a portable device
/path/to/prunable\-worktree            5678abc1 (detached HEAD)
        prunable: gitdir file points to non\-existent location
.fi
.if n \{\
.RE
.\}
.sp
.sp
دقت فرمایید در صورتی که اطلاعات اضافی در دسترس باشد، نشانه به سطر بعدی منتقل می‌شود؛ در غیر این صورت روی همان سطرِ خودِ درخت کاری باقی خواهد ماند\&.
.SS "قالب پرسلین (Porcelain Format)"
.sp
قالب پرسلین برای هر ویژگی یک خط مستقل اختصاص می‌دهد\&. در صورتی که گزینه
\fB\-z\fR
درج گردد، خطوط به جای نویسه خط جدید با کاراکتر NUL پایان می‌یابند\&. مشخصه‌ها به صورت برچسب و مقدار که با یک فاصله تنها از یکدیگر تفکیک شده‌اند درج می‌شوند\&. ویژگی‌های بولی (نظیر
\fBbare\fR
و
\fBdetached\fR)
صرفاً به شکل برچسب آورده می‌شوند و تنها در صورتی حضور دارند که مقدار آن‌ها درست (true) باشد\&. برخی ویژگی‌ها (نظیر
\fBlocked\fR)
بسته به وجود داشتن یا نداشتن دلیل، می‌توانند فقط به صورت برچسب یا همراه با یک مقدار ظاهر شوند\&. اولین صفت یک درخت کاری همیشه
\fBworktree\fR
است و یک خط خالی نشان‌دهنده پایان رکورد است\&. برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree list \-\-porcelain
worktree /path/to/bare\-source
bare

worktree /path/to/linked\-worktree
HEAD abcd1234abcd1234abcd1234abcd1234abcd1234
branch refs/heads/master

worktree /path/to/other\-linked\-worktree
HEAD 1234abc1234abc1234abc1234abc1234abc1234a
detached

worktree /path/to/linked\-worktree\-locked\-no\-reason
HEAD 5678abc5678abc5678abc5678abc5678abc5678c
branch refs/heads/locked\-no\-reason
locked

worktree /path/to/linked\-worktree\-locked\-with\-reason
HEAD 3456def3456def3456def3456def3456def3456b
branch refs/heads/locked\-with\-reason
locked reason why is locked

worktree /path/to/linked\-worktree\-prunable
HEAD 1233def1234def1234def1234def1234def1234b
detached
prunable gitdir file points to non\-existent location
.fi
.if n \{\
.RE
.\}
.sp
.sp
مگر در مواردی که گزینه
\fB\-z\fR
استفاده شود، کاراکترهای نامتعارف در متن دلیل قفل (مانند خطوط جدید) اسکیپ می‌شوند و کل دلیل همانند متغیر پیکربندی
\fBcore\&.quotePath\fR
درون کوتیشن قرار می‌گیرد (به
\fBgit-config\fR(1)
مراجعه کنید)\&. برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree list \-\-porcelain
\&.\&.\&.
locked "reason\enwhy is locked"
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.SH "مثال‌ها (EXAMPLES)"
.sp
فرض کنید در میانه یک جلسه بازسازی کد (refactoring) هستید که ناگهان رئیستان وارد می‌شود و تقاضا می‌کند فوراً یک مشکل ضروری را برطرف کنید\&. در حالت عادی شاید از
\fBgit-stash\fR(1)
برای ذخیره موقت تغییرات خود استفاده نمایید، اما درخت کاری شما چنان نامرتب و آشفته است (با فایل‌های تازه ایجادشده، جابه‌جاشده، حذف‌شده و کارهای نیمه‌کاره پراکنده) که مایل نیستید ریسک دستکاری آن‌ها را بپذیرید\&. در عوض، می‌توانید یک درخت کاری پیوند‌یافته موقت برای اصلاح این مورد اضطراری بسازید، پس از اتمام کار آن را حذف کنید و با خیالی آسوده روند بازسازی کد قبلی‌تان را پی بگیرید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ git worktree add \-b emergency\-fix \&.\&./temp master
$ pushd \&.\&./temp
# \&.\&.\&. hack hack hack \&.\&.\&.
$ git commit \-a \-m \*(Aqemergency fix for boss\*(Aq
$ popd
$ git worktree remove \&.\&./temp
.fi
.if n \{\
.RE
.\}
.sp
.SH "پیکربندی (CONFIGURATION)"
.sp
تمامی موارد زیر در این بخش، به‌صورت گزینشی از مستندات
\fBgit-config\fR(1)
آورده شده‌اند\&. محتوا دقیقاً مطابق با آن منبع است:
.PP
\fBworktree\&.guessRemote\fR
.RS 4
چنانچه شاخه‌ای مشخص نشده باشد و هیچ‌یک از گزینه‌های
\fB\-b\fR،
\fB\-B\fR
یا
\fB\-\-detach\fR
به کار نروند، دستور
\fBgit\fR
\fBworktree\fR
\fBadd\fR
به‌طور پیش‌فرض اقدام به ساخت یک شاخه جدید از روی HEAD می‌کند\&. در صورتی که
\fBworktree\&.guessRemote\fR
روی true تنظیم شده باشد، دستور
\fBworktree\fR
\fBadd\fR
می‌کوشد یک شاخه ردیابی ریموت را بیابد که نام آن منحصراً با نام شاخه جدید یکسان باشد\&. چنانچه چنین شاخه‌ای موجود باشد، دریافت شده و به عنوان شاخه «بالادست» (upstream) شاخه جدید تنظیم می‌گردد\&. در صورتی که انطباقی حاصل نشود، به رفتار ایجاد یک شاخه جدید از روی
\fBHEAD\fR
جاری رجوع می‌کند\&.
.RE
.PP
\fBworktree\&.useRelativePaths\fR
.RS 4
درخت‌های کاری را با استفاده از مسیرهای نسبی (در حالت «\fBtrue\fR») یا مسیرهای مطلق (در حالت «\fBfalse\fR») پیوند می‌دهد\&. این ویژگی به ویژه برای شرایطی که مخزن و درخت‌های کاری ممکن است بین مسیرها یا محیط‌های گوناگون جابه‌جا شوند کاربردی است\&. مقدار پیش‌فرض «\fBfalse\fR» است\&.
.sp
دقت فرمایید که تعیین
\fBworktree\&.useRelativePaths\fR
روی «\fBtrue\fR» مستلزم فعال بودن گزینه پیکربندی
\fBextensions\&.relativeWorktrees\fR
است (به
\fBgit-config\fR(1)
رجوع کنید)، در نتیجه با نسخه‌های قدیمی‌تر Git سازگار نخواهد بود\&.
.RE
.SH "اشکالات (BUGS)"
.sp
دریافت و بررسی هم‌زمان چندگانه (multiple checkout) به‌طور کلی هنوز در فاز آزمایشی قرار دارد و پشتیبانی از زیرماژول‌ها ناقص است\&. دریافت‌های چندگانه برای یک ابرپروژه (superproject) توصیه نمی‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBgit-init\fR(1),
\fBgit-clone\fR(1),
\fBgit-config\fR(1),
\fBgit-branch\fR(1),
\fBgit-checkout\fR(1),
\fBgitrepository-layout\fR(5)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)