.Dd November 29, 2016
.Dt VIS-OPEN 1
.Os Vis v0.9-498-gad0f1deb-dirty
.
.Sh "نام (NAME)"
.Nm vis-open
.Nd انتخاب تعاملی یک فایل برای باز کردن
.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm vis-open
.Op Fl p Ar prompt
.Op Fl f
.Op Ar --
.Op Ar files
.Pp
.Nm vis-open
.Fl h
.
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm vis-open
فهرستی از نام‌های فایل‌ها و دایرکتوری‌ها را از خط فرمان دریافت کرده
و آن‌ها را در قالب یک منو برای انتخاب کاربر نمایش می‌دهد.
اگر کاربر یک دایرکتوری
(از جمله
.Li .. )
را انتخاب کند،
محتویات آن دایرکتوری در یک منوی تازه نمایش داده می‌شود.
به‌محض اینکه کاربر یک نام فایل را انتخاب کند،
مسیر مطلق آن در خروجی استاندارد چاپ می‌شود.
.Pp
دستور
.Nm vis-open
از
.Xr vis-menu 1
به‌عنوان رابط کاربری خود استفاده می‌کند،
بنابراین برای جزئیات بیشتر به صفحهٔ راهنمای آن مراجعه کنید.
.
.Bl -tag -width flag
.It Fl p Ar prompt
نمایش
.Ar prompt
پیش از فهرست موارد.
این مقدار مستقیماً به
.Xr vis-menu 1
پاس داده می‌شود.
.It Fl f
در حالت عادی،
اگر تنها یک آرگومان نام فایل یا دایرکتوری به
.Nm vis-open
داده شود،
آن را به‌طور خودکار انتخاب می‌کند
(چاپ نام فایل در خروجی استاندارد،
یا ارائهٔ یک منوی جدید شامل محتویات آن دایرکتوری).
اگر گزینهٔ
.Fl f
مشخص شود،
دستور
.Nm vis-open
همیشه آرگومان‌های ارائه‌شده را نمایش خواهد داد،
حتی اگر فقط یک مورد وجود داشته باشد.
.It Fl -
اگر این نشانه پیش از اولین آرگومانِ غیرگزینه‌ای دیده شود،
تمام آرگومان‌های پس از آن به‌عنوان موارد منو تلقی می‌شوند،
حتی اگر در حالت معمول گزینه‌های معتبر خط فرمان باشند.
.Pp
اگر پس از اولین آرگومان غیرگزینه‌ای،
یا پس از یک نمونهٔ قبلی از
.Li --
قرار گیرد،
به‌عنوان یک مورد از منو در نظر گرفته می‌شود.
.It Ar files
نام‌های فایل‌ها و دایرکتوری‌هایی که باید به کاربر نمایش داده شوند.
اگر نامی در سامانه فایل وجود نداشته باشد
و کاربر آن را انتخاب کند،
به‌عنوان یک فایل در نظر گرفته می‌شود.
.It Fl h
در صورت وجود،
دستور
.Nm vis-open
خلاصه‌ای از نحوهٔ استفاده را چاپ کرده و خارج می‌شود،
و سایر فلگ‌ها و آرگومان‌ها را نادیده می‌گیرد.
.El
.
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std vis-open
.Pp
به‌ویژه،
همانند
.Xr vis-menu 1 ،
اگر کاربر از انتخاب فایل خودداری کند،
دستور
.Nm vis-open
چیزی چاپ نکرده و وضعیت خروج خود را برابر با 1 قرار می‌دهد.
.
.Sh "مثال‌ها (EXAMPLES)"
.Bd -literal -offset indent
CHOICE=$(vis-open -p "Select a file to stat")
if [ $? -gt 0 ]; then
	echo "No selection was made, or an error occurred"
else
	stat "$CHOICE"
fi
.Ed
.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr vis 1 ,
.Xr vis-menu 1
.
.Sh "اشکالات (BUGS)"
از آنجا که
.Nm vis-open
برای دریافت محتویات یک دایرکتوری از
.Xr ls 1
استفاده می‌کند،
اگر نویسه‌های کنترلی در نام فایل‌های شما وجود داشته باشد ممکن است رفتارهای غیرمنتظره‌ای رخ دهد.