1 .Dd $Mdocdate: October 16 2016 $
13 utility filters lines form stdin interactively with the keyboard, and print
14 the selected line to stdout.
16 Lower case switches are for the interface, uppercase switches are for
20 Aditionnal part of the prompt to add before the '> '.
23 Display line number before the match.
26 Only return the line number.
29 Output the current candidate repeteadly every time it changes: at each
32 .It Fl k Cm validate key
33 Aditionnal key to use to return current selection. This can a space for
34 use as a word completion engine (^N in vim).
37 Separator for the output: The selected candidate will be printed up to
38 this separator, rather than being printed completely. The separator will
39 be aligned according to 2 rules:
42 The biggest part before separator;
45 Do not outreach the half of the screen horizontally.
48 The right part will also be grayed, and not printed in the prompt.
51 Comment char: Every line starting with this character will be treated as a
52 header. Header are always visible and bold (\033[1m), even when not
53 matched. This is convenient to prompt the user items from multiple
54 categories at the same time.
57 Number of lines to display at once. Default is 30.
60 Display (and update) the prompt to be at the bottom of the candidates, and
61 at the bottom of the screen.
64 Display (and update) the prompt to be at the top of the candidates, and at the bottom of the screen.
67 Set the input a DEFAULT string before to start.
70 Set the character to use to mark header and delimit sections.
79 Switch between candidates, and finally come back to the
80 original input without completion.
84 Delete one char backward, but if there is no char
85 backward, it should return an error code of 1.
88 Cancel, and make filter return the error code of 1.
91 Insert the next KEY pressed literally.
94 Deletes the last entered word.
97 Deletes the entire input.