'\" t
.\"     Title: lsdiff
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 23 Jan 2009
.\"    Manual: Man pages
.\"    Source: patchutils
.\"  Language: Persian
.\"
.TH "LSDIFF" "1" "23 Jan 2009" "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)"
lsdiff \- نمایش فایل‌های تغییریافته توسط یک وصله
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBlsdiff\fR\ 'u
\fBlsdiff\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] [\-\-addoldprefix=\fIPREFIX\fR] [\-\-addnewprefix=\fIPREFIX\fR] [[\-s] | [\-\-status]] [[\-E] | [\-\-empty\-files\-as\-removed]] [[\-i\ \fIPATTERN\fR] | [\-\-include=\fIPATTERN\fR]] [[\-I\ \fIFILE\fR] | [\-\-include\-from\-file=\fIFILE\fR]] [[\-x\ \fIPATTERN\fR] | [\-\-exclude=\fIPATTERN\fR]] [[\-X\ \fIFILE\fR] | [\-\-exclude\-from\-file=\fIFILE\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'\fBlsdiff\fR\ 'u
\fBlsdiff\fR {[\-\-help] | [\-\-version] | [\-\-filter\ \&.\&.\&.] | [\-\-grep\ \&.\&.\&.]}
.SH "توضیحات (DESCRIPTION)"
.PP
فهرست کردن فایل‌هایی که توسط یک وصله (patch) تغییر یافته‌اند\&.
.PP
می‌توانید در این برنامه از diffهایی با قالب‌های unified، context و Git استفاده کنید\&. قالب Git شامل پشتیبانی از فایل‌های باینری، تغییر نام فایل‌ها، تغییرات حالت مجوز (permission mode) و سایر قابلیت‌های ویژهٔ diff در Git است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-n\fR, \fB\-\-line\-number\fR
.RS 4
نمایش شمارهٔ خطی که هر وصله از آن آغاز می‌شود\&. اگر خروجی با جزئیات بیشتر درخواست شود (با استفاده از
\fB\-nv\fR)،
هر قطعه (hunk) از هر وصله نیز فهرست می‌شود\&.
.sp
به ازای هر فایلی که تغییر یافته است، خطی تولید می‌شود شامل شمارهٔ خط آغاز وصله، به دنبال آن یک نویسهٔ
Tab،
و سپس نام فایلی که تغییر یافته است\&. اگر
\fB\-v\fR
یک بار داده شود، به دنبال هر یک از این خطوط، یک خط به ازای هر قطعه (hunk) خواهد آمد که شامل یک نویسهٔ
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
تنها قطعه‌هایی (hunks) را فهرست می‌کند که در
\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
بخش از مسیر فایل (pathname) نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-\-strip\fR=\fIn\fR
.RS 4
پیش از نمایش نام مسیر (pathname)، نخستین
\fIn\fR
بخش از آن را حذف می‌کند\&.
.RE
.PP
\fB\-\-git\-prefixes\fR=\fIstrip|keep\fR
.RS 4
نحوهٔ رفتار با پیشوندهای
a/
و
b/
در نام فایل‌های diff در Git\&. با
strip،
پیشوندها هم برای تطبیق نام فایل (هنگام استفاده از گزینه‌های
\fB\-i\fR
و
\fB\-x\fR)
و هم برای خروجی نام فایل (مشابه
\fB\-\-strip\fR)
حذف می‌شوند\&. با
keep
(پیش‌فرض)، رفتار کنونی حفظ می‌شود\&. این گزینه هم برای diffهای اختصاصی Git (فایل‌های باینری، تغییر نام‌ها، تغییرات حالت مجوز) و هم برای diffهای سنتی که بخشی از یک وصلهٔ Git هستند اعمال می‌شود\&. نکته: با
keep،
با عملیات کپی و تغییر نام به گونه‌ای رفتار می‌شود که گویی دارای پیشوندهای
a/
و
b/
هستند تا با سایر عملیات Git سازگار باشند\&. مقدار پیش‌فرض در نسخهٔ 0\&.5\&.0 به
strip
تغییر خواهد کرد\&.
.RE
.PP
\fB\-\-git\-extended\-diffs\fR=\fIexclude|include\fR
.RS 4
تعیین می‌کند که آیا diffهای Git بدون قطعه‌های محتوایی سنتی پردازش شوند یا خیر\&. این شامل تغییر نام‌ها، کپی‌ها، تغییرات صرفاً مربوط به حالت مجوز، و فایل‌های باینری می‌شود\&. با
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\-\-addoldprefix\fR=\fIPREFIX\fR
.RS 4
پیش از نمایش مسیر برای فایل‌های قدیمی،
\fIPREFIX\fR
را به عنوان پیشوند به آن‌ها اضافه می‌کند\&.
.RE
.PP
\fB\-\-addnewprefix\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\-E\fR, \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\-I\fR\fIFILE\fR, \fB\-\-include\-from\-file=\fR\fB\fIFILE\fR\fR
.RS 4
تنها فایل‌های منطبق با الگوهای فهرست‌شده در
\fIFILE\fR
را شامل می‌شود (یک الگو در هر خط)\&.
.RE
.PP
\fB\-x\fR\fIPATTERN\fR, \fB\-\-exclude=\fR\fB\fIPATTERN\fR\fR
.RS 4
فایل‌های منطبق با
\fIPATTERN\fR
را مستثنی می‌کند\&.
.RE
.PP
\fB\-X\fR\fIFILE\fR, \fB\-\-exclude\-from\-file=\fR\fB\fIFILE\fR\fR
.RS 4
فایل‌های منطبق با الگوهای فهرست‌شده در
\fIFILE\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
خروجی با جزئیات بیشتر\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش یک پیام کوتاه دربارهٔ نحوهٔ استفاده\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخهٔ lsdiff\&.
.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
\fBfilterdiff\fR(1),
\fBgrepdiff\fR(1),
\fBpatchview\fR(1)
.SH "مثال‌ها (EXAMPLES)"
.PP
برای مرتب‌سازی ترتیب فایل‌های تغییریافته در یک وصله، می‌توانید از دستور زیر استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
lsdiff patch | sort \-u | \e
  xargs \-rn1 filterdiff patch \-i
.fi
.if n \{\
.RE
.\}
.PP
برای نمایش تنها فایل‌های اضافه‌شده در یک وصله:
.sp
.if n \{\
.RS 4
.\}
.nf
lsdiff \-s patch | grep \*(Aq^+\*(Aq | \e
  cut \-c2\- | xargs \-rn1 filterdiff patch \-i
.fi
.if n \{\
.RE
.\}
.PP
برای نمایش سرآیندهای تمامی قطعه‌های (hunks) فایل:
.sp
.if n \{\
.RS 4
.\}
.nf
lsdiff \-n patch | (while read n file
  do sed \-ne "$n,$(($n+1))p" patch
done)
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
نگهدارندهٔ بسته
.RE