.TH MEV 1 "فوریه ۱۹۹۵"
.UC 4
.SH "نام (NAME)"
mev \- برنامه‌ای برای گزارش رویدادهای ماوس
.SH "خلاصه دستور (SYNOPSIS)"
.B mev
[
.I گزینه‌ها
]
.br
.SH "توضیحات (DESCRIPTION)"
برنامه
.B mev
بخشی از بسته
.B gpm
است. اطلاعات زیر از پرونده texinfo، که منبع مرجع اطلاعات است، استخراج شده است.

.LP
برنامه
.B mev
از روی
.B xev
الگوبرداری شده است. این برنامه رویدادهای کنسول ماوس را که دریافت می‌کند در خروجی استاندارد (stdout) چاپ می‌نماید.

.LP
رفتار پیش‌فرض
.B mev
دریافت تمام رویدادها است، اما می‌توان از سوییچ‌های خط فرمان برای تنظیم فیلدهای مختلف در ساختار
.B Gpm_Connect
به‌منظور سفارشی‌سازی رفتار برنامه استفاده کرد. من از
.B mev
برای مدیریت رویدادهای ماوس در Emacs استفاده می‌کنم.

.LP
سوییچ‌های خط فرمان برای
.B mev
به شرح زیر هستند:
.TP
\-C \fBnumber\fP
یک کنسول مجازی را برای دریافت رویدادها از آن انتخاب می‌کند.
این گزینه برای اهداف اشکال‌زدایی در نظر گرفته شده است.
.TP
\-d \fBnumber\fP
یک ماسک پیش‌فرض انتخاب می‌کند. به‌طور پیش‌فرض سرور هر رویدادی را
که متعلق به ماسک رویداد نباشد دریافت می‌کند. ماسک می‌تواند به صورت
یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.
.TP
\-e \fBnumber\fP
ماسک رویداد را انتخاب می‌کند. به‌طور پیش‌فرض هر رویدادی دریافت
می‌شود. ماسک می‌تواند به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.
.TP
\-E
ورود به حالت emacs. در حالت emacs، رویدادها به جای اعداد به صورت
فرم‌های lisp گزارش می‌شوند. این همان قالبی است که توسط بسته
t-mouse در emacs استفاده می‌شود.
.TP
\-f
محدود و متناسب کردن رویدادها در داخل صفحه پیش از گزارش آن‌ها. این گزینه
رویدادهای کشیدن (drag) را که اجازه خروج از حاشیه صفحه را دارند، دوباره در محدوده صفحه تنظیم می‌کند.
.TP
\-i
حالت تعاملی. ورودی را از stdin برای تغییر پارامترهای اتصال می‌پذیرد.
.TP
\-m \fBnumber\fP
حداقل ماسک کلید تبدیل (modifier) را انتخاب می‌کند. هر رویدادی با
کلیدهای تبدیل کمتر به mev گزارش نخواهد شد. مقدار پیش‌فرض آن 0 است.
ماسک باید یا به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.
.TP
\-M \fBnumber\fP
حداکثر ماسک کلید تبدیل (modifier) را انتخاب می‌کند. هر رویدادی با
کلیدهای تبدیل بیشتر از مقدار مشخص‌شده به mev گزارش نخواهد شد.
مقدار پیش‌فرض آن \~~0 است، یعنی تمام رویدادها دریافت می‌شوند.
ماسک باید یا به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.
.TP
\-p
درخواست ترسیم نشانگر ماوس در طول کشیدن (drag). این گزینه توسط
emacs برای جلوگیری از فراخوانی ()ioctl از کدهای lisp استفاده می‌شود.

.LP
هنگامی که آرگومان‌ها اعداد صحیح ده‌دهی نباشند، به عنوان فهرستی
از نویسه‌های حرفی-عددی در نظر گرفته می‌شوند که با یک نویسه غیرحرفی-عددی
از یکدیگر جدا شده‌اند. من از کاما (,) استفاده می‌کنم، اما هر نویسه دیگری نیز مجاز است.

.LP
نام‌های مجاز برای رویدادها عبارتند از:
.BR move ،
.BR drag ،
.B down
یا
.BR press ،
.B up
یا
.BR release ،
.B motion
(که شامل هر دو رویداد
.B move
و
.B drag
است) و
.BR hard .

.LP
نام‌های مجاز برای کلیدهای تبدیل (modifiers) عبارتند از:
.BR shift ،
.BR leftAlt ،
.BR rightAlt ،
.B anyAlt
(یکی یا دیگری) و
.BR control .

.LP
هنگامی که سوییچ
.B \-i
مشخص شود،
.B mev
به جای رویدادها، به ورودی استاندارد خود به عنوان خطوط فرمان نگاه می‌کند.
خطوط ورودی تجزیه می‌شوند و دستورهای
.B push
و
.B pop
شناسایی می‌گردند.

.LP
سپس دستور
.B push
گزینه‌های
.BR \-d ،
.BR \-e ،
.B \-m
و
.B \-M
را با همان معانی توصیف‌شده در بالا می‌پذیرد. گزینه‌های مشخص‌نشده
مقدار قبلی خود را حفظ می‌کنند و ماسک‌های حاصل برای بازگشایی مجدد
اتصال با سرور استفاده می‌شوند. از
.B pop
برای خارج کردن از پشته اتصال استفاده می‌شود. اگر روی یک پشته خالی عمل pop انجام شود،
برنامه خارج می‌شود.

.LP
سایر دستورهای شناسایی‌شده عبارتند از:
.B info
که برای بازگرداندن عمق پشته استفاده می‌شود؛
.B quit
برای خاتمه پیش از موعد برنامه؛ و
.B snapshot
برای دریافت برخی از اطلاعات پیکربندی از سرور.

.LP
.SH "اشکالات (BUGS)"
از نسخه 1.16 به بعد،
.B mev
دیگر تحت
.B xterm
کار نمی‌کند. لطفاً از برنامه
.B rmev
(ارائه‌شده در پوشه
.BR sample )
برای مشاهده رویدادهای gpm در
.B xterm
یا
.B rxvt
استفاده کنید. برنامه
.B rmev
علاوه بر رویدادهای ماوس، رویدادهای صفحه‌کلید را نیز نمایش می‌دهد.

.LP
.SH "نویسندگان (AUTHORS)"
Alessandro Rubini <rubini@linux.it>
.br
Ian Zimmerman <itz@speakeasy.org>

.LP
.SH "فایل‌ها (FILES)"
.nf
/dev/gpmctl سوکت مورد استفاده برای اتصال به gpm.
.fi

.LP
.SH "همچنین ببینید (SEE ALSO)"
.nf
\fB gpm(8) \fP      سرور ماوس
\fB gpm-root(1) \fP گرداننده‌ای برای رویدادهای Control-Mouse.

.fi
پرونده info درباره `gpm` که اطلاعات کامل‌تری ارائه می‌دهد و نحوه نوشتن یک کلاینت gpm را توضیح می‌دهد.