'\" t .TH "DIFFUSE" "1" "2014\-07\-18" "diffuse 0\&.4\&.8" "Diffuse Manual" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .SH "نام (NAME)" diffuse \- ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBdiffuse\fR\ 'u \fBdiffuse\fR [\fB\-h\fR | \fB\-?\fR | \fB\-\-help\fR | \fB\-v\fR | \fB\-\-version\fR] .HP \w'\fBdiffuse\fR\ 'u \fBdiffuse\fR [\fB\-\-no\-rcfile\fR | \fB\-\-rcfile\ \fR\fB\fIfile\fR\fR] [[\fIoption\fR...] | [\fIfile\fR...]...] .SH "توضیحات (DESCRIPTION)" .PP برنامه Diffuse یک ابزار گرافیکی برای ادغام و مقایسه فایل‌های متنی است\&. برنامه Diffuse قادر است تعداد دلخواهی از فایل‌ها را در کنار یکدیگر مقایسه کند و به کاربران امکان می‌دهد تطابق خطوط را به صورت دستی تنظیم کرده و فایل‌ها را مستقیماً ویرایش نمایند\&. برنامه Diffuse همچنین می‌تواند نسخه‌های مختلف فایل‌ها را از مخازن Bazaar، CVS، Darcs، Git، Mercurial، Monotone، RCS و Subversion برای مقایسه و ادغام دریافت کند\&. .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های راهنما (Help Options)" .PP اگر یک گزینه راهنما مشخص شود، باید تنها آرگومان مشخص‌شده در خط فرمان باشد\&. برنامه Diffuse بلافاصله پس از نمایش اطلاعات راهنما خارج خواهد شد\&. .PP \fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR .RS 4 نمایش اطلاعات نحوه استفاده\&. .RE .PP \fB\-v\fR, \fB\-\-version\fR .RS 4 نمایش شماره نسخه و اطلاعات حق نشر\&. .RE .SS "گزینه‌های پیکربندی (Configuration Options)" .PP اگر یک گزینه پیکربندی مشخص شود، باید اولین آرگومان مشخص‌شده در خط فرمان باشد\&. .PP \fB\-\-no\-rcfile\fR .RS 4 هیچ‌یک از فایل‌های راه‌اندازی اولیه خوانده نشوند\&. .RE .PP \fB\-\-rcfile \fR\fB\fIfile\fR\fR .RS 4 دستورات راه‌اندازی اولیه تنها از فایل \fIfile\fR خوانده شوند\&. .RE .SS "گزینه‌های عمومی (General Options)" .PP \fB\-c\fR, \fB\-\-commit\fR \fIrev\fR .RS 4 باز کردن برگه‌های مقایسه فایل جداگانه برای تمام فایل‌های تحت تأثیر کامیت \fIrev\fR از مسیرهای باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان\&. .RE .PP \fB\-D\fR, \fB\-\-close\-if\-same\fR .RS 4 بستن تمام برگه‌هایی که هیچ تفاوتی ندارند\&. .RE .PP \fB\-e\fR, \fB\-\-encoding\fR \fIcodec\fR .RS 4 استفاده از \fIcodec\fR برای خواندن و نوشتن فایل‌ها\&. .RE .PP \fB\-L\fR, \fB\-\-label\fR \fIlabel\fR .RS 4 نمایش \fIlabel\fR به جای نام فایل\&. .RE .PP \fB\-m\fR, \fB\-\-modified\fR .RS 4 باز کردن برگه‌های مقایسه فایل جداگانه برای تمام فایل‌های تغییریافته از مسیرهای باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان\&. .RE .PP \fB\-r\fR, \fB\-\-revision\fR \fIrev\fR .RS 4 شامل کردن نسخه \fIrev\fR از فایل بعدیِ ذکرشده در آرگومان‌های خط فرمان در یک برگه مقایسه فایل\&. .RE .PP \fB\-s\fR, \fB\-\-separate\fR .RS 4 باز کردن تمام فایل‌های باقی‌مانده مشخص‌شده در آرگومان‌های خط فرمان در برگه‌های مقایسه فایل جداگانه\&. .RE .PP \fB\-t\fR, \fB\-\-tab\fR .RS 4 شروع یک برگه جدید برای هر فایل باقی‌مانده ذکرشده در آرگومان‌های خط فرمان\&. .RE .PP \fB\-V\fR, \fB\-\-vcs\fR \fIvcs\-list\fR .RS 4 جستجو برای سامانه‌های کنترل نسخه به ترتیب: \fIvcs\-list\fR\&. .RE .PP \fB\-\-line \fR\fB\fIline\fR\fR .RS 4 شروع با انتخاب خط \fIline\fR\&. .RE .PP \fB\-\-null\-file\fR .RS 4 ایجاد یک قاب (pane) مقایسه فایل خالی\&. .RE .SS "گزینه‌های نمایش (Display Options)" .PP گزینه‌های نمایش مشخص‌شده در آرگومان‌های خط فرمان، مقادیر تنظیمات ذخیره‌شده را بازنویسی خواهند کرد\&. .PP \fB\-b\fR, \fB\-\-ignore\-space\-change\fR .RS 4 نادیده گرفتن تغییرات در میزان فاصله‌های خالی (white space)\&. .RE .PP \fB\-B\fR, \fB\-\-ignore\-blank\-lines\fR .RS 4 نادیده گرفتن تغییراتی که تمام خطوط آن‌ها خالی است\&. .RE .PP \fB\-E\fR, \fB\-\-ignore\-end\-of\-line\fR .RS 4 نادیده گرفتن تفاوت‌های انتهای خط\&. .RE .PP \fB\-i\fR, \fB\-\-ignore\-case\fR .RS 4 نادیده گرفتن تفاوت‌های حروف کوچک و بزرگ در محتوای فایل\&. .RE .PP \fB\-w\fR, \fB\-\-ignore\-all\-space\fR .RS 4 نادیده گرفتن تمام فاصله‌های خالی\&. .RE .SH "مقایسه فایل (FILE COMPARISON)" .PP از گزینه‌های منوی File \(-> New 2\-Way File Merge، File \(-> New 3\-Way File Merge، و File \(-> New N\-Way File Merge برای ایجاد برگه‌های بیشتر جهت مقایسه فایل‌های متنی استفاده کنید\&. نام فایل‌ها و نسخه‌ها را می‌توان در آرگومان‌های خط فرمانِ مورداستفاده برای فراخوانی Diffuse یا در فیلدهای پنجره گفتگوی Open File مشخص کرد\&. .PP برنامه Diffuse فایل‌ها را در کنار هم نمایش داده و فاصله‌هایی (gap) برای تراز کردن خطوط متنی مشابه درج می‌کند\&. تفاوت‌ها با رنگ پس‌زمینه متفاوتی برجسته می‌شوند\&. .SS "خلاصه مقایسه (Comparison Summary)" .PP خلاصه‌ای از فایل‌های مقایسه‌شده در حاشیه سمت راست قرار دارد\&. این خلاصه نشان می‌دهد که کجا فاصله‌ها برای تراز کردن خطوط متنی منطبق درج شده‌اند و تفاوت‌ها را با استفاده از رنگ برجسته می‌کند\&. ویرایش‌های دستی نیز با رنگ سبز مشخص می‌شوند\&. یک مکان‌نمای آبی ناحیه‌ای را که در حال حاضر مشاهده می‌شود مشخص می‌کند\&. ناحیه دیده‌شده را می‌توان با کلیک در هر نقطه از این خلاصه تغییر داد\&. .SS "انتخاب (Selecting)" .PP خطوط متن را می‌توان با استفاده از نشانگر ماوس یا صفحه‌کلید انتخاب کرد\&. خطوط متن را با کلیک روی یک خط با نشانگر ماوس انتخاب کنید\&. برای انتخاب چند خط، کلیک کرده و بکشید (drag کنید)\&. نگه داشتن کلید Shift هنگام کلیک کردن، انتخاب فعلی را گسترش می‌دهد\&. خطوط را با استفاده از صفحه‌کلید و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما انتخاب کنید\&. با نگه داشتن کلید Shift و فشردن کلیدهای Page Up/Down یا کلیدهای جهت‌نما، انتخاب فعلی را گسترش دهید\&. با استفاده از کلیدهای جهت‌نمای چپ و راست، انتخاب را به فایل مجاور منتقل کنید\&. .SS "تطبیق خطوط (Matching Lines)" .PP می‌توان از نشانگر ماوس یا صفحه‌کلید برای تراز دستی خطوط متن با فایل‌های مجاور استفاده کرد\&. برای تراز کردن خطوط متن با نشانگر ماوس، یک خط متن را با کلیک چپ ماوس انتخاب کنید، روی خطی از متن از یک فایل مجاور راست‌کلیک کرده و گزینه Align with Selection را انتخاب نمایید\&. برای تراز کردن خطوط متن با صفحه‌کلید، انتخاب را با کلیدهای جهت‌نما حرکت دهید، کلید فاصله (Space) را فشار دهید تا خط متن فعلی علامت‌گذاری شود، انتخاب را با کلیدهای جهت‌نما به یک خط متن در فایل مجاور منتقل کرده و دوباره کلید فاصله را فشار دهید تا خط مقصد انتخاب شود\&. فشردن کلید Escape عملیات را لغو خواهد کرد\&. .PP از گزینه منوی Isolate برای جلوگیری از تطبیق خطوط انتخاب‌شده با هر خطی از فایل‌های مجاور استفاده کنید\&. .SS "ویرایش (Editing)" .PP کلید Enter را فشار دهید یا روی ناحیه متن دوبار کلیک کنید تا وارد حالت ویرایش متن شوید\&. مکان‌نما تغییر خواهد کرد تا حالت ویرایش متن را نشان دهد و نوار وضعیت در پایین پنجره موقعیت ستون مکان‌نما را نمایش خواهد داد\&. .PP در حالت ویرایش متن، متن را می‌توان با نشانگر ماوس با کلیک کردن و کشیدن انتخاب کرد\&. انتخاب فعلی را می‌توان با نگه داشتن کلید Shift و جابجایی مکان‌نما با کلیک ماوس یا فشردن هریک از کلیدهای جهت‌نما، Home، End یا Page Up/Down گسترش داد\&. کلمات منفرد را می‌توان با دوبار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد\&. کل خطوط را می‌توان با سه بار کلیک روی آن‌ها با نشانگر ماوس انتخاب کرد\&. .PP متن را با تایپ روی صفحه‌کلید تغییر دهید\&. خطوط تغییریافته با رنگ سبز برجسته می‌شوند\&. از گزینه‌های منوی Undo و Redo برای واگردانی و بازانجام عملیات‌های قبلی استفاده کنید\&. .PP کلید Escape را فشار دهید یا با کلیک چپ ماوس روی ناحیه متن فایلی دیگر کلیک کنید تا از حالت ویرایش خارج شوید\&. .SS "ادغام (Merging)" .PP از دکمه‌های تفاوت یا گزینه‌های منو برای پیمایش بین بلوک‌های تفاوت در یک فایل استفاده کنید\&. هنگام پیمایش، Diffuse انتخاب را به مجموعه پیوسته بعدی از خطوط دارای تفاوت یا ویرایش منتقل می‌کند\&. .PP از دکمه‌های ادغام یا گزینه‌های منو برای کپی کردن بلوک‌های متن در محدوده خطوط انتخاب‌شده استفاده کنید\&. از گزینه‌های منوی Undo و Redo می‌توان برای واگردانی و بازانجام عملیات‌های قبلی استفاده کرد\&. تمام تغییرات اعمال‌شده بر روی یک مجموعه از خطوط را می‌توان با استفاده از گزینه منوی Clear Edits صرف نظر از ترتیب انجام ویرایش‌ها، بازگرداند\&. .SH "کنترل نسخه (VERSION CONTROL)" .PP برنامه Diffuse می‌تواند نسخه‌های فایل را از چندین سامانه کنترل نسخه از طریق رابط خط فرمان آن‌ها دریافت کند\&. نگارش مایکروسافت ویندوزِ Diffuse قادر است از هر دو نسخه بومی و Cygwin سامانه‌های پشتیبانی‌شده کنترل نسخه استفاده کند\&. هنگام استفاده از Diffuse با Cygwin، اطمینان حاصل کنید که تنظیمات Cygwin در Diffuse سیستم شما را به درستی توصیف می‌کنند\&. اگر گزینه ترجیحی Update paths for Cygwin برای یک سامانه کنترل نسخه وجود داشته باشد، برای استفاده از نگارش Cygwin باید فعال گردد\&. .PP سامانه‌های کنترل نسخه نسبت به مسیر سیستم (PATH) و سایر تنظیمات متغیرهای محیطی حساس هستند\&. گزینه ترجیحی Launch from a Bash login shell می‌تواند برای تنظیم آسان محیط سامانه‌های کنترل نسخه Cygwin استفاده شود\&. .SS "مشاهده تغییرات ثبت‌نشده (Viewing Uncommitted Modifications)" .PP گزینه \fB\-m\fR باعث می‌شود Diffuse برگه‌های مقایسه‌ای را برای هر فایلی که طبق اعلام سامانه کنترل نسخه دارای تغییرات ثبت‌نشده (کامیت‌نشده) است، باز کند\&. این ویژگی برای بازبینی تمام تغییرات پیش از ثبت یا حل تداخل‌های ادغام بسیار مناسب است\&. اگر هیچ مسیری مشخص نشود، دایرکتوری کاری فعلی استفاده خواهد شد\&. به عنوان مثال، تمام تغییرات ثبت‌نشده خود را با این دستور خط فرمان مشاهده کنید: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-m\fR .fi .if n \{\ .RE .\} .PP اگر تنها یک فایل مشخص شود، نسخه پیش‌فرض فایل برای مقایسه استفاده خواهد شد\&. برای مثال، دستور زیر یک ادغام ۲\-طرفه بین نسخه پیش‌فرض foo\&.C و فایل محلی foo\&.C را نمایش می‌دهد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse foo\&.C\fR .fi .if n \{\ .RE .\} .sp .SS "مشخص کردن نسخه‌ها (Specifying Revisions)" .PP گزینه \fB\-r\fR همچنین می‌تواند برای مشخص کردن صریح یک نسخه خاص از فایل استفاده شود\&. هر مشخص‌کننده نسخه‌ای که برای سامانه کنترل نسخه قابل فهم باشد می‌تواند به کار رود\&. اگر تنها یک نسخه از فایل مشخص شده باشد، فایل محلی برای مقایسه استفاده خواهد شد\&. برای مثال، دستور زیر یک ادغام ۲\-طرفه بین نسخه 123 از foo\&.C و فایل محلی foo\&.C را نمایش می‌دهد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-r 123 foo\&.C\fR .fi .if n \{\ .RE .\} .PP با مشخص کردن چندین گزینه \fB\-r\fR می‌توان نسخه‌های متعددی از فایل را با هم مقایسه کرد\&. برای مثال، دستور زیر یک ادغام ۲\-طرفه بین نسخه 123 از foo\&.C و نسخه 321 از foo\&.C را نمایش می‌دهد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-r 123 \-r 321 foo\&.C\fR .fi .if n \{\ .RE .\} .PP فایل‌های محلی را می‌توان با فایل‌های سامانه کنترل نسخه ترکیب کرد\&. برای مثال، دستور زیر یک ادغام ۳\-طرفه بین نسخه MERGE_HEAD از foo\&.C، فایل محلی foo\&.C، و نسخه HEAD از foo\&.C را نمایش می‌دهد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-r MERGE_HEAD foo\&.C foo\&.C \-r HEAD foo\&.C\fR .fi .if n \{\ .RE .\} .PP گزینه \fB\-c\fR می‌تواند برای مشخص کردن آسان یک جفت نسخه متوالی استفاده شود\&. برای مثال، دستور زیر یک ادغام ۲\-طرفه بین نسخه 1\&.2\&.2 از foo\&.C و نسخه 1\&.2\&.3 از foo\&.C را نمایش می‌دهد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-c 1\&.2\&.3 foo\&.C\fR .fi .if n \{\ .RE .\} .PP برنامه Diffuse تعداد قاب‌های مورد استفاده برای مقایسه فایل‌ها را محدود نمی‌کند\&. ورودی‌های یک ادغام چندگانه (octopus merge) در گیت را می‌توان با خط فرمانی مانند این مشاهده کرد: .PP .if n \{\ .RS 4 .\} .nf $ \fBdiffuse \-r HEAD^1 \-r HEAD^2 \-r HEAD^3 \-r HEAD^4 \-r HEAD^5 foo\&.C\fR .fi .if n \{\ .RE .\} .sp .SH "منابع (RESOURCES)" .PP منابع می‌توانند برای سفارشی‌سازی جنبه‌های مختلف ظاهر و رفتار Diffuse مانند تغییر رنگ‌های مورد استفاده در رابط کاربری، سفارشی‌سازی کلیدهای میانبر صفحه‌کلید، افزودن یا جایگزینی قواعد برجسته‌سازی نحوی، یا تغییر نگاشت پسوندهای فایل به قواعد برجسته‌سازی نحوی به کار روند\&. .PP هنگامی که Diffuse شروع به کار می‌کند، ابتدا دستورات را از فایل راه‌اندازی اولیه سراسری سیستم /etc/diffuserc (%INSTALL_DIR%\ediffuserc در مایکروسافت ویندوز) و سپس از فایل راه‌اندازی اولیه شخصی ~/\&.config/diffuse/diffuserc (%HOME%\e\&.config\ediffuse\ediffuserc در مایکروسافت ویندوز) می‌خواند\&. این رفتار را می‌توان با گزینه‌های پیکربندی \fB\-\-no\-rcfile\fR و \fB\-\-rcfile\fR تغییر داد\&. یک تحلیل‌گر لغوی مشابه Bourne shell برای تجزیه دستورات راه‌اندازی اولیه استفاده می‌شود\&. توضیحات (کامنت‌ها) و نویسه‌های خاص را می‌توان با همان شیوه اسکیپ موجود در اسکریپت‌های Bourne shell درج کرد\&. .SS "عمومی (General)" .PP \fBimport \fR\fB\fIfile\fR\fR .RS 4 دستورات راه‌اندازی اولیه را از \fIfile\fR پردازش می‌کند\&. فایل‌های راه‌اندازی اولیه تنها یک بار پردازش خواهند شد\&. .RE .SS "ترکیب کلیدها (Key Bindings)" .PP \fBkeybinding \fR\fB\fIcontext\fR\fR\fB \fR\fB\fIaction\fR\fR\fB \fR\fB\fIkey_combination\fR\fR .RS 4 یک ترکیب کلید را به \fIaction\fR هنگامی که در \fIcontext\fR استفاده می‌شود متصل می‌کند\&. کلیدهای تبدیل‌کننده Shift و Control را به ترتیب با افزودن پیشوند \fBShift+\fR و \fBCtrl+\fR به \fIkey_combination\fR مشخص کنید\&. کلیدهایی که معمولاً توسط کلید Shift تغییر می‌یابند، در صورتی که \fIkey_combination\fR شامل کلید Shift باشد، باید با استفاده از مقدار تغییریافته خود مشخص شوند؛ به عنوان مثال: \fBCtrl+g\fR و \fBShift+Ctrl+G\fR\&. با مشخص کردن \fBNone\fR برای \fIaction\fR، اتصال کلید برای \fIkey_combination\fR را حذف کنید\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBکلیدهای میانبر گزینه‌های منو (Menu Item Key Bindings)\fR .RS 4 .PP از \fBmenu\fR برای \fIcontext\fR جهت تعریف کلیدهای میانبر گزینه‌های منو استفاده کنید\&. مقادیر زیر برای \fIaction\fR معتبر هستند: .PP \fBopen_file\fR .RS 4 File \(-> Open File\&.\&.\&. گزینه منو .sp Default: Ctrl+o .RE .PP \fBopen_file_in_new_tab\fR .RS 4 File \(-> Open File In New Tab\&.\&.\&. گزینه منو .sp Default: Ctrl+t .RE .PP \fBopen_modified_files\fR .RS 4 File \(-> Open Modified Files\&.\&.\&. گزینه منو .sp Default: Shift+Ctrl+O .RE .PP \fBopen_commit\fR .RS 4 File \(-> Open Commit\&.\&.\&. گزینه منو .sp Default: Shift+Ctrl+T .RE .PP \fBreload_file\fR .RS 4 File \(-> Reload File گزینه منو .sp Default: Shift+Ctrl+R .RE .PP \fBsave_file\fR .RS 4 File \(-> Save File گزینه منو .sp Default: Ctrl+s .RE .PP \fBsave_file_as\fR .RS 4 File \(-> Save File As\&.\&.\&. گزینه منو .sp Default: Shift+Ctrl+A .RE .PP \fBsave_all\fR .RS 4 File \(-> Save All گزینه منو .sp Default: Shift+Ctrl+S .RE .PP \fBnew_2_way_file_merge\fR .RS 4 File \(-> New 2\-Way File Merge گزینه منو .sp Default: Ctrl+2 .RE .PP \fBnew_3_way_file_merge\fR .RS 4 File \(-> New 3\-Way File Merge گزینه منو .sp Default: Ctrl+3 .RE .PP \fBnew_n_way_file_merge\fR .RS 4 File \(-> New N\-Way File Merge گزینه منو .sp Default: Ctrl+4 .RE .PP \fBclose_tab\fR .RS 4 File \(-> Close Tab گزینه منو .sp Default: Ctrl+w .RE .PP \fBundo_close_tab\fR .RS 4 File \(-> Undo Close Tab گزینه منو .sp Default: Shift+Ctrl+w .RE .PP \fBquit\fR .RS 4 File \(-> Quit گزینه منو .sp Default: Ctrl+q .RE .PP \fBundo\fR .RS 4 Edit \(-> Undo گزینه منو .sp Default: Ctrl+z .RE .PP \fBredo\fR .RS 4 Edit \(-> Redo گزینه منو .sp Default: Shift+Ctrl+Z .RE .PP \fBcut\fR .RS 4 Edit \(-> Cut گزینه منو .sp Default: Ctrl+x .RE .PP \fBcopy\fR .RS 4 Edit \(-> Copy گزینه منو .sp Default: Ctrl+c .RE .PP \fBpaste\fR .RS 4 Edit \(-> Paste گزینه منو .sp Default: Ctrl+v .RE .PP \fBselect_all\fR .RS 4 Edit \(-> Select All گزینه منو .sp Default: Ctrl+a .RE .PP \fBclear_edits\fR .RS 4 Edit \(-> Clear Edits گزینه منو .sp Default: Ctrl+r .RE .PP \fBdismiss_all_edits\fR .RS 4 Edit \(-> Dismiss All Edits گزینه منو .sp Default: Ctrl+d .RE .PP \fBfind\fR .RS 4 Edit \(-> Find\&.\&.\&. گزینه منو .sp Default: Ctrl+f .RE .PP \fBfind_next\fR .RS 4 Edit \(-> Find Next گزینه منو .sp Default: Ctrl+g .RE .PP \fBfind_previous\fR .RS 4 Edit \(-> Find Previous گزینه منو .sp Default: Shift+Ctrl+G .RE .PP \fBgo_to_line\fR .RS 4 Edit \(-> Go To Line\&.\&.\&. گزینه منو .sp Default: Shift+Ctrl+L .RE .PP \fBpreferences\fR .RS 4 Edit \(-> Preferences گزینه منو .sp Default: None .RE .PP \fBno_syntax_highlighting\fR .RS 4 View \(-> Syntax Highlighting \(-> None گزینه منو .sp Default: None .RE .PP \fBsyntax_highlighting_\fR\fB\fIsyntax\fR\fR .RS 4 View \(-> Syntax Highlighting \(-> \fIsyntax\fR گزینه منو .sp Default: None .RE .PP \fBrealign_all\fR .RS 4 View \(-> Realign All گزینه منو .sp Default: Ctrl+l .RE .PP \fBisolate\fR .RS 4 View \(-> Isolate گزینه منو .sp Default: Ctrl+i .RE .PP \fBfirst_difference\fR .RS 4 View \(-> First Difference گزینه منو .sp Default: Shift+Ctrl+Up .RE .PP \fBprevious_difference\fR .RS 4 View \(-> Previous Difference گزینه منو .sp Default: Ctrl+Up .RE .PP \fBnext_difference\fR .RS 4 View \(-> Next Difference گزینه منو .sp Default: Ctrl+Down .RE .PP \fBlast_difference\fR .RS 4 View \(-> Last Difference گزینه منو .sp Default: Shift+Ctrl+Down .RE .PP \fBfirst_tab\fR .RS 4 View \(-> First Tab گزینه منو .sp Default: Shift+Ctrl+Page_Up .RE .PP \fBprevious_tab\fR .RS 4 View \(-> Previous Tab گزینه منو .sp Default: Ctrl+Page_Up .RE .PP \fBnext_tab\fR .RS 4 View \(-> Next Tab گزینه منو .sp Default: Ctrl+Page_Down .RE .PP \fBlast_tab\fR .RS 4 View \(-> Last Tab گزینه منو .sp Default: Shift+Ctrl+Page_Down .RE .PP \fBshift_pane_right\fR .RS 4 View \(-> Shift Pane Right گزینه منو .sp Default: Shift+Ctrl+parenleft .RE .PP \fBshift_pane_left\fR .RS 4 View \(-> Shift Pane Left گزینه منو .sp Default: Shift+Ctrl+parenright .RE .PP \fBconvert_to_upper_case\fR .RS 4 Format \(-> Convert To Upper Case گزینه منو .sp Default: Ctrl+u .RE .PP \fBconvert_to_lower_case\fR .RS 4 Format \(-> Convert To Lower Case گزینه منو .sp Default: Shift+Ctrl+U .RE .PP \fBsort_lines_in_ascending_order\fR .RS 4 Format \(-> Sort Lines In Ascending Order گزینه منو .sp Default: Ctrl+y .RE .PP \fBsort_lines_in_descending_order\fR .RS 4 Format \(-> Sort Lines In Descending Order گزینه منو .sp Default: Shift+Ctrl+Y .RE .PP \fBremove_trailing_white_space\fR .RS 4 Format \(-> Remove Trailing White Space گزینه منو .sp Default: Ctrl+k .RE .PP \fBconvert_tabs_to_spaces\fR .RS 4 Format \(-> Convert Tabs To Spaces گزینه منو .sp Default: Ctrl+b .RE .PP \fBconvert_leading_spaces_to_tabs\fR .RS 4 Format \(-> Convert Leading Spaces To Tabs گزینه منو .sp Default: Shift+Ctrl+B .RE .PP \fBincrease_indenting\fR .RS 4 Format \(-> Increase Indenting گزینه منو .sp Default: Shift+Ctrl+greater .RE .PP \fBdecrease_indenting\fR .RS 4 Format \(-> Decrease Indenting گزینه منو .sp Default: Shift+Ctrl+less .RE .PP \fBconvert_to_dos\fR .RS 4 Format \(-> Convert To DOS Format گزینه منو .sp Default: Shift+Ctrl+E .RE .PP \fBconvert_to_mac\fR .RS 4 Format \(-> Convert To Mac Format گزینه منو .sp Default: Shift+Ctrl+C .RE .PP \fBconvert_to_unix\fR .RS 4 Format \(-> Convert To Unix Format گزینه منو .sp Default: Ctrl+e .RE .PP \fBcopy_selection_right\fR .RS 4 Merge \(-> Copy Selection Right گزینه منو .sp Default: Shift+Ctrl+Right .RE .PP \fBcopy_selection_left\fR .RS 4 Merge \(-> Copy Selection Left گزینه منو .sp Default: Shift+Ctrl+Left .RE .PP \fBcopy_left_into_selection\fR .RS 4 Merge \(-> Copy Left Into Selection گزینه منو .sp Default: Ctrl+Right .RE .PP \fBcopy_right_into_selection\fR .RS 4 Merge \(-> Copy Right Into Selection گزینه منو .sp Default: Ctrl+Left .RE .PP \fBmerge_from_left_then_right\fR .RS 4 Merge \(-> Merge From Left Then Right گزینه منو .sp Default: Ctrl+m .RE .PP \fBmerge_from_right_then_left\fR .RS 4 Merge \(-> Merge From Right Then Left گزینه منو .sp Default: Shift+Ctrl+M .RE .PP \fBhelp_contents\fR .RS 4 Help \(-> Help Contents گزینه منو .sp Default: F1 .RE .PP \fBabout\fR .RS 4 Help \(-> About گزینه منو .sp Default: None .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBکلیدهای میانبر حالت ویرایش خط (Line Editing Mode Key Bindings)\fR .RS 4 .PP از \fBline_mode\fR برای \fIcontext\fR جهت تعریف کلیدهای میانبر حالت ویرایش خط استفاده کنید\&. مقادیر زیر برای \fIaction\fR معتبر هستند: .PP \fBenter_align_mode\fR .RS 4 ورود به حالت ویرایش تراز .sp Default: space .RE .PP \fBenter_character_mode\fR .RS 4 ورود به حالت ویرایش نویسه .sp Defaults: Return, KP_Enter .RE .PP \fBfirst_line\fR .RS 4 انتقال مکان‌نما به خط اول .sp Defaults: Home, g .RE .PP \fBextend_first_line\fR .RS 4 انتقال مکان‌نما به خط اول، همراه با گسترش انتخاب .sp Default: Shift+Home .RE .PP \fBlast_line\fR .RS 4 انتقال مکان‌نما به خط آخر .sp Defaults: End, Shift+G .RE .PP \fBextend_last_line\fR .RS 4 انتقال مکان‌نما به خط آخر، همراه با گسترش انتخاب .sp Default: Shift+End .RE .PP \fBup\fR .RS 4 انتقال مکان‌نما یک خط به بالا .sp Defaults: Up, k .RE .PP \fBextend_up\fR .RS 4 انتقال مکان‌نما یک خط به بالا، همراه با گسترش انتخاب .sp Defaults: Shift+Up, Shift+K .RE .PP \fBdown\fR .RS 4 انتقال مکان‌نما یک خط به پایین .sp Defaults: Down, j .RE .PP \fBextend_down\fR .RS 4 انتقال مکان‌نما یک خط به پایین، همراه با گسترش انتخاب .sp Defaults: Shift+Down, Shift+J .RE .PP \fBleft\fR .RS 4 انتقال مکان‌نما یک فایل به چپ .sp Defaults: Left, h .RE .PP \fBextend_left\fR .RS 4 انتقال مکان‌نما یک فایل به چپ، همراه با گسترش انتخاب .sp Default: Shift+Left .RE .PP \fBright\fR .RS 4 انتقال مکان‌نما یک فایل به راست .sp Defaults: Right, l .RE .PP \fBextend_right\fR .RS 4 انتقال مکان‌نما یک فایل به راست، همراه با گسترش انتخاب .sp Default: Shift+Right .RE .PP \fBpage_up\fR .RS 4 انتقال مکان‌نما یک صفحه به بالا .sp Defaults: Page_Up, Ctrl+u .RE .PP \fBextend_page_up\fR .RS 4 انتقال مکان‌نما یک صفحه به بالا، همراه با گسترش انتخاب .sp Defaults: Shift+Page_Up, Shift+Ctrl+u .RE .PP \fBpage_down\fR .RS 4 انتقال مکان‌نما یک صفحه به پایین .sp Defaults: Page_Down, Ctrl+d .RE .PP \fBextend_page_down\fR .RS 4 انتقال مکان‌نما یک صفحه به پایین، همراه با گسترش انتخاب .sp Defaults: Shift+Page_Down, Shift+Ctrl+d .RE .PP \fBdelete_text\fR .RS 4 حذف متن انتخاب‌شده .sp Defaults: BackSpace, Delete, x .RE .PP \fBfirst_difference\fR .RS 4 انتخاب اولین تفاوت .sp Defaults: Ctrl+Home, Shift+P .RE .PP \fBprevious_difference\fR .RS 4 انتخاب تفاوت قبلی .sp Default: p .RE .PP \fBnext_difference\fR .RS 4 انتخاب تفاوت بعدی .sp Default: n .RE .PP \fBlast_difference\fR .RS 4 انتخاب آخرین تفاوت .sp Defaults: Ctrl+End, Shift+N .RE .PP \fBclear_edits\fR .RS 4 پاک کردن تمام ویرایش‌ها از خطوط انتخاب‌شده .sp Default: r .RE .PP \fBcopy_selection_left\fR .RS 4 کپی خطوط از بخش انتخاب‌شده به فایل سمت چپ .sp Default: None .RE .PP \fBcopy_selection_right\fR .RS 4 کپی خطوط از بخش انتخاب‌شده به فایل سمت راست .sp Default: None .RE .PP \fBcopy_left_into_selection\fR .RS 4 کپی خطوط از فایل سمت چپ به بخش انتخاب‌شده .sp Default: Shift+L .RE .PP \fBcopy_right_into_selection\fR .RS 4 کپی خطوط از فایل سمت راست به بخش انتخاب‌شده .sp Default: Shift+H .RE .PP \fBmerge_from_left_then_right\fR .RS 4 ادغام خطوط ابتدا از فایل سمت چپ و سپس از فایل سمت راست .sp Default: m .RE .PP \fBmerge_from_right_then_left\fR .RS 4 ادغام خطوط ابتدا از فایل سمت راست و سپس از فایل سمت چپ .sp Default: Shift+M .RE .PP \fBisolate\fR .RS 4 جداسازی خطوط انتخاب‌شده .sp Default: i .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBکلیدهای میانبر حالت ویرایش تراز (Alignment Editing Mode Key Bindings)\fR .RS 4 .PP از \fBalign_mode\fR برای \fIcontext\fR جهت تعریف کلیدهای میانبر حالت ویرایش تراز استفاده کنید\&. مقادیر زیر برای \fIaction\fR معتبر هستند: .PP \fBenter_line_mode\fR .RS 4 ورود به حالت ویرایش خط .sp Default: Escape .RE .PP \fBenter_character_mode\fR .RS 4 ورود به حالت ویرایش نویسه .sp Defaults: Return, KP_Enter .RE .PP \fBfirst_line\fR .RS 4 انتقال مکان‌نما به خط اول .sp Default: g .RE .PP \fBlast_line\fR .RS 4 انتقال مکان‌نما به خط آخر .sp Default: Shift+G .RE .PP \fBup\fR .RS 4 انتقال مکان‌نما یک خط به بالا .sp Defaults: Up, k .RE .PP \fBdown\fR .RS 4 انتقال مکان‌نما یک خط به پایین .sp Defaults: Down, j .RE .PP \fBleft\fR .RS 4 انتقال مکان‌نما یک فایل به چپ .sp Defaults: Left, h .RE .PP \fBright\fR .RS 4 انتقال مکان‌نما یک فایل به راست .sp Defaults: Right, l .RE .PP \fBpage_up\fR .RS 4 انتقال مکان‌نما یک صفحه به بالا .sp Defaults: Page_Up, Ctrl+u .RE .PP \fBpage_down\fR .RS 4 انتقال مکان‌نما یک صفحه به پایین .sp Defaults: Page_Down, Ctrl+d .RE .PP \fBalign\fR .RS 4 تراز کردن خط انتخاب‌شده با موقعیت مکان‌نما .sp Default: space .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBکلیدهای میانبر حالت ویرایش نویسه (Character Editing Mode Key Bindings)\fR .RS 4 .PP از \fBcharacter_mode\fR برای \fIcontext\fR جهت تعریف کلیدهای میانبر حالت ویرایش نویسه استفاده کنید\&. مقادیر زیر برای \fIaction\fR معتبر هستند: .PP \fBenter_line_mode\fR .RS 4 ورود به حالت ویرایش خط .sp Default: Escape .RE .RE .SS "رشته‌ها (Strings)" .PP \fBstring \fR\fB\fIname\fR\fR\fB \fR\fB\fIvalue\fR\fR .RS 4 یک منبع رشته‌ای به نام \fIname\fR با مقدار \fIvalue\fR اعلان می‌کند\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBمنابع رشته‌ای استفاده‌شده (Used String Resources)\fR .RS 4 .PP منابع رشته‌ای زیر توسط Diffuse استفاده می‌شوند: .PP \fBdifference_colours\fR .RS 4 فهرستی از منابع رنگی مورد استفاده برای نشان دادن تفاوت‌ها .sp Default: difference_1 difference_2 difference_3 .RE .RE .SS "رنگ‌ها (Colours)" .PP \fB[ colour | color ] \fR\fB\fIname\fR\fR\fB \fR\fB\fIred\fR\fR\fB \fR\fB\fIgreen\fR\fR\fB \fR\fB\fIblue\fR\fR .RS 4 یک منبع رنگی به نام \fIname\fR اعلان می‌کند\&. مؤلفه‌های رنگ منفرد باید به عنوان مقداری بین 0 و 1 بیان شوند\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBمنابع رنگی استفاده‌شده (Used Colour Resources)\fR .RS 4 .PP منابع رنگی زیر توسط Diffuse استفاده می‌شوند: .PP \fBalignment\fR .RS 4 رنگ مورد استفاده برای نشان دادن خطی که برای تراز دستی انتخاب شده است .sp Default: 1 1 0 .RE .PP \fBcharacter_selection\fR .RS 4 رنگ مورد استفاده برای نشان دادن نویسه‌های انتخاب‌شده .sp Default: 0\&.7 0\&.7 1 .RE .PP \fBcursor\fR .RS 4 رنگ مورد استفاده برای مکان‌نما .sp Default: 0 0 0 .RE .PP \fBdifference_1\fR .RS 4 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین اولین جفت از فایل‌ها .sp Default: 1 0\&.625 0\&.625 .RE .PP \fBdifference_2\fR .RS 4 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین دومین جفت از فایل‌ها .sp Default: 0\&.85 0\&.625 0\&.775 .RE .PP \fBdifference_3\fR .RS 4 رنگ مورد استفاده برای مشخص کردن تفاوت‌های بین سومین جفت از فایل‌ها .sp Default: 0\&.85 0\&.775 0\&.625 .RE .PP \fBedited\fR .RS 4 رنگ مورد استفاده برای نشان دادن خطوط ویرایش‌شده .sp Default: 0\&.5 1 0\&.5 .RE .PP \fBhatch\fR .RS 4 رنگ مورد استفاده برای نشان دادن فاصله‌های تراز .sp Default: 0\&.8 0\&.8 0\&.8 .RE .PP \fBline_number\fR .RS 4 رنگ مورد استفاده برای شماره خطوط .sp Default: 0 0 0 .RE .PP \fBline_number_background\fR .RS 4 رنگ پس‌زمینه برای ناحیه شماره خط .sp Default: 0\&.75 0\&.75 0\&.75 .RE .PP \fBline_selection\fR .RS 4 رنگ مورد استفاده برای نشان دادن خطوط انتخاب‌شده .sp Default: 0\&.7 0\&.7 1 .RE .PP \fBmap_background\fR .RS 4 رنگ پس‌زمینه برای ناحیه نقشه (خلاصه مقایسه) .sp Default: 0\&.6 0\&.6 0\&.6 .RE .PP \fBmargin\fR .RS 4 رنگ مورد استفاده برای نشان دادن حاشیه راست .sp Default: 0\&.8 0\&.8 0\&.8 .RE .PP \fBpreedit\fR .RS 4 رنگ متن پیش‌ویرایش .sp Default: 0 0 0 .RE .PP \fBtext\fR .RS 4 رنگ متن معمولی .sp Default: 0 0 0 .RE .PP \fBtext_background\fR .RS 4 رنگ پس‌زمینه برای ناحیه متن .sp Default: 1 1 1 .RE .RE .SS "مقادیر ممیز شناور (Floating Point Values)" .PP \fBfloat \fR\fB\fIname\fR\fR\fB \fR\fB\fIvalue\fR\fR .RS 4 یک منبع ممیز شناور به نام \fIname\fR با مقدار \fIvalue\fR اعلان می‌کند\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBمنابع ممیز شناور استفاده‌شده (Used Floating Point Resources)\fR .RS 4 .PP منابع ممیز شناور زیر توسط Diffuse استفاده می‌شوند: .PP \fBalignment_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ تراز دستی .sp Defaults: 1 .RE .PP \fBcharacter_difference_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ‌های تفاوت نویسه‌ها .sp Defaults: 0\&.4 .RE .PP \fBcharacter_selection_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ انتخاب نویسه .sp Defaults: 0\&.4 .RE .PP \fBedited_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ خط ویرایش‌شده .sp Defaults: 0\&.4 .RE .PP \fBline_difference_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ‌های تفاوت خطوط .sp Defaults: 0\&.3 .RE .PP \fBline_selection_opacity\fR .RS 4 میزان کدر بودن مورد استفاده هنگام ترکیب رنگ انتخاب خط .sp Defaults: 0\&.4 .RE .RE .SS "برجسته‌سازی نحوی (Syntax Highlighting)" .PP \fBsyntax \fR\fB\fIname\fR\fR\fB \fR\fB[\fIinitial_state\fR \fIdefault_tag\fR]\fR .RS 4 یک سبک نحوی جدید به نام \fIname\fR اعلان می‌کند\&. برجسته‌سازی نحوی از یک ماشین حالت ساده استفاده می‌کند که در هنگام تطبیق الگوهای خاص، بین حالت‌ها جابجا می‌شود\&. حالت اولیه برای ماشین حالت \fIinitial_state\fR خواهد بود\&. تمام نویسه‌هایی که با هیچ الگویی تطبیق پیدا نکنند، با برچسب \fIdefault_tag\fR برای برجسته‌سازی علامت‌گذاری می‌شوند\&. سبک نحوی با نام \fIname\fR را می‌توان با حذف \fIinitial_state\fR و \fIdefault_tag\fR حذف کرد\&. .RE .PP \fBsyntax_files \fR\fB\fIname\fR\fR\fB \fR\fB[\fIpattern\fR]\fR .RS 4 مشخص می‌کند فایل‌هایی با نام مطابق با \fIpattern\fR باید با استفاده از سبک نحوی با نام \fIname\fR برجسته شوند\&. الگوهای مورد استفاده برای تطبیق فایل‌ها جهت استفاده با سبک نحوی \fIname\fR را می‌توان با حذف \fIpattern\fR حذف کرد\&. .RE .PP \fBsyntax_magic \fR\fB\fIname\fR\fR\fB \fR\fB[\fIpattern\fR [ignorecase]]\fR .RS 4 مشخص می‌کند فایل‌هایی که خط اول آن‌ها با \fIpattern\fR مطابقت دارد، باید با استفاده از سبک نحوی با نام \fIname\fR برجسته شوند\&. الگوهای مورد استفاده برای تطبیق فایل‌ها جهت استفاده با سبک نحوی با نام \fIname\fR را می‌توان با حذف \fIpattern\fR حذف کرد\&. .RE .PP \fBsyntax_pattern \fR\fB\fIname\fR\fR\fB \fR\fB\fIinitial_state\fR\fR\fB \fR\fB\fIfinal_state\fR\fR\fB \fR\fB\fItag\fR\fR\fB \fR\fB\fIpattern\fR\fR\fB \fR\fB[ignorecase]\fR .RS 4 الگویی را به سبک نحویِ قبلاً اعلان‌شده اضافه می‌کند\&. الگوها به ترتیبی که اعلان شده‌اند یک‌به‌یک بررسی می‌شوند تا اولین تطابق پیدا شود\&. یک الگو تنها زمانی برای تطبیق نویسه‌ها به کار می‌رود که ماشین حالت در وضعیت \fIinitial_state\fR باشد\&. در صورت تطابق با الگوی تعریف‌شده توسط \fIpattern\fR، ماشین حالت به وضعیت \fIfinal_state\fR تغییر وضعیت می‌دهد\&. اگر \fBignorecase\fR مشخص شده باشد، تطبیق الگو بدون حساسیت به حروف بزرگ و کوچک انجام خواهد شد\&. تمام نویسه‌های منطبق بر الگو با برچسب \fItag\fR برای برجسته‌سازی علامت‌گذاری خواهند شد\&. .RE .SH "فایل‌ها (FILES)" .PP فایل‌های زیر توسط Diffuse استفاده می‌شوند: .PP /etc/diffuserc .RS 4 راه‌اندازی‌های اولیه سراسری سیستم (%INSTALL_DIR%\ediffuserc در مایکروسافت ویندوز) .RE .PP /usr/share/diffuse/syntax/*\&.syntax .RS 4 فایل‌های نحو برای زبان‌های گوناگون (%INSTALL_DIR%\esyntax\e*\&.syntax در مایکروسافت ویندوز) .RE .PP ~/\&.config/diffuse/diffuserc .RS 4 راه‌اندازی‌های اولیه شخصی شما (%HOME%\e\&.config\ediffuse\ediffuserc در مایکروسافت ویندوز) .RE .PP ~/\&.config/diffuse/prefs .RS 4 تنظیمات ذخیره‌شده شما (%HOME%\e\&.config\ediffuse\eprefs در مایکروسافت ویندوز) .RE .PP ~/\&.local/share/diffuse/state .RS 4 داده‌های ماندگار بین نشست‌ها (%HOME%\e\&.local\eshare\ediffuse\estate در مایکروسافت ویندوز) .RE .SH "نویسنده (AUTHOR)" .PP برنامه Diffuse توسط Derrick Moser نوشته شده است\&. .PP \(co 2006\-2014 Derrick Moser\&. کلیه حقوق محفوظ است\&. .SH "کپی‌رایت و تکثیر (COPYING)" .PP برنامه Diffuse نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط GNU General Public License منتشرشده توسط بنیاد نرم‌افزار آزاد (Free Software Foundation) بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه 2 مجوز و چه (به انتخاب خودتان) هر نسخه بعدی آن\&.