.\" Copyright 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" 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 OPEN GROUP 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 Open Group 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 Open Group.
.\"
.\"
.TH XCUTSEL 1 2025-03-23 "xclipboard 1.1.6" "X Version 11"
.SH "نام (NAME)"
xcutsel \- تبادل داده میان cut buffer و گزینش (selection)
.SH "خلاصه دستور (SYNOPSIS)"
\fBxcutsel\fP [\fI-toolkitoption\fP ...] [\fB-selection\fP \fIselection\fP] [\fB-cutbuffer\fP \fInumber\fP]
.LP
\fBxcutsel\fP \fB\-help\fP | \fB\-version\fP
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBxcutsel\fP برای رونویسی گزینش (selection) فعلی در یک cut buffer و ایجاد یک گزینش شامل محتویات فعلی cut buffer به کار می‌رود.
این برنامه به عنوان پلی میان برنامه‌هایی که از گزینش‌ها پشتیبانی نمی‌کنند و برنامه‌هایی که پشتیبانی می‌کنند عمل می‌کند.
.PP
به‌طور پیش‌فرض، \fBxcutsel\fP از گزینشی با نام PRIMARY و cut buffer با نام CUT_BUFFER0 استفاده می‌کند.
هر یک از این دو مورد یا هر دوی آن‌ها را می‌توان با آرگومان‌های خط فرمان یا از طریق منابع (resources) جایگزین کرد.
.PP
پنجرهٔ \fBxcutsel\fP شامل دکمه‌های زیر است:
.TP 8
.I "    quit"
با فشردن این دکمه، \fBxcutsel\fP خارج می‌شود.
هر گزینشی که در اختیار \fBxcutsel\fP باشد به‌طور خودکار آزاد می‌شود.
.TP 8
.I "    copy PRIMARY to 0"
با فشردن این دکمه، \fBxcutsel\fP گزینش فعلی را درون cut buffer رونویسی می‌کند.
.TP 8
.I "    copy 0 to PRIMARY"
با فشردن این دکمه، \fBxcutsel\fP محتویات فعلی cut buffer را به گزینش تبدیل می‌کند.
.PP
برچسب دکمه‌ها بازتاب‌دهندهٔ گزینش و cutbuffer تعیین‌شده از طریق گزینه‌های خط فرمان یا پایگاه‌دادهٔ منابع هستند.
.PP
هنگامی که دکمهٔ \(lqcopy 0 to PRIMARY\(rq فعال شود، تا زمانی که \fBxcutsel\fP مالک گزینش باقی بماند، دکمه به صورت معکوس‌شده باقی خواهد ماند.
این حالت برای یادآوری این نکته است که کدام کلاینت مالک گزینش فعلی است.
توجه داشته باشید که مقدار گزینش ثابت می‌ماند؛
اگر cutbuffer تغییر کند، برای دریافت مقدار جدید در صورت نیاز باید دوباره دکمهٔ copy را فعال کنید.
.SH "گزینه‌ها (OPTIONS)"
برنامهٔ .I Xcutsel
تمام گزینه‌های خط فرمان استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:
.TP 8
.B \-selection \fIname\fP
این گزینه نام گزینش مورد استفاده را مشخص می‌کند.
مقدار پیش‌فرض PRIMARY است.
تنها مخفف‌های پشتیبانی‌شده برای این گزینه
\(lq-select\(rq، \(lq-sel\(rq و \(lq-s\(rq هستند،
زیرا گزینهٔ استاندارد جعبه‌ابزار \(lq-selectionTimeout\(rq نامی مشابه دارد.
.TP 8
.B \-cutbuffer \fInumber\fP
این گزینه cut buffer مورد استفاده را مشخص می‌کند.
پیش‌فرض، cut buffer شمارهٔ 0 است.
.TP 8
.B \-help
پیام راهنمای استفاده را چاپ کرده و خارج می‌شود.
.TP 8
.B \-version
اطلاعات نگارش را چاپ کرده و خارج می‌شود.
.SH "پیش‌فرض‌های X (X DEFAULTS)"
این برنامه تمام نام‌ها و کلاس‌های منابع استاندارد X Toolkit و همچنین موارد زیر را می‌پذیرد:
.TP 8
.B "selection (\fPclass\fB Selection)"
این منبع نام گزینش مورد استفاده را مشخص می‌کند.
مقدار پیش‌فرض PRIMARY است.
.TP 8
.B "cutBuffer (\fPclass\fB CutBuffer)"
این منبع شمارهٔ cut buffer مورد استفاده را مشخص می‌کند.
مقدار پیش‌فرض 0 است.
.SH "نام‌های ویجت (WIDGET NAMES)"
در صورتی که پیکربندی برچسب‌های ویجت‌ها توسط کاربر مد نظر باشد، می‌توان از نام‌های نمونهٔ (instance names) زیر استفاده کرد:
.TP 8
.B "sel-cut (\fPclass\fB Command)"
این دکمهٔ \(lqcopy SELECTION to BUFFER\(rq است.
.TP 8
.B "cut-sel (\fPclass\fB Command)"
این دکمهٔ \(lqcopy BUFFER to SELECTION\(rq است.
.TP 8
.B "quit (\fPclass\fB Command)"
این دکمهٔ \(lqquit\(rq است.
.SH "همچنین ببینید (SEE ALSO)"
.BR xclipboard (1),
.BR X (7),
مستندات ویجت متن (text widget)،
مستندات اختصاصی هر کلاینت برای نحوهٔ ایجاد یک گزینش.
.SH "گزارش باگ‌ها (BUGS)"
هیچ روشی برای تغییر نام گزینش یا شمارهٔ cut buffer در حین اجرای برنامه وجود ندارد.
.SH "نویسندگان (AUTHORS)"
Ralph R. Swick، پروژهٔ DEC/MIT Athena