'\" t
.\"     Title: git-name-rev
.\"    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: Persian
.\"
.TH "GIT\-NAME\-REV" "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-name-rev \- یافتن نام‌های قابل فهم برای ارجاعات مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit name\-rev\fR [\-\-tags] [\-\-refs=<pattern>]
               ( \-\-all | \-\-annotate\-stdin | <commit\-ish>\&... )
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
نام‌های نمادین قابل‌فهم برای انسان را برای بازنگری‌های ارائه‌شده در هر قالبی که توسط \fIgit rev\-parse\fR قابل تجزیه باشد، پیدا می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-tags
.RS 4
به جای استفاده از نام شاخه‌ها، فقط از تگ‌ها برای نام‌گذاری کامیت‌ها استفاده می‌کند\&.
.RE
.PP
\-\-refs=<pattern>
.RS 4
تنها از ارجاعاتی (refs) استفاده می‌کند که نام آن‌ها با الگوی پوسته داده‌شده مطابقت داشته باشد\&. این الگو می‌تواند نام یک شاخه، نام یک تگ یا یک نام ارجاع کاملاً واجد شرایط (fully qualified) باشد\&. اگر چند بار مشخص شود، از ارجاعاتی استفاده می‌کند که نام آن‌ها با هر یک از الگوهای پوسته ارائه‌شده همخوانی داشته باشد\&. برای پاک کردن تمام الگوهای ارجاع قبلی، از
\fB\-\-no\-refs\fR
استفاده کنید\&.
.RE
.PP
\-\-exclude=<pattern>
.RS 4
از هیچ ارجاعی که نام آن با الگوی پوسته داده‌شده مطابقت داشته باشد، استفاده نمی‌کند\&. الگو می‌تواند نام یک شاخه، نام یک تگ یا نام ارجاع کاملاً واجد شرایط باشد\&. در صورت مشخص شدن چندباره، ارجاعی که با هر یک از الگوهای ارائه‌شده مطابقت داشته باشد مستثنی خواهد شد\&. هنگام استفاده هم‌زمان با \-\-refs، یک ارجاع تنها زمانی به عنوان منطبق در نظر گرفته می‌شود که حداقل با یکی از الگوهای \-\-refs مطابقت داشته و با هیچ‌یک از الگوهای \-\-exclude تطابق نداشته باشد\&. برای پاک کردن فهرست الگوهای استثنا، از
\fB\-\-no\-exclude\fR
استفاده کنید\&.
.RE
.PP
\-\-all
.RS 4
تمام کامیت‌های قابل دسترسی از همه ارجاعات را فهرست می‌کند\&.
.RE
.PP
\-\-annotate\-stdin
.RS 4
ورودی استاندارد (stdin) را با جایگزین کردن تمام مقادیر هگزادسیمال ۴۰ نویسه‌ای SHA\-1 (مثلاً $hex) با "$hex ($rev_name)" دگرگون می‌کند\&. هنگام استفاده همراه با \-\-name\-only، مقدار "$rev_name" را بدون ذکر $hex جایگزین می‌کند\&. این گزینه در نسخه‌های قدیمی‌تر گیت
\fB\-\-stdin\fR
نامیده می‌شد\&.
.sp
به عنوان مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ cat sample\&.txt

An abbreviated revision 2ae0a9cb82 will not be substituted\&.
The full name after substitution is 2ae0a9cb8298185a94e5998086f380a355dd8907,
while its tree object is 70d105cc79e63b81cfdcb08a15297c23e60b07ad

$ git name\-rev \-\-annotate\-stdin <sample\&.txt

An abbreviated revision 2ae0a9cb82 will not be substituted\&.
The full name after substitution is 2ae0a9cb8298185a94e5998086f380a355dd8907 (master),
while its tree object is 70d105cc79e63b81cfdcb08a15297c23e60b07ad

$ git name\-rev \-\-name\-only \-\-annotate\-stdin <sample\&.txt

An abbreviated revision 2ae0a9cb82 will not be substituted\&.
The full name after substitution is master,
while its tree object is 70d105cc79e63b81cfdcb08a15297c23e60b07ad
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\-\-name\-only
.RS 4
به جای چاپ هر دو مقدار SHA\-1 و نام، تنها نام را چاپ می‌کند\&. اگر همراه با \-\-tags مشخص شود، پیشوند معمول تگ یعنی "tags/" نیز از نام حذف می‌شود، که خروجی را بیشتر به خروجی
\fBgit\-describe\fR
نزدیک می‌کند\&.
.RE
.PP
\-\-no\-undefined
.RS 4
هنگامی که یک ارجاع تعریف‌نشده باشد، به جای چاپ کردن
\fBundefined\fR،
با کد خطای غیرصفر (\fB!= 0\fR) خاتمه می‌یابد\&.
.RE
.PP
\-\-always
.RS 4
شیء کامیت را با اختصار یکتا به عنوان راه‌حل جایگزین (fallback) نمایش می‌دهد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
با داشتن یک کامیت، موقعیت آن را نسبت به ارجاعات محلی پیدا کنید\&. فرض کنید فردی درباره کامیت فوق‌العاده 33db5f4d9027a10e477ccf054b2c1ab94f74c85a به شما پیام داده است\&. البته شما کامیت را بررسی می‌کنید، اما این کار فقط به شما می‌گوید چه چیزی رخ داده، نه زمینه و بستر آن (context)\&.
.sp
دستور \fIgit name\-rev\fR را وارد کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
% git name\-rev 33db5f4d9027a10e477ccf054b2c1ab94f74c85a
33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0\&.99~940
.fi
.if n \{\
.RE
.\}
.sp
.sp
اکنون آگاه‌تر شده‌اید، زیرا می‌دانید که این رخداد ۹۴۰ بازنگری پیش از v0\&.99 روی داده است\&.
.sp
کار جالب دیگری که می‌توانید انجام دهید:
.sp
.if n \{\
.RS 4
.\}
.nf
% git log | git name\-rev \-\-annotate\-stdin
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit\fR(1), \fBgit\-describe\fR(1), \fBgit\-rev\-parse\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)