'\" t
.\"     Title: patchview
.\"    Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02 Jul 2020
.\"    Manual: Man pages
.\"    Source: patchutils
.\"  Language: Persian
.\"
.TH "PATCHVIEW" "1" "02 Jul 2020" "patchutils" "Man pages"
.\" -----------------------------------------------------------------
.\" * 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)"
patchview \- نمایش فایل‌های شماره‌گذاری‌شده اصلاح‌شده توسط وصله یا پالایش آن‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpatchview\fR\ 'u
\fBpatchview\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'\fBpatchview\fR\ 'u
\fBpatchview\fR {[\-\-help] | [\-\-version] | [\-\-filter\ \&.\&.\&.] | [\-\-grep\ \&.\&.\&.]}
.SH "توضیحات (DESCRIPTION)"
.PP
اما patchview چیست؟ این ابزار پوسته‌ای (wrapper) برای filterdiff جهت استفاده همراه با فایل‌های شماره‌گذاری‌شده است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
patchview
.fi
.if n \{\
.RE
.\}
.sp
(بدون آرگومان) معادل است با: lsdiff \-\-number
.PP
.if n \{\
.RS 4
.\}
.nf
patchview \-F2\-
.fi
.if n \{\
.RE
.\}
.sp
(یا با هر آرگومان دیگری) معادل است با: filterdiff \-F2\- (یا هر آرگومانی که ارائه شود)
.PP
تعداد ۴ اسکریپت برای کار با مخازن git (شامل gitdiff،‏ gitdiffview،‏ gitshow و gitshowview) و ۲ اسکریپت برای svn (شامل svndiff و svndiffview) وجود دارد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
svndiff
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
gitdiff
.fi
.if n \{\
.RE
.\}
.sp
(بدون آرگومان) فهرستی از فایل‌های تغییریافته را نمایش می‌دهد\&.
.PP
.if n \{\
.RS 4
.\}
.nf
svndiff \-F1
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
gitdiff \-F1
.fi
.if n \{\
.RE
.\}
.sp
وصله مربوط به فایل شماره ۱ را نمایش می‌دهد\&.
.PP
.if n \{\
.RS 4
.\}
.nf
svndiffview
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
gitdiffview
.fi
.if n \{\
.RE
.\}
.sp
تمام وصله‌ها را از طریق filterdiff به vim \- \-R (در حالت فقط‌خواندنی، با امکان خروج آسان) هدایت می‌کند و وصله کامل را با رنگ‌بندی نمایش می‌دهد\&.
.PP
.if n \{\
.RS 4
.\}
.nf
svndiffview \-F2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
gitdiffview \-F2
.fi
.if n \{\
.RE
.\}
.sp
(یا هر آرگومان دیگری) وصله فایل شماره ۲ را به vim \- \-R هدایت می‌کند\&.
.PP
.if n \{\
.RS 4
.\}
.nf
gitshow
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
gitshowview
.fi
.if n \{\
.RE
.\}
.sp
این دستور مشابه gitdiff است اما به جای git diff از git show استفاده می‌کند\&.
.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
(محدوده) مشخص‌شده باشند\&. خطوط از ۱ شماره‌گذاری می‌شوند و محدوده فهرستی جداشده با کاما از اعداد یا بازه‌های
\(lqfirst\-last\(rq
است که به صورت اختیاری با اصلاح‌کننده \*(Aqx\*(Aq برای معکوس کردن کل محدوده همراه می‌شود؛ ابتدای بازه یا انتهای آن می‌تواند برای نشان دادن نامحدود بودن در آن جهت حذف شود\&.
.RE
.PP
\fB\-F\fR=\fIRANGE\fR, \fB\-\-files\fR=\fIRANGE\fR
.RS 4
تنها فایل‌های مشخص‌شده در
\fIRANGE\fR
(محدوده) را فهرست می‌کند\&. فایل‌ها از ۱ به ترتیبی که در ورودی وصله ظاهر می‌شوند شماره‌گذاری می‌شوند و محدوده فهرستی جداشده با کاما از اعداد یا بازه‌های
\(lqfirst\-last\(rq
است؛ می‌توان به صورت اختیاری پیشوند اصلاح‌کننده \*(Aqx\*(Aq را برای معکوس کردن کل محدوده به کار برد\&. ابتدای بازه یا انتهای آن می‌تواند برای نشان دادن عدم محدودیت در آن جهت حذف شود\&.
.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/
در نام فایل‌های تفاضلی Git\&. مقدار
strip
پیشوندها را هم برای تطبیق نام فایل (هنگام استفاده از گزینه‌های
\fB\-i\fR
و
\fB\-x\fR)
و هم برای خروجی نام فایل (مشابه
\fB\-\-strip\fR)
حذف می‌کند\&. مقدار
keep
(پیش‌فرض) رفتار کنونی را حفظ می‌نماید\&. این گزینه هم برای تفاضل‌های خاص Git (فایل‌های باینری، تغییر نام‌ها، تغییرات حالت دسترسی) و هم تفاضل‌های سنتی که بخشی از وصله Git هستند اعمال می‌شود\&. نکته: با مقدار
keep،
عملیات رونوشت (copy) و تغییر نام به جهت یکپارچگی با سایر عملیات Git طوری در نظر گرفته می‌شوند که گویی پیشوندهای
a/
و
b/
دارند\&. مقدار پیش‌فرض در نسخه 0.5.0 به
strip
تغییر خواهد کرد\&.
.RE
.PP
\fB\-\-git\-extended\-diffs\fR=\fIexclude|include\fR
.RS 4
کنترل می‌کند که آیا تفاضل‌های Git بدون قطعه‌های محتوایی سنتی پردازش شوند یا خیر\&. این شامل تغییر نام‌ها، رونوشت‌ها، تغییرات صرفاً مربوط به حالت مجوز و فایل‌های باینری است\&. با
exclude
(پیش‌فرض در 0.4.x)، از این تفاضل‌ها صرف‌نظر می‌شود\&. با
include
(پیش‌فرض در نسخه 0.5.0 به بعد)، این تفاضل‌ها به صورت عادی پردازش می‌شوند\&. این گزینه بر شماره‌گذاری فایل‌ها با
\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
برای نمایش افزودن، اصلاح و حذف فایل‌ها، فایل‌های خالی را به عنوان ناموجود در نظر می‌گیرد\&. برای نمونه، فایلی با نسخه قدیمی خالی و موارد اضافه در نسخه جدید، به جای تغییر (!) به عنوان افزودن فایل (+) در نظر گرفته می‌شود\&. نکته: برای grepdiff تنها شکل طولانی در دسترس است (زیرا در grepdiff گزینه
\fB\-E\fR
به معنای
\fB\-\-extended\-regexp\fR
است)\&.
.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
نام فایل وصله‌ای را که حاوی هر وصله است چاپ می‌کند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-no\-filename\fR
.RS 4
از نمایش نام فایل وصله‌ای که حاوی هر وصله است جلوگیری می‌کند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
خروجی با جزئیات کامل\&. برای اسکریپت‌های پوسته git و svn (شامل gitdiff،‏ gitdiffview،‏ gitshow،‏ gitshowview،‏ svndiff و svndiffview)، این گزینه دستور کاملی را که اجرا می‌شود نمایش می‌دهد\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
پیام کوتاه راهنمای استفاده را نمایش می‌دهد\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
شماره نسخه patchview را نمایش می‌دهد\&.
.RE
.PP
\fB\-\-filter\fR
.RS 4
به جای آن مشابه
\fBfilterdiff\fR(1)
عمل می‌کند\&.
.RE
.PP
\fB\-\-grep\fR
.RS 4
به جای آن مشابه
\fBgrepdiff\fR(1)
عمل می‌کند\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlsdiff\fR(1), \fBfilterdiff\fR(1),
\fBgrepdiff\fR(1)
.SH "مثال‌ها (EXAMPLES)"
.PP
می‌توان اسکریپت تک‌خطی زیر را با نام difftotrunk\&.sh ساخت تا تفاوت‌های دو دایرکتوری یا مخزن svn (شامل trunk و \&.) را مشاهده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
diff \&.\&./trunk \&. \-ru \-x \&.svn | patchview "$@"
.fi
.if n \{\
.RE
.\}
.PP
.if n \{\
.RS 4
.\}
.nf
\&./difftotrunk\&.sh
.fi
.if n \{\
.RE
.\}
.sp
تمام فایل‌های متفاوت و شماره آن‌ها را نمایش می‌دهد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\&./difftotrunk\&.sh \-F3,4
.fi
.if n \{\
.RE
.\}
.sp
تنها تفاوت‌های فایل‌های شماره ۳ و ۴ را نمایش می‌دهد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\&./difftotrunk\&.sh \-F3 \-#1
.fi
.if n \{\
.RE
.\}
.sp
تنها قطعه شماره ۱ از فایل شماره ۳ را نمایش می‌دهد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\&./difftotrunk\&.sh \-F3 \-#x1
.fi
.if n \{\
.RE
.\}
.sp
تفاوت‌های فایل شماره ۳ را بدون قطعه شماره ۱ نمایش می‌دهد (علامت x به معنای استثنا کردن است)\&.
.sp
.SH "نویسنده (AUTHOR)"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
نگه‌دارنده بسته
.RE