.\"
.\" Copyright (c) 1988  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 XBIFF 1 2023-01-28 "xbiff 1.0.6" "X Version 11"
.SH "نام (NAME)"
xbiff \- نشانگر صندوق پستی برای X
.SH "خلاصه دستور (SYNOPSIS)"
.B xbiff
[ \-\fItoolkitoption\fP ... ] [ \fI\-option\fP ... ]
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B xbiff
تصویر کوچکی از یک صندوق پستی را نمایش می‌دهد.
هنگامی که نامه‌ای وجود ندارد، پرچم روی صندوق پستی پایین است.
وقتی نامه‌ای می‌رسد، پرچم بالا می‌رود و صندوق پستی بوق می‌زند.
به‌طور پیش‌فرض، فشردن هر کلید موشوار در تصویر،
\fBxbiff\fP را وادار می‌کند تا اندازهٔ فعلی فایل نامه را
به‌عنوان اندازهٔ «خالی» در نظر گرفته و پرچم را پایین بیاورد.
.SH "گزینه‌ها (OPTIONS)"
.B xbiff
تمام گزینه‌های خط فرمان استاندارد X Toolkit را به همراه
گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:
.TP 8
.B \-help
این گزینه مشخص می‌کند که خلاصه‌ای کوتاه از گزینه‌های مجاز باید در
خطای استاندارد چاپ شود.
.TP 8
.B \-update \fIseconds\fP
این گزینه بسامد به‌روزرسانی نمایشگر را برحسب ثانیه برای \fBxbiff\fP
مشخص می‌کند.
اگر صندوق پستی پوشانده شده و سپس نمایان شود، بلافاصله به‌روز خواهد شد.
پیش‌فرض 30 ثانیه است.
.TP 8
.B \-file \fIfilename\fP
این گزینه نام فایلی را که باید پایش شود مشخص می‌کند.
به‌طور پیش‌فرض، صندوق ورودی شما را در مکان پیش‌فرض سیستمتان پایش می‌کند
(چند نمونه عبارتند از
.RI /var/mail/ username ،
.RI /usr/spool/mail/ username ،
.RI /var/spool/mail/ username
که در آن
.I username
نام کاربری شما برای ورود است).
اگر متغیر محیطی \fBMAIL\fP تنظیم شده باشد،
فایل مشخص‌شده توسط آن پایش خواهد شد.
.TP 8
.B \-volume \fIpercentage\fP
این گزینه بلندی صدای زنگ را هنگام رسیدن نامهٔ جدید مشخص می‌کند.
این درصد نسبت به حجم صدای فعلی تنظیم‌شده در
.BR xset (1)
سنجیده می‌شود.
بنابراین 0 صدای معمولی است،
درصدهای منفی به سمت حداقل صدا (\-100 بی‌صدا)
و درصدهای مثبت به سمت حداکثر صدا (100 بلندترین) هستند.
.TP 8
.B \-shape
این گزینه مشخص می‌کند که پنجرهٔ صندوق پستی در صورت مشخص بودن
ماسک‌ها برای تصاویر خالی یا پر، باید شکل‌دهی (shaped) شود.
.TP 8
.B \-version
این گزینه مشخص می‌کند که \fBxbiff\fP باید نسخهٔ خود را چاپ کرده و خارج شود.
.PP
آرگومان‌های خط فرمان استاندارد X Toolkit زیر معمولاً با
.B xbiff
به کار می‌روند:
.TP 8
.B \-display \fIdisplay\fP
این گزینه سرور X را برای برقراری ارتباط مشخص می‌کند.
.TP 8
.B \-geometry \fIgeometry\fP
این گزینه اندازه و موقعیت ترجیحی پنجرهٔ صندوق پستی را تعیین می‌کند.
صندوق پستی ۴۸ پیکسل عرض و ۴۸ پیکسل ارتفاع دارد و در پنجره
وسط‌چین خواهد شد.
.TP 8
.B \-bg \fIcolor\fP
این گزینه رنگ مورد استفاده برای پس‌زمینهٔ پنجره را مشخص می‌کند.
.TP 8
.B \-bd \fIcolor\fP
این گزینه رنگ مورد استفاده برای حاشیهٔ پنجره را مشخص می‌کند.
.TP 8
.B \-bw \fInumber\fP
این گزینه عرض حاشیهٔ دور پنجره را برحسب پیکسل مشخص می‌کند.
.TP 8
.B \-fg \fIcolor\fP
این گزینه رنگ مورد استفاده برای پیش‌زمینهٔ پنجره را مشخص می‌کند.
.TP 8
.B \-rv
این گزینه مشخص می‌کند که ویدیوی معکوس (reverse video) باید با جابه‌جایی
رنگ‌های پیش‌زمینه و پس‌زمینه شبیه‌سازی شود.
.TP 8
.B \-xrm \fIresourcestring\fP
این گزینه رشتهٔ منبع مورد استفاده را مشخص می‌کند. این گزینه به‌ویژه
برای تنظیم منابعی که گزینهٔ خط فرمان جداگانه‌ای ندارند سودمند است.
.SH "پیش‌فرض‌های X (X DEFAULTS)"
نام کلاس برنامه \fBXBiff\fP است.
این برنامه از ویجت
.B Mailbox
استفاده می‌کند.
این ویجت تمام نام‌ها و کلاس‌های منابع اصلی و همچنین موارد زیر را
تشخیص می‌دهد:
.TP 8
.B checkCommand (\fPclass\fB CheckCommand)
دستور پوسته‌ای را برای اجرا جهت بررسی نامهٔ جدید به جای
بررسی اندازهٔ \fBfile\fP تعیین می‌کند.
مقدار رشته‌ای تعیین‌شده به‌عنوان آرگومان فراخوانی
.BR system (3)
استفاده می‌شود و بنابراین ممکن است شامل تغییر مسیر ورودی/خروجی (i/o redirection) باشد.
وضعیت خروج 0 نشان‌دهندهٔ در انتظار بودن نامهٔ جدید است،
1 نشان‌دهندهٔ عدم تغییر اندازه است
و 2 نشان‌دهندهٔ پاک شدن نامه‌هاست.
به‌طور پیش‌فرض، هیچ دستور پوسته‌ای ارائه نشده است.
.TP 8
.B file (\fPclass\fB File)
نام فایل برای پایش را مشخص می‌کند.
پیش‌فرض همان‌طور است که در بالا برای گزینهٔ خط فرمان
.B \-file
شرح داده شد.
.TP 8
.B onceOnly (\fPclass\fB Boolean)
مشخص می‌کند که زنگ فقط بار اولی که نامهٔ جدید یافت شد به صدا درآید
و تا زمانی که حداقل یک بازه بدون نامهٔ در انتظار سپری نشود، دوباره به صدا درنیاید.
پنجره همچنان وجود نامهٔ جدید را تا زمانی که دریافت شود نشان خواهد داد.
پیش‌فرض false است.
.TP 8
.B width (\fPclass\fB Width)
عرض صندوق پستی را تعیین می‌کند.
.TP 8
.B height (\fPclass\fB Height)
ارتفاع صندوق پستی را تعیین می‌کند.
.TP 8
.B update (\fPclass\fB Interval)
بسامد بررسی نامه‌ها را برحسب ثانیه تعیین می‌کند.
پیش‌فرض 30 است.
.TP 8
.B volume (\fPclass\fB Volume)
بلندی صدای زنگ را تعیین می‌کند.
پیش‌فرض 33 درصد است.
توجه داشته باشید که این درصدی از حجم صدای فعلی در
.BR xset (1)
است.
برای کاهش صدا، درصدی منفی تعیین کنید.
.TP 8
.B foreground (\fPclass\fB Foreground)
رنگ پیش‌زمینه را تعیین می‌کند.
.TP 8
.B reverseVideo (\fPclass\fB ReverseVideo)
مشخص می‌کند که رنگ پیش‌زمینه و پس‌زمینه معکوس شوند.
.TP 8
.B flip (\fPclass\fB Flip)
مشخص می‌کند که آیا تصویری که هنگام رسیدن نامه نمایش داده می‌شود
باید معکوس شود یا خیر.
پیش‌فرض «true» است.
.TP 8
.B fullPixmap (\fPclass\fB Pixmap)
یک بیت‌مپ را برای نمایش هنگام رسیدن نامهٔ جدید تعیین می‌کند.
پیش‌فرض flagup است.
.TP 8
.B emptyPixmap (\fPclass\fB Pixmap)
یک بیت‌مپ را برای نمایش در هنگام نبود نامهٔ جدید تعیین می‌کند.
پیش‌فرض flagdown است.
.TP 8
.B shapeWindow (\fPclass\fB ShapeWindow)
مشخص می‌کند که آیا پنجرهٔ صندوق پستی باید مطابق با
\fBfullPixmapMask\fP و \fBemptyPixmapMask\fP ارائه‌شده شکل‌دهی شود یا خیر.
پیش‌فرض false است.
.TP 8
.B fullPixmapMask (\fPclass\fB PixmapMask)
ماسک را برای بیت‌مپی که هنگام رسیدن نامهٔ جدید نمایش داده می‌شود تعیین می‌کند.
پیش‌فرض none است.
.TP 8
.B emptyPixmapMask (\fPclass\fB PixmapMask)
ماسک را برای بیت‌مپی که در زمان نبود نامهٔ جدید نمایش داده می‌شود تعیین می‌کند.
پیش‌فرض none است.
.SH "کنش‌ها (ACTIONS)"
ویجت \fBMailbox\fP کنش‌های زیر را برای استفاده در ترجمه‌های رویداد (event translations)
فراهم می‌کند:
.TP 8
.B check()
این کنش باعث می‌شود ویجت نامهٔ جدید را بررسی کرده و پرچم را
به‌درستی نمایش دهد.
.TP 8
.B unset()
این کنش باعث می‌شود ویجت پرچم را تا زمان رسیدن نامهٔ جدید پایین بیاورد.
.TP 8
.B set()
این کنش باعث می‌شود ویجت پرچم را تا زمانی که کاربر آن را بازنشانی کند بالا ببرد.
.PP
ترجمهٔ رویداد پیش‌فرض عبارت است از:
.sp
.nf
        <ButtonPress>:  unset()
.fi
.sp
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت میزبان پیش‌فرض و شمارهٔ نمایشگر.
.TP 8
.B XENVIRONMENT
برای دریافت نام یک فایل منبع که منابع سراسری ذخیره‌شده در
ویژگی RESOURCE_MANAGER را بازنویسی می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xrdb (1),
.BR stat (2)
.SH "گزارش باگ‌ها (BUGS)"
بیت‌مپ‌های صندوق پستی زشت هستند.
.SH "نویسندگان (AUTHORS)"
Jim Fulton, MIT X Consortium
.br
تغییرات تکمیلی توسط Ralph Swick، DEC/MIT Project Athena