.Dd $Mdocdate: July 10 2015 $
.Dt YANK 1
.Os
.Sh "نام (NAME)"
.Nm yank
.Nd کپی خروجی ترمینال به کلیپ‌بورد
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl 1ilxv
.Op Fl d Ar delim
.Op Fl g Ar pattern
.Op Fl - Ar command Op Ar argument ...
.Sh "توضیحات (DESCRIPTION)"
ورودی را از
.Pa stdin
خوانده و یک واسط انتخاب نمایش می‌دهد که امکان انتخاب یک فیلد و کپی کردن آن به کلیپ‌بورد را فراهم می‌سازد.
فیلدها یا از طریق یک عبارت باقاعده با استفاده از گزینهٔ
.Fl g
یا با تقسیم کردن ورودی بر اساس دنباله‌ای از جداکننده‌ها با استفاده از گزینهٔ
.Fl d
شناسایی می‌شوند؛ بخش
.Sx "جداکننده‌ها (DELIMITERS)"
را ببینید.
.Pp
با استفاده از کلیدهای جهت‌نما می‌توان فیلد انتخاب‌شده را جابه‌جا کرد؛ بخش
.Sx "دستورات (COMMANDS)"
را ببینید.
فشردن کلید return موجب فراخوانی
.Ar command
و نوشتن فیلد انتخاب‌شده در
.Pa stdin
آن می‌شود.
مقدار پیش‌فرض
.Ar command
برابر xsel است، اما می‌تواند هر فرمانی باشد که ورودی را روی
.Pa stdin
می‌پذیرد؛ بخش
.Sx "مثال‌ها (EXAMPLES)"
را ببینید.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl 1
اگر تنها یک فیلد شناسایی شود، آن را انتخاب کرده و بدون نمایش واسط انتخاب،
.Ar command
را فراخوانی می‌کند.
.It Fl d Ar delim
تمام نویسه‌های ورودی که در
.Ar delim
وجود ندارند به عنوان فیلد شناسایی خواهند شد؛ بخش
.Sx "جداکننده‌ها (DELIMITERS)"
را ببینید.
.It Fl g Ar pattern
استفاده از
.Ar pattern
برای شناسایی فیلدها، که به صورت یک عبارت باقاعدهٔ تعمیم‌یافتهٔ POSIX بیان می‌شود.
.It Fl i
نادیده گرفتن تفاوت بزرگی و کوچکی حروف میان
.Ar pattern
و ورودی.
.It Fl l
استفاده از جداکننده‌های پیش‌فرض به جز فاصله؛ بخش
.Sx "جداکننده‌ها (DELIMITERS)"
را ببینید.
.It Fl v
نسخه را چاپ می‌کند.
.It Fl x
استفاده از صفحهٔ جایگزین (alternate screen).
.It Fl - Ar command Op Ar argument ...
استفاده از
.Ar command
به همراه صفر یا چند
.Ar args
به عنوان دستور yank.
.El
.Sh "دستورات (COMMANDS)"
.Bl -tag -width XXXX
.It Ic Ctrl-A | g
انتقال انتخاب به اولین فیلد.
.It Ic Ctrl-C | Ctrl-D
خروج بدون فراخوانی دستور yank.
.It Ic Ctrl-E | G
انتقال انتخاب به آخرین فیلد.
.It Ic Ctrl-P Ns / Ns Ic Ctrl-N | Ic Left Ns / Ns Ic Right | Ic h Ns / Ns Ic l
انتقال انتخاب به چپ یا راست.
.It Ic Ctrl-L
تغییر وضعیت میان جداکننده فعلی و جداکننده خط، معادل با گزینهٔ
.Fl l .
.It Ic Up Ns / Ns Ic Down | Ic j Ns / Ns Ic k
انتقال انتخاب به خط بعدی یا قبلی.
.It Ic Enter
خروج با استفاده از فیلد انتخاب‌شده.
.El
.Sh "جداکننده‌ها (DELIMITERS)"
در صورتی که گزینه‌های
.Fl d
و
.Fl g
مشخص نشوند، نویسه‌های زیر به طور پیش‌فرض به عنوان جداکننده شناخته می‌شوند:
.Bl -tag -width XXXX
.It \ef
برگه‌خور (form feed)
.It \en
خط جدید (new line)
.It \er
بازگشت به ابتدای سطر (carriage return)
.It \es
فاصله (space)
.It \et
تب افقی (horizontal tab)
.El
.Pp
در صورت استفاده از گزینهٔ
.Fl d ،
فاصله به عنوان جداکننده در نظر گرفته نمی‌شود.
.Sh "مثال‌ها (EXAMPLES)"
کپی کلید یا مقدار یک متغیر محیطی:
.Pp
.Dl $ env | yank -d =
.Pp
کپی یک فیلد از یک فایل CSV:
.Pp
.Dl $ yank -d \e\&", <file.csv
.Pp
کپی کل یک خط با استفاده از گزینهٔ
.Fl l :
.Pp
.Dl $ make 2>&1 | yank -l
.Pp
اگر
.Pa stdout
یک ترمینال نباشد، فیلد انتخاب‌شده در
.Pa stdout
نوشته شده و برنامه بدون فراخوانی دستور yank خارج می‌شود.
کشتن PID انتخاب‌شده:
.Pp
.Dl $ ps ux | yank -g [0-9]+ | xargs kill
.Pp
کپی فیلد انتخاب‌شده به کلیپ‌بورد اصلی (clipboard) به جای کلیپ‌بورد پیش‌فرض primary:
.Pp
.Dl $ yank \(em xsel -b
.Sh "خطاها (DIAGNOSTICS)"
.Ex -std
.Sh "همچنین ببینید (SEE ALSO)"
.Xr re_format 7
.Sh "نویسندگان (AUTHORS)"
.An Anton Lindqvist Aq Mt anton@basename.se
.Sh "هشدارها (CAVEATS)"
برای شناسایی فیلدهای محصور در براکت، لازم است
.Sq \&]
پیش از
.Sq \&[
در آرگومان ارائه‌شده به گزینهٔ
.Fl d
قرار گیرد؛ بخش
.Xr re_format 7
را ببینید.