.Dd November 29, 2016
.Dt VIS-CLIPBOARD 1
.Os Vis v0.9-498-gad0f1deb-dirty
.
.Sh "نام (NAME)"
.Nm vis-clipboard
.Nd خواندن از یا نوشتن در کلیپ‌بورد سیستم
.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm vis-clipboard
.Fl -usable
.Pp
.Nm vis-clipboard
.Fl -copy
.Op Fl -selection Ar selection
.Pp
.Nm vis-clipboard
.Fl -paste
.Op Fl -selection Ar selection
.
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm vis-clipboard
ابزارهای گوناگون و ویژه‌ی هر سیستم را برای تعامل با کلیپ‌بورد سیستم در بر می‌گیرد.
این ابزار بسته به پرچم داده‌شده در خط فرمان،
می‌تواند به سه روش مختلف اجرا شود.
.Bl -tag -width flag
.It Fl -usable
در این حالت،
.Nm vis-clipboard
به‌دنبال راهی برای برقراری ارتباط با کلیپ‌بورد سیستم می‌گردد.
در صورت یافتن رابط،
با کد خروج 0 خاتمه می‌یابد.
اگر رابطی برای کلیپ‌بورد سیستم در دسترس نباشد،
با کد خروج 1 خاتمه می‌یابد.
.It Fl -copy
در این حالت،
.Nm vis-clipboard
محتوای ورودی استاندارد را می‌خواند
و آن را در کلیپ‌بورد سیستم ذخیره می‌کند.
.It Fl -paste
در این حالت،
.Nm vis-clipboard
محتوای کلیپ‌بورد سیستم را می‌خواند
و آن را در خروجی استاندارد می‌نویسد.
.It Fl -selection Ar selection
انتخاب (selection) مورد استفاده را مشخص می‌کند؛ گزینه‌ها عبارتند از "primary" یا
"clipboard". این گزینه در پلتفرم‌هایی با یک کلیپ‌بورد واحد، بدون اعلام خطا نادیده گرفته می‌شود.
.El
.
.Sh "ابزارهای کلیپ‌بورد (CLIPBOARD TOOLS)"
برای تعیین این‌که از کدام کلیپ‌بورد سیستم استفاده شود،
.Nm vis-clipboard
این ابزارهای کلیپ‌بورد را با ترتیب زیر بررسی می‌کند:
.Bl -tag -width Ev
.It Ev Xr wl-clipboard 1
Wayland (در صورت تنظیم بودن $WAYLAND_DISPLAY)
.It Ev Pa wayclip
Wayland (در صورت تنظیم بودن $WAYLAND_DISPLAY)
.It Ev Xr xclip 1
X11 (در صورت تنظیم بودن $DISPLAY)
.It Ev Xr xsel 1
X11 (در صورت تنظیم بودن $DISPLAY)
.It Ev Xr pbcopy 1 / Xr pbpaste 1
macOS
.It Ev Xr wslclip 1
WSL (Windows Subsystem for Linux)
.It Ev Pa /dev/clipboard
Cygwin
.It Ev Pa termux-clipboard-{get,set}
Termux
.El
.
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std vis-clipboard
.
هنگام اجرا با پرچم
.Fl -usable
،
وضعیت خروج 0 به این معنی است که یک ابزار پشتیبانی‌شده‌ی ویژه‌ی سیستم پیدا شده است،
در حالی که 1 یعنی دسترسی به کلیپ‌بورد امکان‌پذیر نیست.
.
.Sh "مثال‌ها (EXAMPLES)"
بررسی این‌که آیا دسترسی به کلیپ‌بورد در دسترس است یا خیر:
.Bd -literal -offset indent
if vis-clipboard --usable; then
	echo "Clipboard access available"
else
	echo "No clipboard"
fi
.Ed
.Pp
کپی کردن یک پیام خوش‌آمدگویی در کلیپ‌بورد:
.Bd -literal -offset indent
echo "Hello, World" | vis-clipboard --copy
.Ed
.Pp
ارسال محتوای فعلی کلیپ‌بورد سیستم جهت ثبت و تجزیه‌وتحلیل:
.Bd -literal -offset indent
vis-clipboard --paste | curl -d - https://www.nsa.gov
.Ed
.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr pbcopy 1 ,
.Xr pbpaste 1 ,
.Xr vis 1 ,
.Xr waycopy 1 ,
.Xr waypaste 1 ,
.Xr wl-clipboard 1 ,
.Xr wslclip 1 ,
.Xr xclip 1 ,
.Xr xsel 1