'\" t
.\"     Title: git-mv
.\"    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\-MV" "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-mv \- انتقال یا تغییر نام یک فایل، دایرکتوری یا پیوند نمادین
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBmv\fR [\fB\-v\fR] [\fB\-f\fR] [\fB\-n\fR] [\fB\-k\fR] \fI<source>\fR \fI<destination>\fR
\fBgit\fR \fBmv\fR [\fB\-v\fR] [\fB\-f\fR] [\fB\-n\fR] [\fB\-k\fR] \fI<source>\fR\fB\&...\fR \fI<destination\-directory>\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
انتقال یا تغییر نام یک فایل، دایرکتوری یا پیوند نمادین (symlink)\&.
.sp
در حالت اول، \fI<source>\fR را که باید موجود بوده و فایل، پیوند نمادین یا دایرکتوری باشد، به \fI<destination>\fR تغییر نام می‌دهد\&. در حالت دوم، \fI<destination\-directory>\fR باید یک دایرکتوری موجود باشد؛ منابع مشخص‌شده به درون این دایرکتوری منتقل خواهند شد\&.
.sp
پس از اتمام موفقیت‌آمیز، ایندکس به‌روزرسانی می‌شود، اما تغییرات همچنان باید کامیت شوند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
تغییر نام یا انتقال فایل را اجبار می‌کند حتی اگر <destination> وجود داشته باشد\&.
.RE
.PP
\fB\-k\fR
.RS 4
عملیات انتقال یا تغییر نامی که منجر به بروز خطا می‌شود را نادیده می‌گیرد\&. خطا زمانی رخ می‌دهد که یک منبع نه موجود باشد و نه تحت کنترل گیت قرار داشته باشد، یا زمانی که باعث بازنویسی یک فایل موجود شود مگر اینکه
\fB\-f\fR
مشخص شده باشد\&.
.RE
.PP
\fB\-n\fR, \fB\-\-dry\-run\fR
.RS 4
هیچ کاری انجام نده؛ فقط نشان بده چه اتفاقی خواهد افتاد\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
نام فایل‌ها را هنگام انتقال گزارش می‌دهد\&.
.RE
.SH "زیرماژول‌ها (SUBMODULES)"
.sp
انتقال یک زیرماژول با استفاده از gitfile (به این معنی که با نسخه گیت 1\&.7\&.8 یا جدیدتر کلون شده باشد) فایل gitfile و تنظیمات core\&.worktree را به‌روزرسانی می‌کند تا زیرماژول در مکان جدید کار کند\&. همچنین تلاش خواهد کرد تا تنظیمات \fBsubmodule\&.\fR\fI<name>\fR\fB\&.path\fR را در فایل \fBgitmodules\fR(5) به‌روزرسانی کرده و آن فایل را استیج نماید (مگر اینکه \fB\-n\fR استفاده شده باشد)\&.
.SH "اشکالات (BUGS)"
.sp
هر بار که به‌روزرسانی پروژه والد (superproject) یک زیرماژول پرشده را منتقل می‌کند (مثلاً هنگام جابه‌جایی میان کامیت‌های قبل و بعد از انتقال)، یک نسخه چک‌اوت کهنه از زیرماژول در مکان قبلی باقی می‌ماند و یک دایرکتوری خالی در مکان جدید پدیدار می‌شود\&. برای پر کردن مجدد زیرماژول در مکان جدید، کاربر باید پس از آن دستور "git submodule update" را اجرا کند\&. حذف دایرکتوری قدیمی تنها زمانی ایمن است که از یک gitfile استفاده کند، زیرا در غیر این صورت تاریخچه زیرماژول نیز حذف خواهد شد\&. هر دو مرحله زمانی که به‌روزرسانی بازگشتی زیرماژول پیاده‌سازی شود منسوخ خواهند شد\&.
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)