'\" t
.\"     Title: git-symbolic-ref
.\"    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: راهنمای گیت
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-SYMBOLIC\-REF" "1" "2026\-06\-29" "Git 2\&.55\&.0" "راهنمای گیت"
.\" -----------------------------------------------------------------
.\" * 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-symbolic-ref \- خواندن، تغییر و حذف ارجاع‌های نمادین
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit symbolic\-ref\fR [\-m <reason>] <name> <ref>
\fIgit symbolic\-ref\fR [\-q] [\-\-short] [\-\-no\-recurse] <name>
\fIgit symbolic\-ref\fR \-\-delete [\-q] <name>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
با دریافت یک آرگومان، بررسی می‌کند که ارجاع نمادین داده‌شده به کدام سرشاخه اشاره دارد و مسیر آن را نسبت به دایرکتوری \fB\&.git/\fR چاپ می‌کند\&. به طور معمول شما \fBHEAD\fR را به عنوان آرگومان <name> مشخص می‌کنید تا ببینید درخت کاری شما روی کدام شاخه قرار دارد\&.
.sp
با دریافت دو آرگومان، ارجاع نمادین <name> را ایجاد کرده یا به‌روزرسانی می‌کند تا به شاخه <ref> مشخص‌شده اشاره کند\&.
.sp
با دریافت \fB\-\-delete\fR و یک آرگومان اضافی، ارجاع نمادین داده‌شده را حذف می‌کند\&.
.sp
یک ارجاع نمادین، فایلی معمولی است که رشته‌ای با پیشوند \fBref:\fR \fBrefs/\fR را در خود ذخیره می‌کند\&. برای نمونه، فایل \fB\&.git/HEAD\fR شما یک فایل معمولی است که محتوای آن \fBref:\fR \fBrefs/heads/master\fR می‌باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-d, \-\-delete
.RS 4
ارجاع نمادین <name> را حذف می‌کند\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
اگر <name> یک ارجاع نمادین نبوده بلکه یک وضعیت HEAD جداشده (detached HEAD) باشد، هیچ پیام خطایی صادر نمی‌کند؛ در عوض بی‌صدا با وضعیتی غیرصفر خارج می‌شود\&.
.RE
.PP
\-\-short
.RS 4
هنگام نمایش مقدار <name> به عنوان یک ارجاع نمادین، تلاش می‌کند مقدار را کوتاه کند، برای نمونه از
\fBrefs/heads/master\fR
به
\fBmaster\fR\&.
.RE
.PP
\-\-recurse, \-\-no\-recurse
.RS 4
هنگام نمایش مقدار <name> به عنوان یک ارجاع نمادین، اگر <name> به ارجاع نمادین دیگری اشاره کند، این زنجیره از ارجاع‌های نمادین را تا جایی دنبال می‌کند که نتیجه دیگر به یک ارجاع نمادین اشاره نکند (\fB\-\-recurse\fR، که رفتار پیش‌فرض است)\&.
\fB\-\-no\-recurse\fR
تنها پس از یک مرحله ارجاع‌زدایی از ارجاع نمادین متوقف می‌شود\&.
.RE
.PP
\-m
.RS 4
وقایع‌نگار ارجاع (reflog) مربوط به <name> را با <reason> به‌روزرسانی می‌کند\&. این گزینه تنها هنگام ایجاد یا به‌روزرسانی یک ارجاع نمادین معتبر است\&.
.RE
.SH "یادداشت‌ها (NOTES)"
.sp
در گذشته، \fB\&.git/HEAD\fR یک پیوند نمادین بود که به \fBrefs/heads/master\fR اشاره می‌کرد\&. هنگامی که می‌خواستیم به شاخه دیگری برویم، دستور \fBln\fR \fB\-sf\fR \fBrefs/heads/newbranch\fR \fB\&.git/HEAD\fR را اجرا می‌کردیم، و وقتی می‌خواستیم بدانیم روی کدام شاخه هستیم، دستور \fBreadlink\fR \fB\&.git/HEAD\fR را به کار می‌بردیم\&. اما پیوندهای نمادین کاملاً سازگار و قابل‌حمل نیستند، به همین دلیل اکنون منسوخ شده‌اند و به طور پیش‌فرض از ارجاع‌های نمادین (همان‌گونه که در بالا توصیف شد) استفاده می‌شود\&.
.sp
دستور \fIgit symbolic\-ref\fR در صورتی که محتوای ارجاع نمادین به درستی چاپ شود با وضعیت 0، اگر نام درخواستی یک ارجاع نمادین نباشد با وضعیت 1، و در صورت بروز هر خطای دیگری با وضعیت 128 خارج خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-update-ref\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)