'\" t
.\"
.\" Copyright (c) 1994  X Consortium
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.TH XEDIT 1 "xedit 1.2.5" "X Version 11"
.SH "نام (NAME)"
xedit \- ویرایشگر متن ساده برای X
.SH "سینتکس (SYNTAX)"
.B xedit
[
.I \-toolkitoption
\&.\|.\|. ] [
.I filename
\&.\|.\|. ]
.SH "توضیحات (DESCRIPTION)"
.B Xedit
پنجره‌ای شامل چهار بخش زیر را فراهم می‌کند:
.IP "بخش دستورها" 25
مجموعه‌ای از دستورها که به شما امکان خروج از \fBxedit\fP، ذخیره فایل یا بارگذاری فایلی جدید در پنجره ویرایش را می‌دهد.
.IP "پنجره پیام" 25
پیام‌های \fBxedit\fP را نمایش می‌دهد. علاوه بر این، این پنجره می‌تواند به عنوان چرک‌نویس نیز استفاده شود.
.IP "نمایش نام فایل"
نام فایلی را که در حال حاضر ویرایش می‌شود و اینکه آیا این فایل \fIRead-Write\fP (خواندنی-نوشتنی) است یا \fIRead Only\fP (فقط‌خواندنی)، نمایش می‌دهد.
.IP "پنجره ویرایش" 25
متن فایلی را که در حال ویرایش یا ایجاد آن هستید نمایش می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.I Xedit
تمامی گزینه‌های استاندارد خط فرمان X Toolkit را می‌پذیرد (نگاه کنید به
.IR X (7)).
ترتیب گزینه‌های خط فرمان اهمیتی ندارد.
.TP 8
.I filename
فایل(هایی) را مشخص می‌کند که باید هنگام راه‌اندازی بارگذاری شوند. این همان فایلی است که ویرایش خواهد شد. اگر فایلی مشخص نشود،
.I xedit
به شما امکان می‌دهد پس از راه‌اندازی، فایل‌ها را بارگذاری کرده یا فایل‌های جدید ایجاد کنید.
.SH "ویرایش (EDITING)"
ویجت متنی Athena برای سه بخش از این برنامه که اجازه ورود متن را می‌دهند استفاده می‌شود. نویسه‌های تایپ‌شده به ویجت متنی منتقل خواهند شد که فوکوس ورودی را دارد، یا ویجت متنی که مکان‌نمای اشاره‌گر در حال حاضر روی آن قرار دارد.
.PP

