.\" 
.\"
.\" xclip.man - xclip manpage
.\" Copyright (C) 2001 Kim Saunders
.\" Copyright (C) 2007-2008 Peter Åstrand
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.\"
.TH XCLIP 1
.SH "نام (NAME)"
xclip \- رابط خط فرمان برای گزینش‌های سامانهٔ X (کلیپ‌بورد)
.SH "خلاصه دستور (SYNOPSIS)"
.B xclip
[OPTION] [FILE]...
.SH "توضیحات (DESCRIPTION)"
داده‌ها را از ورودی استاندارد یا از یک یا چند فایل خوانده و آن‌ها را به عنوان یک گزینش X (X selection) جهت الصاق در برنامه‌های X در دسترس قرار می‌دهد. همچنین گزینش فعلی X را در خروجی استاندارد چاپ می‌کند.
.TP
\fB\-i\fR, \fB\-in\fR
خواندن متن از ورودی استاندارد یا فایل‌ها و قرار دادن آن در گزینش X (پیش‌فرض)
.TP
\fB\-o\fR, \fB\-out\fR
چاپ محتوای گزینش در خروجی استاندارد (به‌طور کلی برای هدایت به یک فایل یا برنامه)
.TP
\fB\-f\fR, \fB\-filter\fR
هنگامی که xclip در حالت ورودی (\-in) و با سطح خروجی بی‌صدا (silent) که حالت‌های پیش‌فرض هستند اجرا شود، گزینهٔ فیلتر موجب می‌شود xclip متنی را که به ورودی استاندارد فرستاده شده، بدون تغییر به خروجی استاندارد بازگرداند.
.TP
\fB\-r\fR, \fB\-rmlastnl\fR
در صورتی که آخرین نویسهٔ گزینش یک نویسهٔ خط‌جدید (newline) باشد، آن را حذف می‌کند. نویسه‌های خط‌جدیدی که آخرین نویسهٔ گزینش نیستند دست‌نخورده باقی می‌مانند. اگر گزینش با نویسهٔ خط‌جدید پایان نیابد، این گزینه هیچ اثری ندارد. این گزینه برای کپی کردن خروجیِ تک‌خطیِ برنامه‌هایی مانند \fBpwd\fR به کلیپ‌بورد جهت الصاق مجدد آن در خط فرمان بسیار مفید است، بدون آن‌که دستور بلافاصله به دلیل نویسهٔ خط‌جدیدی که \fBpwd\fR اضافه می‌کند اجرا شود.
.TP
\fB\-l\fR, \fB\-loops\fR
تعداد دفعات درخواست گزینش X (الصاق در برنامه‌های X) که باید قبل از خروج منتظر آن‌ها بماند؛ مقدار 0 (پیش‌فرض) موجب می‌شود xclip تا زمانی که برنامهٔ دیگری (شاید اجرای دیگری از xclip) مالکیت گزینش را به دست گیرد، برای تعداد نامحدودی از درخواست‌ها منتظر بماند.
.TP
\fB\-t\fR, \fB\-target\fR
مشخص کردن یک قالب دادهٔ خاص با استفاده از اتم هدف (target atom) ارائه‌شده. به همراه \fB\-o\fR می‌توان از نام اتم هدف ویژهٔ \(lqTARGETS\(rq برای دریافت فهرستی از اتم‌های هدف معتبر برای این گزینش استفاده کرد. برای اطلاعات بیشتر دربارهٔ اتم‌های هدف به بخش 2.6.2 سند ICCCM مراجعه کنید.
.TP
\fB\-d\fR, \fB\-display\fR
نمایشگر X مورد استفاده (مانند \(lqlocalhost:0\(rq)؛ در صورت حذف این گزینه، xclip به‌طور پیش‌فرض از مقدار متغیر $\fBDISPLAY\fR استفاده می‌کند.
.TP
\fB\-h\fR, \fB\-help\fR
نمایش خلاصه‌ای سریع از گزینه‌ها
.TP
\fB\-selection\fR
مشخص کردن گزینش X مورد استفاده؛ گزینه‌ها عبارتند از \(lqprimary\(rq برای استفاده از XA_PRIMARY (پیش‌فرض)، \(lqsecondary\(rq برای XA_SECONDARY یا \(lqclipboard\(rq برای XA_CLIPBOARD.
.TP
\fB\-version\fR
نمایش اطلاعات نسخه
.TP
\fB\-silent\fR
انشعاب به پس‌زمینه (fork) جهت انتظار برای درخواست‌ها، بدون خروجی اطلاعاتی و تنها نمایش خطاها (پیش‌فرض)
.TP
\fB\-quiet\fR
نمایش پیام‌های اطلاعاتی در پایانه و اجرا در پیش‌زمینه
.TP
\fB\-verbose\fR
ارائهٔ گزارش مرحله‌به‌مرحله و زنده از کارهایی که xclip انجام می‌دهد
.TP
\fB\-noutf8\fR
کارکرد در حالت سنتی (یعنی غیر UTF-8) برای سازگاری با نسخه‌های گذشته
(تنها در صورت لزوم واقعی از این گزینه استفاده کنید، زیرا رفتار پیشین دچار ایراد بود)

.PP
دستور xclip متن را از ورودی استاندارد یا فایل‌ها می‌خواند و آن را برای الصاق در سایر برنامه‌های سامانهٔ X به عنوان یک گزینش X (به‌طور سنتی با کلیک‌وسط ماوس) در دسترس قرار می‌دهد. این دستور داده‌ها را از تمام فایل‌های مشخص‌شده می‌خواند، و در صورتی که فایلی تعیین نشده باشد از ورودی استاندارد دریافت می‌کند. همچنین xclip می‌تواند با استفاده از گزینهٔ
.B
\-o
محتوای یک گزینش را در خروجی استاندارد چاپ کند.

برنامهٔ xclip برای امکان یکپارچگی بیشتر میان برنامه‌های X و برنامه‌های خط فرمان طراحی شده است. عمل پیش‌فرض این است که بی‌صدا در پس‌زمینه منتظر درخواست‌های گزینش X (الصاق‌ها) بماند تا زمانی که برنامهٔ X دیگری داده‌ای را در کلیپ‌بورد قرار دهد؛ در آن زمان xclip بی‌صدا خارج می‌شود. می‌توانید از گزینهٔ \fB\-verbose\fR استفاده کنید تا ببینید آیا و در چه زمانی xclip در عمل درخواست‌های گزینش را از سایر برنامه‌های X دریافت می‌کند.

گزینه‌ها را تا زمانی که ابهامی ایجاد نکنند می‌توان به‌صورت مخفف نوشت. برای نمونه، می‌توان به جای \fB\-display\fR از \fB\-d\fR یا \fB\-disp\fR استفاده کرد. با این حال، \fB\-v\fR را نمی‌توان به کار برد زیرا مبهم است (می‌تواند مخفف \fB\-verbose\fR یا \fB\-version\fR باشد)، در نتیجه به عنوان یک نام فایل تفسیر خواهد شد.

توجه داشته باشید که تنها نویسهٔ نخستِ گزینش مشخص‌شده با گزینهٔ \fB\-selection\fR اهمیت دارد. این بدان معناست که مقادیر \(lqp\(rq، \(lqsec\(rq و \(lqclip\(rq دقیقاً همان اثر \(lqprimary\(rq، \(lqsecondary\(rq یا \(lqclipboard\(rq را خواهند داشت.

.SH "مثال‌ها (EXAMPLES)"
.PP
از صفحات راهنمای بدون مثال بیزارم!

.B
uptime | xclip
.PP
قرار دادن خروجی uptime در گزینش X. سپس در یک برنامهٔ X کلیک‌وسط کنید تا الصاق شود.

.B xclip -loops 10 -verbose /etc/motd
.PP
خروج پس از ۱۰ بار الصاق شدن محتوای فایل /etc/motd (پیام روز). نمایش تعداد درخواست‌های گزینش (الصاق‌ها) که پردازش شده‌اند.

.B xclip -o > helloworld.c
.PP
قرار دادن محتوای گزینش درون یک فایل.

.B xclip -t text/html index.html
.PP
کلیک‌وسط در یک برنامهٔ X با پشتیبانی از HTML برای الصاق محتوای فایل داده‌شده در قالب HTML.

.SH "محیط (ENVIRONMENT)"
.TP
.SM
\fBDISPLAY\fR
نمایشگر X مورد استفاده، در صورتی که هیچ نمایشگری با گزینهٔ
.B
\-display
تعیین نشده باشد.

.SH "گزارش باگ‌ها (BUGS)"
لطفاً هرگونه باگ، مشکل، پرسش، تجربه و موارد دیگر را مستقیماً به نویسنده گزارش دهید.

.SH "نویسندگان (AUTHORS)"
Kim Saunders <kims@debian.org>
Peter Åstrand <astrand@lysator.liu.se>
.br