'\" t
.\"     Title: gitshow
.\"    Author: Tim Waugh <twaugh@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02 Jul 2020
.\"    Manual: Man pages
.\"    Source: patchutils
.\"  Language: Persian
.\"
.TH "GITSHOW" "1" "02 Jul 2020" "patchutils" "راهنمای کاربر"
.\" -----------------------------------------------------------------
.\" * 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)"
gitshow \- نمایش فایل‌های تغییریافته و کامیت‌های خاص گیت
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgitshow\fR\ 'u
\fBgitshow\fR [[\-n] | [\-\-line\-number]] [[\-p\ \fIn\fR] | [\-\-strip\-match=\fIn\fR]] [\-\-strip=\fIn\fR] [\-\-git\-prefixes=\fIstrip|keep\fR] [\-\-git\-extended\-diffs=\fIexclude|include\fR] [\-\-addprefix=\fIPREFIX\fR] [[\-s] | [\-\-status]] [[\-E] | [\-\-empty\-files\-as\-removed]] [[\-i\ \fIPATTERN\fR] | [\-\-include=\fIPATTERN\fR]] [[\-x\ \fIPATTERN\fR] | [\-\-exclude=\fIPATTERN\fR]] [[\-z] | [\-\-decompress]] [[\-#\ \fIRANGE\fR] | [\-\-hunks=\fIRANGE\fR]] [\-\-lines=\fIRANGE\fR] [[\-F\fIRANGE\fR] | [\-\-files=\fIRANGE\fR]] [[\-H] | [\-\-with\-filename]] [[\-h] | [\-\-no\-filename]] [[\-v] | [\-\-verbose]...] [\fIfile\fR...]
.HP \w'\fBgitshow\fR\ 'u
\fBgitshow\fR {[\-\-help] | [\-\-version] | [\-\-filter\ \&.\&.\&.] | [\-\-grep\ \&.\&.\&.]}
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.B gitshow
یک ابزار پوششی برای
.B filterdiff
جهت استفاده با فایل‌های شماره‌گذاری‌شده در مخازن گیت است. این دستور مشابه
.B gitdiff
عمل می‌کند اما به جای
.BR "git diff" ،
از
.B git show
استفاده می‌نماید.
.PP
اجرای دستور بدون آرگومان:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshow
.fi
.if n \{\
.RE
.\}
.sp
فهرستی از تمام فایل‌های تغییریافته در کامیت را همراه با شماره آن‌ها نمایش می‌دهد (معادل با
.BR "lsdiff \-\-number" ).
.PP
با تعیین شماره فایل، می‌توان وصله مربوط به آن فایل خاص را مشاهده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshow \-F1
.fi
.if n \{\
.RE
.\}
.sp
وصله (patch) مربوط به فایل شماره ۱ را نمایش می‌دهد.
.PP
دستورهای مرتبط در این مجموعه شامل
.BR gitdiff ،
.BR gitdiffview ،
.B gitshow
و
.B gitshowview
برای مخازن گیت، و همچنین
.B svndiff
و
.B svndiffview
برای مخازن اس‌وی‌ان هستند.
.PP
دستور
.B gitshowview
تغییرات را از طریق
.B filterdiff
به ویرایشگر
.B vim \- \-R
(در حالت فقط‌خواندنی) هدایت می‌کند تا مشاهده وصله‌ها به‌صورت رنگی و آسان باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshowview \-F2
.fi
.if n \{\
.RE
.\}
.sp
وصله مربوط به فایل شماره ۲ را برای بررسی در vim نمایش می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-n\fR, \fB\-\-line\-number\fR
.RS 4
نمایش شماره خطی که هر وصله از آن آغاز می‌شود. در صورت درخواست خروجی با جزئیات بیشتر (با استفاده از
\fB\-nv\fR)،
هر قطعه (hunk) از هر وصله نیز فهرست می‌شود.
.sp
به ازای هر فایل تغییریافته، خطی شامل شماره خط شروع وصله، سپس یک نویسه
Tab
و به دنبال آن نام فایل تغییریافته تولید می‌شود. اگر
\fB\-v\fR
یک‌بار داده شود، پس از هر یک از این خطوط، یک خط برای هر قطعه شامل نویسه
Tab،
شماره خط شروع قطعه، نویسه
Tab
دیگر، رشته
\(lqHunk #\(rq
و شماره قطعه (شروع از ۱) درج می‌شود.
.sp
اگر
\fB\-v\fR
دو بار همراه با
\fB\-n\fR
داده شود (یعنی
\fB\-nvv\fR)،
قالب خروجی کمی متفاوت است: متن توصیفی سطح قطعه پس از هر شماره قطعه نمایش داده می‌شود و گزینه
\fB\-\-number\-files\fR
فعال می‌گردد.
.RE
.PP
\fB\-N\fR, \fB\-\-number\-files\fR
.RS 4
شماره فایل‌ها با شروع از ۱ پیش از هر نام فایل فهرست می‌شوند.
.RE
.PP
\fB\-#\fR\fIRANGE\fR, \fB\-\-hunks\fR=\fIRANGE\fR
.RS 4
فقط قطعات موجود در
\fIRANGE\fR
مشخص‌شده را فهرست می‌کند. شماره‌گذاری قطعات از ۱ آغاز می‌شود و محدوده به‌صورت فهرستی از اعداد جداشده با کاما یا بازه‌های
\(lqfirst\-last\(rq
است؛ همچنین می‌تواند با پیشوند اصلاح‌کننده \*(Aqx\*(Aq برای معکوس کردن کل محدوده همراه باشد. مقدار ابتدا یا انتهای بازه را می‌توان برای نشان دادن نامحدود بودن در آن جهت حذف کرد.
.RE
.PP
\fB\-\-lines\fR=\fIRANGE\fR
.RS 4
فقط قطعاتی را فهرست می‌کند که شامل خطوطی از فایل اصلی در
\fIRANGE\fR
مشخص‌شده باشند. شماره‌گذاری خطوط از ۱ آغاز می‌شود و ساختار بازه مانند گزینه بالا است.
.RE
.PP
\fB\-F\fR=\fIRANGE\fR, \fB\-\-files\fR=\fIRANGE\fR
.RS 4
فقط فایل‌های مشخص‌شده در
\fIRANGE\fR
را فهرست می‌کند. فایل‌ها بر اساس ترتیب حضور در ورودی وصله از ۱ شماره‌گذاری می‌شوند و ساختار محدوده مشابه گزینه‌های بالا است.
.RE
.PP
\fB\-p\fR\fIn\fR, \fB\-\-strip\-match=\fR\fB\fIn\fR\fR
.RS 4
هنگام تطبیق،
\fIn\fR
بخش ابتدایی از مسیر فایل را نادیده می‌گیرد.
.RE
.PP
\fB\-\-strip\fR=\fIn\fR
.RS 4
پیش از نمایش مسیر،
\fIn\fR
بخش ابتدایی از مسیر فایل را حذف می‌کند.
.RE
.PP
\fB\-\-git\-prefixes\fR=\fIstrip|keep\fR
.RS 4
نحوه مدیریت پیشوندهای
a/
و
b/
در نام فایل‌های diff گیت. با مقدار
strip،
این پیشوندها هم برای تطبیق نام فایل (هنگام استفاده از گزینه‌های
\fB\-i\fR
و
\fB\-x\fR)
و هم برای خروجی نام فایل (مشابه
\fB\-\-strip\fR)
حذف می‌شوند. با مقدار
keep
(پیش‌فرض)، رفتار موجود حفظ می‌شود. این گزینه هم برای diffهای اختصاصی گیت (فایل‌های باینری، تغییر نام‌ها، تغییر دسترسی‌ها) و هم برای diffهای سنتی که بخشی از وصله گیت هستند اعمال می‌شود. توجه: با مقدار
keep،
عملیات کپی و تغییر نام برای سازگاری با سایر عملیات گیت طوری رفتار می‌شوند که گویی دارای پیشوندهای
a/
و
b/
هستند. پیش‌فرض در نسخه 0.5.0 به
strip
تغییر خواهد کرد.
.RE
.PP
\fB\-\-git\-extended\-diffs\fR=\fIexclude|include\fR
.RS 4
مشخص می‌کند که آیا diffهای گیت بدون قطعات محتوایی سنتی پردازش شوند یا خیر. این شامل تغییر نام، کپی، تغییر دسترسی فایل‌ها و فایل‌های باینری است. با مقدار
exclude
(پیش‌فرض در 0.4.x)، این diffها نادیده گرفته می‌شوند. با مقدار
include
(پیش‌فرض در 0.5.0+)، این diffها به‌طور عادی پردازش می‌شوند. این گزینه بر شماره‌گذاری فایل‌ها با
\fB\-N\fR
و فیلتر کردن فایل‌ها با
\fB\-F\fR
تأثیر می‌گذارد.
.RE
.PP
\fB\-\-addprefix\fR=\fIPREFIX\fR
.RS 4
پیش از نمایش مسیر،
\fIPREFIX\fR
را به ابتدای مسیر فایل اضافه می‌کند.
.RE
.PP
\fB\-s\fR, \fB\-\-status\fR
.RS 4
نمایش وضعیت افزودن، ویرایش و حذف فایل‌ها. فایل افزوده با
\(lq+\(rq،
فایل حذف‌شده با
\(lq\-\(rq
و فایل ویرایش‌شده با
\(lq!\(rq
مشخص می‌شود.
.RE
.PP
\fB\-\-empty\-files\-as\-absent\fR, \fB\-\-empty\-files\-as\-removed\fR
.RS 4
فایل‌های خالی را برای نمایش افزودن، ویرایش و حذف فایل‌ها به عنوان ناموجود در نظر می‌گیرد. برای مثال، فایلی با نسخه قدیمی خالی و افزوده‌ها در نسخه جدید، به عنوان فایل افزوده (+) در نظر گرفته می‌شود تا فایل ویرایش‌شده (!).
.RE
.PP
\fB\-i\fR\fIPATTERN\fR, \fB\-\-include=\fR\fB\fIPATTERN\fR\fR
.RS 4
فقط فایل‌هایی را که با
\fIPATTERN\fR
تطبیق دارند شامل می‌شود.
.RE
.PP
\fB\-x\fR\fIPATTERN\fR, \fB\-\-exclude=\fR\fB\fIPATTERN\fR\fR
.RS 4
فایل‌هایی را که با
\fIPATTERN\fR
تطبیق دارند مستثنی می‌کند.
.RE
.PP
\fB\-z\fR, \fB\-\-decompress\fR
.RS 4
فایل‌های دارای پسوند gz. و bz2. را از حالت فشرده خارج می‌کند.
.RE
.PP
\fB\-H\fR, \fB\-\-with\-filename\fR
.RS 4
نام فایل وصله حاوی هر patch را چاپ می‌کند.
.RE
.PP
\fB\-h\fR, \fB\-\-no\-filename\fR
.RS 4
از چاپ نام فایل وصله حاوی هر patch خودداری می‌کند.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
خروجی با جزئیات کامل. برای اسکریپت‌های پوششی git و svn، این گزینه دستور کاملی را که در حال اجرا است نمایش می‌دهد.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش پیام کوتاه راهنمای استفاده از دستور.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخه ابزار.
.RE
.PP
\fB\-\-filter\fR
.RS 4
عملکرد مشابه
\fBfilterdiff\fR(1).
.RE
.PP
\fB\-\-grep\fR
.RS 4
عملکرد مشابه
\fBgrepdiff\fR(1).
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
نمایش تمام فایل‌های تغییریافته در کامیت همراه با شماره آن‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshow
.fi
.if n \{\
.RE
.\}
.sp
.PP
نمایش تغییرات و وصله مربوط به فایل شماره ۳:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshow \-F3
.fi
.if n \{\
.RE
.\}
.sp
.PP
نمایش تنها قطعه شماره ۱ از فایل شماره ۳:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshow \-F3 \-#1
.fi
.if n \{\
.RE
.\}
.sp
.PP
مشاهده تغییرات فایل شماره ۲ در یک کامیت با استفاده از vim در حالت فقط‌خواندنی:
.sp
.if n \{\
.RS 4
.\}
.nf
gitshowview \-F2
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpatchview\fR(1),
\fBlsdiff\fR(1),
\fBfilterdiff\fR(1),
\fBgrepdiff\fR(1),
\fBgit\-show\fR(1)
.SH "نویسنده (AUTHOR)"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
نگه‌دارنده بسته
.RE