Skip to content

Commit

Permalink
man: add man page for vis-complete(1)
Browse files Browse the repository at this point in the history
Signed-off-by: Christian Hesse <[email protected]>
  • Loading branch information
eworm-de committed Jan 16, 2017
1 parent e7139d5 commit ae7d164
Show file tree
Hide file tree
Showing 2 changed files with 86 additions and 1 deletion.
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ SRC = array.c buffer.c libutf.c main.c map.c register.c ring-buffer.c \

EXECUTABLES = vis vis-clipboard vis-complete vis-menu vis-open

MANUALS = vis.1 vis-clipboard.1 vis-menu.1 vis-open.1
MANUALS = $(EXECUTABLES:=.1)

# conditionally initialized, this is needed for standalone build
# with empty config.mk
Expand Down
85 changes: 85 additions & 0 deletions man/vis-complete.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
.Dd January 15, 2017
.Dt VIS-COMPLETE 1
.Os Vis VERSION
.
.Sh NAME
.Nm vis-complete
.Nd Interactively complete file or word
.
.Sh SYNOPSIS
.Nm vis-complete
.Op Fl -file
.Op Fl -word
.Op Ar --
.Op Ar pattern
.Pp
.Nm vis-complete
.Fl h |
.Fl -help
.
.Sh DESCRIPTION
.Nm vis-complete
takes a pattern on the command-line and completes file or word and displays
them in a menu for the user to select one.
Once the user has selected a completion, the completion (excluding the
pattern) is printed to standard output.
.Pp
.Nm vis-complete
uses
.Xr vis-menu 1
as its user-interface,
so see that page for more details.
.
.Bl -tag -width flag
.It Fl -file
This passes
.Ar pattern
to
.Nm find
to obtain a list of matching file names.
.It Fl -word
This reads standard input to obtain a list of lines matching
.Ar pattern .
.It Fl -
If this token is encountered before the first non-option argument,
all following arguments will be treated as pattern,
even if they would otherwise be valid command-line options.
.Pp
If encountered after the first non-option argument,
or after a previous instance of
.Li --
it is treated as a pattern.
.It Ar pattern
The pattern to be completed by file or word.
.It Fl h | Fl -help
If present,
.Nm vis-complete
prints a usage summary and exits,
ignoring any other flag and arguments.
.El
.
.Sh EXIT STATUS
.Ex -std vis-complete
.Pp
In particular,
like
.Xr vis-menu 1 ,
.Nm vis-complete
prints nothing and sets its exit status to 1
if the user refused to select a file.
.
.Sh SEE ALSO
.Xr vis 1 ,
.Xr vis-menu 1
.
.Sh AUTHORS
.An "Marc Andr\('e Tanner" Aq [email protected]
.An "Christian Hesse" Aq [email protected]
.
.Sh BUGS
Because
.Nm vis-complete
uses
.Xr find 1
to obtain the list of files, weird things might happen if you have
control-characters in your filenames.

0 comments on commit ae7d164

Please sign in to comment.