ترکیب کلیدهای زیر تعریف شده‌اند:
.sp
.TS
l l.
Ctrl-a	ابتدای خط
Meta-b	یک کلمه به عقب
Ctrl-b	یک نویسه به عقب
Meta-f	یک کلمه به جلو
Ctrl-d	حذف نویسه بعدی
Meta-i	درج فایل
Ctrl-e	انتهای خط
Meta-k	برش تا انتهای پاراگراف (Kill)
Ctrl-f	یک نویسه به جلو
Meta-q	قالب‌بندی پاراگراف
Ctrl-g	بازنشانی صفحه‌کلید
Meta-v	صفحه قبلی
Ctrl-h	حذف نویسه قبلی
Meta-y	درج بخش انتخاب‌شده
Ctrl-j	خط جدید با تورفتگی
Meta-z	یک خط پیمایش به پایین
Ctrl-k	برش تا انتهای خط (Kill)
Meta-d	حذف کلمه بعدی
Ctrl-l	بازترسیم صفحه نمایش
Meta-D	برش کلمه (Kill)
Ctrl-m	خط جدید
Meta-h	حذف کلمه قبلی
Ctrl-n	خط بعدی
Meta-H	برش کلمه قبلی (Kill)
Ctrl-o	خط جدید و بازگشت به عقب
Meta-<	ابتدای فایل
Ctrl-p	خط قبلی
Meta->	انتهای فایل
Ctrl-r	جستجو/جایگزینی رو به عقب
Meta-]	یک پاراگراف به جلو
Ctrl-s	جستجو/جایگزینی رو به جلو
Meta-[	یک پاراگراف به عقب
Ctrl-t	جابه‌جایی نویسه‌ها
Ctrl-u [\fInumber\fP]	ضرب در ۴ یا \fInumber\fP
Meta-Delete	حذف کلمه قبلی
Ctrl-v	صفحه بعدی
Meta-Shift Delete	برش کلمه قبلی (Kill)
Ctrl-w	برش بخش انتخاب‌شده (Kill)
Meta-Backspace	حذف کلمه قبلی
Ctrl-y	بازگردانی برش (Unkill)
Meta-Shift Backspace	برش کلمه قبلی (Kill)
Ctrl-z	یک خط پیمایش به بالا
Meta-z	یک خط پیمایش به پایین
Ctrl-_	واگرد (Undo)
Escape	حالت ویرایش خط
.TE
.sp
علاوه بر این، می‌توان از اشاره‌گر برای برش و چسباندن (cut و paste) متن استفاده کرد:
.TS
l l.
Button 1 Down	شروع انتخاب
Button 1 Motion	تنظیم انتخاب
Button 1 Up	پایان انتخاب (cut)

Button 2 Down	درج انتخاب فعلی (paste)

Button 3 Down	گسترش انتخاب فعلی
Button 3 Motion	تنظیم انتخاب
Button 3 Up	پایان انتخاب (cut)
.TE
.sp.SH "حالت ویرایش خط (LINE EDIT MODE)"
.I "حالت ویرایش خط"
چندین دستور میان‌بُر را برای جست‌وجو و جایگزینی متن در بافر
xedit
فعال می‌کند. دستورهای
.I "حالت ویرایش خط"
قالب زیر را دارند:
.br
.nf

	[\fIline-number\fP[,\fIline-number\fP]]\fIcommand\fP[\fIparameters\fP]

.fi
.I "شماره خط"
می‌تواند به صورت‌های زیر مشخص شود:
.TP 8
\&.
خط متنی جاری.
.TP 8
$
آخرین خط فایل.
.TP 8
number
شماره خط به‌صورت صریح \fInumber\fP.
.TP 8
- or ^
خط قبلی. معادل با \fI\-1\fP.
.TP 8
\-number or ^number
خط جاری منهای \fInumber\fP.
.TP 8
+
خط بعدی. معادل با \fI+1\fP.
.TP 8
+number
خط جاری به‌علاوه \fInumber\fP.
.TP 8
, or %
از اولین تا آخرین خط. معادل با \fI1,$\fP.
.TP 8
;
از خط جاری تا آخرین خط. معادل با \fI.,$\fP.

.PP
.I "دستور"
می‌تواند به صورت‌های زیر مشخص شود:
.TP 8
s
جایگزینی متن در خط‌های مشخص‌شده.
.TP 8
/re/
جست‌وجوی رو به جلو برای الگوی عبارت باقاعده \fIre\fP.
.TP 8
?re?
جست‌وجوی رو به عقب برای الگوی عبارت باقاعده \fIre\fP.

.PP
.I "پارامترها"
می‌توانند به صورت‌های زیر مشخص شوند:
.TP 8
/re/
به عنوان پارامتری برای \fIi\fP یا به عنوان یک دستور عمل می‌کند.
.TP 8
/re/text/
جست‌وجوی رو به جلو برای \fIre\fP و جایگزینی آن با \fItext\fP.

.PP
.I "گزینه‌ها"
می‌توانند در ادامه بیایند یا به عنوان پارامتر باشند؛ مقادیر شناخته‌شده عبارتند از:
.TP 8
i
جست‌وجوی غیرحساس به حروف بزرگ و کوچک.
.TP 8
g
تطابق سراسری (\fIGlobal\fP) هنگام جایگزینی متن. در صورت عدم تعیین، فقط n-امین مورد تطابق (که پیش‌فرض آن ۱ است) جایگزین خواهد شد.
.TP 8
c
تأیید گرفتن (\fIConfirm\fP) پیش از جایگزینی متن.
.TP 8
number
تنها رخدادی که توسط \fInumber\fP مشخص شده جایگزین شود.
.PP

دستورها نگارش‌های گوناگونی را می‌پذیرند، به عنوان مثال:
.br
.nf
	/pattern/i
	i/pattern/
	i/pattern
.fi
جست‌وجوی رو به جلو برای \fIpattern\fP.
.br
.nf

	,sc/pattern/text
	,sc/pattern/text/
	,s/pattern/text/c
.fi
جست‌وجوی کل بافر و درخواست تأیید برای جایگزینی \fIpattern\fP
با \fItext\fP.
.br
.nf

	,s/pattern/text/number
.fi
جایگزینی تطابق شماره \fInumber\fP در خط متنی. در صورت عدم تعیین،
پیش‌فرض بر روی اولین رخداد است.

.PP
هنگام جست‌وجوی متن، برای رفتن به تطابق بعدی <Return> را بزنید.
هنگام جایگزینی تعاملی متن، برای پذیرش تغییر کلید \fIy\fP یا \fIY\fP را بزنید، و برای نادیده گرفتن آن و رفتن به تطابق بعدی کلید \fIn\fP یا \fIN\fP را وارد کنید..SH "دستورها (COMMANDS)"
.IP Quit 8
از نشست ویرایش فعلی خارج می‌شود. اگر تغییراتی ذخیره نشده باشند،
.I xedit
پیام هشداری نمایش می‌دهد و به کاربر امکان می‌دهد آن‌ها را ذخیره کند.
.IP Save
اگر پشتیبان‌گیری از فایل فعال باشد (بخش «منابع (RESOURCES)» در زیر را ببینید)،
.I xedit
رونوشتی از فایل اصلی و ویرایش‌نشده را در <prefix>\fIfile\fP<suffix> ذخیره می‌کند،
سپس \fIfile\fP را با محتویات پنجرهٔ ویرایش بازنویسی می‌نماید. نام فایل مستقیماً از ویجت متنی (Text widget) واقع در سمت راست دکمهٔ \fILoad\fP دریافت می‌شود.
.IP Load
فایلی را که نام آن در ویجت متنی بلافاصله سمت راست این دکمه آمده است بارگیری کرده و آن را در پنجرهٔ Edit نمایش می‌دهد.
.SH "منابع (RESOURCES)"
برای \fBxedit\fP منابع موجود عبارتند از:
.TP 8
.B tagsName (\fPClass\fB TagsName)
نام فایل tags را جهت جستجو هنگام بارگیری فایل جدید تعیین می‌کند.
مقدار پیش‌فرض \fItags\fP است.
.TP 8
.B loadTags (\fPClass\fB LoadTags)
مقداری بولی برای فعال یا غیرفعال کردن جستجو برای فایل‌های tags.
پیش‌فرض \fITrue\fP است.
.TP 8
.B enableBackups (\fPClass\fB EnableBackups)
مشخص می‌کند که هنگام ذخیرهٔ ویرایش‌های انجام‌شده روی یک فایل موجود،
.I xedit
پیش از ذخیرهٔ تغییرات، نسخهٔ اصلی آن فایل را در <prefix>\fIfile\fP<suffix> کپی کند. مقدار پیش‌فرض برای این منبع
``on''
است که بیانگر ضرورت ایجاد نسخه‌های پشتیبان است.
.TP 8
.B backupNamePrefix (\fPClass\fB BackupNamePrefix)
رشته‌ای را مشخص می‌کند که باید به ابتدای نام فایل پشتیبان اضافه شود. پیش‌فرض این است که هیچ رشته‌ای اضافه نشود.
.TP 8
.B backupNameSuffix (\fPClass\fB BackupNameSuffix)
رشته‌ای را مشخص می‌کند که باید به انتهای نام فایل پشتیبان اضافه شود. پیش‌فرض، استفاده از
``~''
به عنوان پسوند است.
.TP 8
.B positionFormat (\fPClass\fB Format)
رشتهٔ قالبی را مشخص می‌کند که برای نمایش موقعیت مکان‌نما به کار می‌رود. این رشته از ساختاری شبیه به printf(3) استفاده می‌کند، که در آن
.B %l
شماره خط،
.B %c
شماره ستون،
.B %p
آفست موقعیت درج، و
.B %s
اندازهٔ فعلی فایل را چاپ می‌کند. همچنین امکان تعیین اندازهٔ فیلدها با ساختار
.B %\-?[0\-9]+
نیز وجود دارد. رشتهٔ قالب پیش‌فرض ``L%l'' است که نویسهٔ ``L'' و در ادامه شماره خط را نشان می‌دهد.
.TP 8
.B hints (\fPClass\fB Hints)
فهرستی از رشته‌ها را مشخص می‌کند که با خطوط جدید (newline) از هم جدا شده‌اند و در پنجرهٔ bc_label نمایش داده خواهند شد.
.TP 8
.B hintsInterval (\fPClass \fBInterval)
بازهٔ زمانی را بر حسب ثانیه مشخص می‌کند که طی آن رشتهٔ راهنما در پنجرهٔ bc_label تغییر خواهد کرد.
.TP 8
.B changedBitmap (\fPClass \fBBitmap)
نام نگاشت بیتی (Bitmap) را تعیین می‌کند که هنگام تغییر فایل در حال ویرایش، در fileMenu نمایش داده می‌شود.
.TP 8
.B autoReplace (\fPClass \fBReplace)
این منبع برای تصحیح خودکار اشتباهات املایی رایج مفید است، اما همچنین می‌تواند برای ایجاد ماکروهای ساده استفاده شود. قالب به صورت
\fI{non-blanks}{blanks}[{string}]\fP است. فیلدها با خطوط جدید از هم جدا می‌شوند.
مثالی از استفاده:
\"
.br
.nf
nto	  not\\n\\
/macro some long string with \\\\\\n newlines \\\\\\n
.fi
\"
.br
هنگام تایپ این کلمات، به طور خودکار کلمهٔ \fInto\fP با \fInot\fP و \fI/macro\fP با
\fIsome long string with
 newlines
\fP
جایگزین خواهد شد.
.TP 8
.B ispell.dictionaries (\fPClass \fBispell.Dictionary)
فهرستی از نام‌های واژه‌نامه را مشخص می‌کند که با فاصله از هم جدا شده‌اند و در دسترس برنامهٔ ispell هستند. مقدار پیش‌فرض \fI"american americamed+ english"\fP است.
.TP 8
.B ispell.dictionary (\fPClass \fBispell.Dictionary)
واژه‌نامه پیش‌فرض جهت استفاده را مشخص می‌کند.
.TP 8
.B ispell*<DICTIONARY>.wordChars (\fPClass \fBispell*Chars)
مجموعه‌ای از نویسه‌ها را تعیین می‌کند که می‌توانند بخشی از یک کلمهٔ معتبر باشند. فیلد \fI<DICTIONARY>\fP یکی از واژه‌نامه‌های مشخص‌شده در منبع \fIdictionaries\fP است.
.TP 8
.B ispell.ispellCommand (\fPClass \fBispell.CommandLine)
مسیر برنامهٔ \fBispell\fP و احتمالاً آرگومان‌های اضافی.
نیازی به تعیین گزینهٔ \fB\-w\fP یا گزینهٔ \fB\-a=\fP ندارید.
برای اطلاعات بیشتر در مورد گزینه‌های \fBispell\fP به صفحه راهنمای
.BR ispell (1)
مراجعه کنید.
.TP 8
.B ispell.formatting (\fPClass \fPispell.TextFormat)
قالب‌بندی متنی مورد استفاده هنگام غلط‌یابی املایی فایل را مشخص می‌کند. قالب‌های موجود \fItext\fP و \fIhtml\fP هستند.
.TP 8
.B ispell*text.skipLines (\fPClass \fBispell*text.Skip)
خطوطی که با یکی از نویسه‌های این رشته شروع می‌شوند، غلط‌یابی نخواهند شد. این منبع فقط در حالت \fItext\fP استفاده می‌شود.
.TP 8
.B ispell.terseMode (\fPClass \fBispell.Terse)
در صورت فعال بودن، \fBispell\fP را در حالت خلاصه اجرا می‌کند و برای کلمات ایجادشده از طریق ترکیب کلمات (هنگام استفاده از گزینهٔ \fBispel \-C\fP) یا کلمات ایجادشده از طریق حذف وند، تعاملی از کاربر درخواست نمی‌کند.
مقدار پیش‌فرض False است.
.TP 8
.B ispell.lookCommand (\fPClass \fBispell.CommandLine)
مسیر برنامه برای جستجوی کلمات جایگزین، و احتمالاً، آرگومان‌های اضافی. برنامهٔ پیش‌فرض مورد استفاده \fI/usr/bin/egrep\fP است.
.TP 8
.B ispell.wordsFile (\fPClass \fBispell.Words)
مسیر فایل(ها) برای جستجوی کلمات جایگزین. فایل پیش‌فرض \fI/usr/share/dict/words\fP است.
.TP 8
.B ispell.guessLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که ispell فهرستی حدسی از یک یا چند کلمه را برمی‌گرداند. مقدار پیش‌فرض \fIGuess\fP است.
.TP 8
.B ispell.missLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که ispell فهرستی از یک یا چند کلمه را برای تطبیق با کلمهٔ دارای اشتباه املایی برمی‌گرداند. مقدار پیش‌فرض \fIMiss\fP است.
.TP 8
.B ispell.rootLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمه در واژه‌نامه موجود نیست، اما می‌تواند از طریق یک کلمهٔ ریشه ساخته شود. مقدار پیش‌فرض \fIRoot:\fP است و به دنبال آن یک فاصله و کلمهٔ ریشه می‌آید.
.TP 8
.B ispell.noneLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که هیچ مورد مشابهی وجود ندارد. مقدار پیش‌فرض \fINone\fP است.
.TP 8
.B ispell.compoundLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمهٔ در حال بررسی از الحاق دو کلمه تشکیل شده باشد. مقدار پیش‌فرض \fICompound\fP است.
.TP 8
.B ispell.okLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell نمایش داده می‌شود، هنگامی که کلمهٔ بررسی‌شده در واژه‌نامه موجود است. این رشته تنها هنگام استفاده از دکمهٔ \fIcheck\fP در رابط ispell برنامهٔ xedit نمایش داده می‌شود. مقدار پیش‌فرض \fIOk\fP است.
.TP 8
.B ispell.eofLabel (\fPClass \fBispell.Status)
رشته‌ای که پس از رسیدن به انتهای فایل در نوار وضعیت ispell نمایش داده می‌شود. مقدار پیش‌فرض \fIEnd Of File\fP است.
.TP 8
.B ispell.repeatLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell هنگامی که دو کلمهٔ یکسان در کنار یکدیگر در فایل پیدا شوند، نمایش داده می‌شود. مقدار پیش‌فرض \fIRepeat\fP است.
.TP 8
.B ispell.lookLabel (\fPClass \fBispell.Status)
رشته‌ای که پس از نمایش نتایج دستور \fILook\fP در نوار وضعیت ispell نمایش داده می‌شود. اگر هیچ نتیجه‌ای یافت نشود، مقدار منبع \fIispell.noneLabel\fP نشان داده می‌شود.
.TP 8
.B ispell.workingLabel (\fPClass \fBispell.Status)
رشته‌ای که در نوار وضعیت ispell هنگام ارتباط xedit با ispell نمایش داده می‌شود. مقدار پیش‌فرض \fI...\fP است..SH "ویجت‌ها (WIDGETS)"
به‌منظور مشخص‌کردن منابع،
دانستن سلسله‌مراتب ویجت‌هایی که \fBxedit\fR را تشکیل می‌دهند مفید است.
در نشانه‌گذاری زیر، تورفتگی بیانگر ساختار سلسله‌مراتبی است.
ابتدا نام کلاس ویجت و سپس نام نمونهٔ ویجت آورده شده است.
.sp
.nf
.ft CW
Xedit  xedit
        Paned  paned
                Paned  buttons
                        Command  quit
                        Command  save
                        Command  load
                        Text     filename
                Label  bc_label
                Text   messageWindow
                Label  labelWindow
                Text   editWindow
.ft
.fi
.sp
.SH "محیط (ENVIRONMENT)"
.PP
.TP 20
.B DISPLAY
برای به‌دست آوردن میزبان و شمارهٔ نمایشگر پیش‌فرض.
.TP 20
.B XENVIRONMENT
برای به‌دست آوردن نام فایل منبعی که جایگزین منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER می‌شود.
.SH "فایل‌ها (FILES)"
.TP 20
.I /usr/share/X11/app-defaults/Xedit
منابع مورد نیاز را مشخص می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR xrdb (1),
.BR X (7),
.I "Athena Widget Set"
.SH "محدودیت‌ها (RESTRICTIONS)"
.B Xedit
جایگزینی برای
.BR Emacs
نیست.
.SH "نویسندگان (AUTHORS)"
Chris D. Peterson, MIT X Consortium
.br
Paulo Cesar Pereira de Andrade, The XFree86 Project