.TH E3 1

.SH "نام (NAME)"
E3 \- یک ویرایشگر متنی کوچک

.SH "خلاصه دستور (SYNOPSIS)"
.B e3[ws|em|pi|vi|ne]
[\fifilename]

.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fIe3\fP یک برنامه کوچک و کامل است که به طور کامل به زبان اسمبلی نوشته شده است و اندازه کد آن کمتر از ۱۰۰۰۰ بایت است. این ویرایشگر دارای یک خط وضعیت و ورودی است که در آن می‌توانید نام فایل‌ها، نام بلوک‌ها، متن‌های مورد جستجو و شماره خطوط را وارد کنید. دستورهای این ویرایشگر مشابه خانواده‌های ویرایشگرهای شبیه به \fIWordstar\fP یا \fIEmacs\fP یا \fIPico\fP یا \fIvi\fP یا \fINedit\fP هستند. برای راهنمای برخط در حالت vi کلیدهای ESC:h و در غیر این صورت Alt-H را فشار دهید. این صفحه راهنما تنها به توضیح کلیدهای میانبر Wordstar می‌پردازد.

.SH "دستورهای صفحه‌کلید برای WS (KEYBOARD COMMANDS FOR WS)"
.PP
.TP
\fB^A
رفتن به کلمه قبلی (چپ)
.TP
\fB^C
رفتن به یک صفحه پایین
.TP
\fB^D
رفتن به راست
.TP
\fB^E
رفتن به بالا
.TP
\fB^F
رفتن به کلمه بعدی (راست)
.TP
\fB^G
حذف نویسه فعلی
.TP
\fB^H
حذف نویسه قبلی (سمت چپ)
.TP
\fB^I
تب (Tabulator)
.TP
\fB^J
دریافت راهنمای برخط
.TP
\fB^KB
نشانه‌گذاری آغاز بلوک
.TP
\fB^KC
رونوشت از بلوک فعلی
.TP
\fB^KD
ذخیره فایل و بارگذاری یک فایل جدید
.TP
\fB^KK
نشانه‌گذاری پایان بلوک
.TP
\fB^KQ
لغو ویرایش و خروج. برای تأیید از دست رفتن تغییرات با Y یا y پاسخ دهید.
.TP
\fB^KR
درج یک فایل به‌عنوان بلوک جدید
.TP
\fB^KS
ذخیره فایل و ادامه ویرایش
.TP
\fB^KV
جابه‌جایی بلوک فعلی درون فایل
.TP
\fB^KW
ذخیره یک بلوک درون یک فایل
.TP
\fB^KX
ذخیره فایل و خروج
.TP
\fB^KY
حذف یک بلوک متنی
.TP
\fB^KZ
تعلیق (در دیگر حالت‌های ویرایشگر، همان ^Z ساده است)
.TP
\fB^L
تکرار آخرین ^QF یا ^QA
.TP
\fB^M
ایجاد خط جدید
.TP
\fB^QA
جستجو و جایگزینی (یک اعلان ظاهر می‌شود). برای گزینه‌ها به ^QF مراجعه کنید.
.TP
\fB^QB
رفتن به آغاز بلوک
.TP
\fB^QC
رفتن به انتهای فایل
.TP
\fB^QD
رفتن به انتهای خط
.TP
\fB^QE
رفتن به بالای صفحه: ستون اول، خط اول
.TP
\fB^QF
یافتن یک رشته متنی (یک اعلان ظاهر می‌شود). گزینه‌های معتبر عبارتند از: \fIC\fP (حساس به بزرگ و کوچکی حروف) و \fIB\fP (جستجو به سمت عقب). می‌توانید با فشردن ^U عملیات را لغو کنید. این گزینه‌ها با \fIe3em\fP، \fIe3pi\fP و \fIe3ne\fP یکسان هستند، اما کلید لغو در آن‌ها ^G و ^C است.
.TP
\fB^QG
حذف نویسه زیر مکان‌نما
.TP
\fB^QG
حذف نویسه سمت چپ مکان‌نما
.TP
\fB^QH,^Q(Del)
حذف تا ابتدای خط
.TP
\fB^QI
رفتن به شماره خط (اعلان ظاهر می‌شود)
.TP
\fB^QK
رفتن به پایان بلوک
.TP
\fB^QR
رفتن به ابتدای فایل
.TP
\fB^QS
رفتن به ابتدای خط
.TP
\fB^QV
رفتن به آخرین موقعیت جستجو
.TP
\fB^QW
رفتن به کلمه قبلی
.TP
\fB^QX
رفتن به پایین پنجره (آخرین خط، انتهای خط)
.TP
\fB^QY
حذف تا انتهای خط
.TP
\fB^QZ
رفتن به کلمه بعدی
.TP
\fB^R
رفتن به یک صفحه بالا
.TP
\fB^S
رفتن به چپ
.TP
\fB^T
حذف تا کلمه بعدی
.TP
\fB^U
واگردانی (Undo) آخرین عملیات. همچنین لغو ورودی در خط وضعیت (برای دستورهایی نظیر ^QI، ^QF، ^KR، ^KW و غیره استفاده می‌شود)
.TP
\fB^V
تغییر وضعیت حالت درج (Insert mode)
.TP
\fB^W
پیمایش به بالا
.TP
\fB^X
رفتن به پایین
.TP
\fB^Y
حذف خط فعلی
.TP
\fB^Z
پیمایش به پایین.SH "جزئیات عملیات واگردانی (UNDO OPERATION DETAILS)"
.PP
ویرایشگر \fIe3\fP از نسخهٔ v2.2 دارای حالت واگردانی (UNDO) است. هیچ تعداد
از پیش تعیین‌شده‌ای برای سطوح UNDO وجود ندارد. شما می‌توانید انتظار واگردانی دست‌کم
\fIیک\fP عملیات درج (insert)، حذف (delete)، بازنویسی (overwrite) یا sed_pipe اخیر را داشته باشید،
اما در بیشتر موارد مراحل واگردانی \fIبسیاری\fP در دسترس است. e3 یک بافر واگردانی با اندازهٔ
ثابت دارد و اگر حجم داده‌های حذف‌شده از اندازهٔ بافر واگردانی بزرگ‌تر باشد، از یک فایل کمکی
خارجی استفاده خواهد کرد. این بافر به صورت حلقوی سازمان‌دهی شده است و در صورت لزوم،
اطلاعات قدیمی‌تر واگردانی را بازنویسی می‌کند. بنابراین هیچ‌گاه نمی‌توان به طور دقیق گفت
چه تعداد عملیات واگردانی ممکن است.
برای استفاده از واگردانی یکی از کلیدهای زیر را فشار دهید:
.TP
\fB^U
در حالت Wordstar
.TP
\fB^QU
در حالت Pico
.TP
\fB^_
در حالت Emacs
.TP
\fBu
در حالت فرمان vi
.TP
\fB^U
در حالت Nedit

