.Dd March 21, 2023
.Dt VIS-COMPLETE 1
.Os Vis v0.9-498-gad0f1deb-dirty
.
.Sh "نام (NAME)"
.Nm vis-complete
.Nd تکمیل تعاملی فایل یا کلمه
.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm vis-complete
.Op Fl -file | -word
.Op Ar --
.Ar pattern
.Pp
.Nm vis-complete
.Fl h | -help
.
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm vis-complete
الگویی را در خط فرمان دریافت کرده و فایل یا کلمه را تکمیل می‌کند و آن‌ها را در یک منو نمایش می‌دهد تا کاربر یکی را انتخاب کند.
به‌محض اینکه کاربر موردی را برای تکمیل انتخاب کرد، مورد تکمیلی (به‌استثنای الگو) در خروجی استاندارد چاپ می‌شود.
.Pp
دستور
.Nm vis-complete
از
.Xr vis-menu 1
به‌عنوان رابط کاربری خود استفاده می‌کند،
بنابراین برای جزئیات بیشتر به آن صفحه مراجعه کنید.
.
.Bl -tag -width flag
.It Fl -file
این گزینه
.Ar pattern
را به
.Nm find
ارسال می‌کند تا فهرستی از نام‌های فایل منطبق را به دست آورد
(این حالت پیش‌فرض است).
.It Fl -word
این گزینه ورودی استاندارد را می‌خواند تا فهرستی از خطوط منطبق با
.Ar pattern
را به دست آورد.
.It Fl -
هر آرگومانی پس از این نشانه، به عنوان الگو در نظر گرفته خواهد شد،
حتی اگر در حالت عادی یک گزینه معتبر خط فرمان باشد.
.Pp
اگر پس از یک نمونه قبلی از
.Li --
قرار گیرد، به عنوان یک الگو در نظر گرفته می‌شود.
.It Ar pattern
الگویی که باید با فایل یا کلمه تکمیل شود.
.It Fl h | Fl -help
در صورت ارائه،
.Nm vis-complete
خلاصه‌ای از نحوه استفاده را چاپ کرده و با نادیده گرفتن هر پرچم و آرگومان دیگر، خارج می‌شود.
.El
.
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std vis-complete
.Pp
به‌ویژه، درست مانند
.Xr vis-menu 1
چنانچه کاربر از انتخاب فایل خودداری کند،
.Nm vis-complete
چیزی چاپ نمی‌کند و وضعیت خروج خود را روی 1 قرار می‌دهد.
.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr vis 1 ,
.Xr vis-menu 1
.
.Sh "گزارش باگ‌ها (BUGS)"
از آنجا که
.Nm vis-complete
برای دریافت فهرست فایل‌ها از
.Xr find 1
استفاده می‌کند، در صورت وجود نویسه‌های کنترلی در نام فایل‌های شما، ممکن است رفتارهای عجیبی رخ دهد.