'\" t
.\"     Title: colordiff
.\"    Author: Dave Ewart
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 01/12/2026
.\"    Manual: User Commands
.\"    Source: colordiff
.\"  Language: English
.\"
.TH "COLORDIFF" "1" "01/12/2026" "colordiff" "User Commands"
.\" -----------------------------------------------------------------
.\" * 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)"
colordiff \- ابزاری برای رنگ‌آمیزی خروجی \fBdiff\fR
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBcolordiff\fR\ 'u
\fBcolordiff\fR [\fIdiff\ options\fR] [\fIcolordiff\ options\fR] {\fIfile1\fR} {\fIfile2\fR}
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
colordiff
پوششی (wrapper) برای
\fBdiff\fR
است و همان خروجی
\fBdiff\fR
را تولید می‌کند، با این تفاوت که دارای برجسته‌سازی نحوی رنگی در خط فرمان است تا خوانایی را بهبود ببخشد\&. خروجی آن شبیه به نحوه نمایش یک وصله (patch) تولیدشده توسط
\fBdiff\fR
در
Vim
یا
Emacs
با فعال بودن گزینه‌های برجسته‌سازی نحوی مناسب است\&. طرح‌های رنگی را می‌توان از یک فایل پیکربندی مرکزی یا از فایل محلی کاربر در
~/\&.colordiffrc
خواند\&.
.PP
برنامه
colordiff
از رنگ‌های ANSI استفاده می‌کند و بنابراین تنها زمانی کار خواهد کرد که رنگ‌های ANSI قابل استفاده باشند \- نمونه‌های متداول آن سامانه‌های xterm و Eterm و همچنین نشست‌های کنسول هستند\&.
.PP
برنامه
colordiff
روی توزیع‌های مختلفی از Linux و تحت OpenBSD آزمایش شده است، اما به‌طور کلی باید روی سایر سیستم‌ها نیز قابل‌حمل (portable) باشد\&.
.SH "نحوه استفاده (USAGE)"
.PP
از
colordiff
در هر جایی که معمولاً از
\fBdiff\fR
استفاده می‌کنید بهره ببرید، یا در عوض، خروجی را با لوله (pipe) به
colordiff
ارسال کنید:
.PP
برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ colordiff file1 file2
$ diff \-u file1 file2 | colordiff
.fi
.if n \{\
.RE
.\}
.PP
می‌توانید با استفاده از گزینه \*(Aq\-R\*(Aq خروجی را به دستور \*(Aqless\*(Aq لوله‌کشی (pipe) کنید (برخی سیستم‌ها یا انواع ترمینال ممکن است با استفاده از \*(Aq\-r\*(Aq به جای آن نتیجه بهتری بگیرند)، که توالی‌های گریز رنگی را حفظ می‌کند؛ در غیر این صورت، این توالی‌ها نادرست نمایش داده شده یا توسط \*(Aqless\*(Aq نادیده گرفته می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
$ diff \-u file1 file2 | colordiff | less \-R
.fi
.if n \{\
.RE
.\}
.PP
اگر می‌خواهید توالی‌های گریز رنگی را اجباراً غیرفعال کنید (برای مثال هنگام ارسال خروجی با لوله به
\fBpatch\fR)،
می‌توانید از گزینه \*(Aq\-\-color=no\*(Aq برای انجام این کار بهره ببرید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ diff \-u file1 file2 | colordiff \-\-color=no | patch \-p0 \-d another\-working\-dir
.fi
.if n \{\
.RE
.\}
.PP
اگر
\fBwdiff\fR
را نصب دارید، colordiff متن‌های اضافه‌شده و حذف‌شده را به‌درستی رنگ‌آمیزی می‌کند، به شرطی که گزینه \*(Aq\-n\*(Aq به
\fBwdiff\fR
داده شده باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ wdiff \-n file1 file2 | colordiff
.fi
.if n \{\
.RE
.\}
.PP
ممکن است برایتان سودمند باشد که
\fBdiff\fR
را طوری تنظیم کنید که به‌طور خودکار
\fBcolordiff\fR
را فراخوانی کند\&. خط زیر را به
~/\&.bashrc
(یا معادل آن) اضافه کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
alias diff=colordiff
.fi
.if n \{\
.RE
.\}
.PP
هر گزینه‌ای که به
colordiff
داده شود، عیناً به
\fBdiff\fR
منتقل می‌شود، به جز گزینه اختصاصی colordiff یعنی \*(Aqdifftype\*(Aq، مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
colordiff \-\-difftype=debdiff file1 file2
.fi
.if n \{\
.RE
.\}
.PP
مقادیر معتبر برای \*(Aqdifftype\*(Aq عبارتند از: diff،‏ diffc،‏ diffu،‏ diffy،‏ wdiff،‏ debdiff؛ این مقادیر به‌ترتیب با diff معمولی، diffهای زمینه‌ای (context diffs)، یکپارچه (unified diffs)، شانه به شانه (side\-by\-side diffs)، خروجی wdiff و خروجی debdiff متناظر هستند\&. زمانی که colordiff قادر به تشخیص خودکار نوع diff نیست، از این مقادیر برای لغو تشخیص خودکار استفاده کنید\&.
.PP
همچنین، ساختاری مانند \*(Aqcvs diff SOMETHING | colordiff\*(Aq را می‌توان در
~/\&.bashrc
به شکل زیر قرار داد:
.sp
.if n \{\
.RS 4
.\}
.nf
function cvsdiff () { cvs diff $@ | colordiff; }
.fi
.if n \{\
.RE
.\}
.PP
یا با ترکیب این ایده و استفاده از \*(Aqless\*(Aq:
.sp
.if n \{\
.RS 4
.\}
.nf
function cvsdiff () { cvs diff $@ | colordiff |less \-R; }
.fi
.if n \{\
.RE
.\}
.PP
توجه داشته باشید که نام تابع، یعنی cvsdiff، قابل سفارشی‌سازی است\&.
.PP
به‌طور پیش‌فرض، colordiff کد خروج فراخوانی diff زیرین (در صورت وجود) را بازمی‌گرداند، اما در شرایط خاصی مفید است که کد خروج colordiff به‌اجبار صفر شود: برای انجام این کار از گزینه \*(Aq\-\-fakeexitcode\*(Aq استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
colordiff \-\-fakeexitcode \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور colordiff بیشتر گزینه‌ها را به diff منتقل می‌کند، اما گزینه‌های اختصاصی گوناگونی برای colordiff وجود دارند که می‌توان از آن‌ها استفاده کرد:
.PP
\-\-help
.RS 4
نمایش این گزینه‌های اختصاصی colordiff
.RE
.PP
\-\-color=(yes|no)
.RS 4
اجبار به نمایش (یا جلوگیری از نمایش) رنگ‌ها در خروجی
.RE
.PP
\-\-color=patches=(yes|no)
.RS 4
اجبار به گنجاندن (یا جلوگیری از گنجاندن) کدهای رنگ در خروجی وصله (patch)
.RE
.PP
\-\-color\-term\-output\-only
.RS 4
اجبار به نمایش رنگ تنها در خروجی ترمینال
.RE
.PP
\-\-difftype=DIFFTYPE
.RS 4
اجبار به تشخیص difftype در قالب مشخص‌شده\&. مقدار DIFFTYPE می‌تواند یکی از موارد زیر باشد: diff،‏ diffc،‏ diffu،‏ diffy،‏ debdiff،‏ wdiff
.RE
.PP
\-\-(no)banner
.RS 4
نمایش (یا جلوگیری از نمایش) بنر colordiff
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/colordiffrc
.RS 4
فایل پیکربندی مرکزی\&. تنظیمات مخصوص به هر کاربر را می‌توان با تهیه رونوشت از این فایل در
~/\&.colordiffrc
و اعمال تغییرات مناسب فعال کرد\&.
.RE
.PP
colordiffrc\-lightbg
.RS 4
الگوی پیکربندی جایگزین برای استفاده در ترمینال‌هایی با پس‌زمینه روشن\&. از این فایل در /etc/colordiffrc یا ~/\&.colordiffrc رونوشت گرفته و آن را سفارشی‌سازی کنید\&.
.RE
.PP
colordiffrc\-gitdiff
.RS 4
الگوی پیکربندی جایگزین برای استفاده در ترمینال‌هایی با پس‌زمینه تیره، با رنگ‌های پیش‌فرضی که برای مطابقت با خروجی \*(Aqgit diff\*(Aq تنظیم شده‌اند\&. از این فایل در /etc/colordiffrc یا ~/\&.colordiffrc رونوشت گرفته و آن را سفارشی‌سازی کنید\&.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.PP
لطفاً گزارش باگ‌ها و پیشنهادات/وصله‌ها را به
<davee@sungate\&.co\&.uk>
ارسال کنید\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBDave Ewart\fR
.RS 4
نویسنده colordiff و بسته‌ساز Debian
.RE
.PP
\fBGraham Wilson\fR
.RS 4
نویسنده صفحه راهنما و منبع XML
.RE
.PP
\fBColin Tuckley\fR
.RS 4
حامی بسته Debian
.RE