.SH "ماشین‌حساب داخلی (BUILT IN CALCULATOR)"
.PP
ویرایشگر \fIe3\fP برای انجام برخی محاسبات حسابی ساده در داخل متن شما،
یک ماشین‌حساب داخلی دارد. مکان‌نما را در ابتدای عبارت محاسباتی،
برای نمونه چیزی مانند:  -3.002*-(2--3)=   قرار دهید
و یکی از کلیدهای زیر را فشار دهید:
.TP
\fB^KN
در حالت Wordstar
.TP
\fB^QC
در حالت Pico
.TP
\fB^X^N
در حالت Emacs
.TP
\fB#
در حالت فرمان vi
.TP
\fB^K
در حالت Nedit
.PP
این کار نتیجه را درون متن درج خواهد کرد.
از مقادیر بین -999999999999.999999 ... 999999999999.999999
با حداکثر ۶ رقم اعشار و عملگرهای +-*/ و پرانتزهای ( ) استفاده کنید.
همچنین p برای مقدار ثابت عدد پی (PI) و r برای دسترسی به نتیجهٔ
آخرین محاسبه در دسترس هستند.

.SH "تغییر حالت در زمان اجرا (RUNTIME MODE SWITCHING)"
.PP
شما می‌توانید با فشردن یکی از کلیدهای زیر به حالت ویرایشگر دیگری بروید:
.TP
\fB^KM
در حالت Wordstar
.TP
\fB^QM
در حالت Pico
.TP
\fBaltX
در حالت Emacs
.TP
\fB<ESC>;
در حالت فرمان vi
.TP
\fB^E
در حالت Nedit
.PP
ویرایشگر e3 اعلان \fISET MODE\fP را نمایش خواهد داد. اکنون یکی از گزینه‌های e3ws، e3em، e3pi، e3vi یا e3ne را برای تنظیم سبک ویرایشی شبیه به \fIWordstar\fP یا \fIEmacs\fP یا \fIPico\fP یا \fIvi\fP یا \fINedit\fP وارد کنید..SH "گزینه‌ها (OPTIONS)"
.PP
برنامه e3 یک نام فایل را برای ویرایش متن می‌پذیرد. حالت ویرایشگر بسته به نام باینری، به یکی از موارد \fIe3ws\fP، \fIe3em\fP، \fIe3pi\fP، \fIe3vi\fP یا \fIe3ne\fP تغییر می‌یابد.


.SH "فایل‌ها (FILES)"
.PP
.TP
\fBe3\fP
یک فایل اجرایی اسمبلی‌شده برای Linux، FreeBSD، NetBSD، OpenBSD، BeOS(tm) و QNX(tm) است.
\fIe3ws\fP، \fIe3em\fP، \fIe3pi\fP، \fIe3vi\fP و \fIe3ne\fP پیوندهای نمادین به e3 هستند.
.TP
\fBe3.exe\fP
یک فایل اجرایی اسمبلی‌شده برای نسخه‌های ۳۲ بیتی Win مانند 95/98/ME/etc است.
.TP
\fBe3c\fP
یک فایل اجرایی کامپایل‌شده به زبان 'C' برای برخی پلتفرم‌های دیگر است که به‌صورت اختیاری ساخته می‌شود و تنها از کلیدهای ترکیبی WS پشتیبانی می‌کند.
.TP
\fBe3arm\fP
یک فایل اجرایی اسمبلی‌شده آزمایشی جدید (کیفیت کد در سطح آلفا) برای ARM Linux است که به‌صورت اختیاری ساخته می‌شود (همانند e3، اما بدون محاسبات ریاضی و بدون قابلیت UNDO).
.TP
\fBe3.hlp\fP
فایل متنی راهنما (فقط برای e3c)
.TP
\fBe3.res\fP
فایل متنی پیام‌های خطا (فقط برای e3c)
.TP
\fBe3-16\fP
\fIe3-16\fP، \fIe3-16.com\fP و \fIe3-16e.exe\fP
فایل‌های ویژه اضافی برای سیستم‌عامل‌های ۱۶ بیتی
ELKS (==Embeddable Linux Kernel Subset) و DOS هستند
که تنها از کلیدهای ترکیبی WS پشتیبانی می‌کنند.

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر e3 متعلق است به (c) 2000,01,02,03 Albrecht Kleine

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است؛ چه نسخه ۲ پروانه یا (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو (GNU General Public License) مراجعه کنید.

شما باید به همراه این برنامه نسخه‌ای از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر مکاتبه کنید:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

.SH "گزارش باگ‌ها (BUGS)"
احتمالاً اشکالاتی وجود دارد، اما من هنوز از وجود آن‌ها اطلاعی ندارم.