| File docs/pipedial.1 changed (mode: 100644) (index 0e9076e..3ea4b38) |
| 1 |
|
.\" Automatically generated by Pandoc 1.17.0.3 |
|
|
1 |
|
.\" Automatically generated by Pandoc 3.10.1 |
| 2 |
2 |
.\" |
.\" |
| 3 |
|
.TH "pipedial" "1" "September 20, 2020" "" "" |
|
| 4 |
|
.hy |
|
|
3 |
|
.TH "pipedial" "1" "August 02, 2026" "" |
| 5 |
4 |
.SH NAME |
.SH NAME |
| 6 |
|
.PP |
|
| 7 |
|
\f[I]pipedial\f[] is a terminal element picker. |
|
|
5 |
|
\f[I]pipedial\f[R] is a terminal element picker. |
| 8 |
6 |
It displays a list of lines it got from standard input and lets the user |
It displays a list of lines it got from standard input and lets the user |
| 9 |
7 |
pick which one of them is printed on standard output. |
pick which one of them is printed on standard output. |
| 10 |
8 |
.SH SYNOPSIS |
.SH SYNOPSIS |
|
9 |
|
\f[B]pipedial\f[R] < \f[I]list\-of\-inputs\f[R] |
| 11 |
10 |
.PP |
.PP |
| 12 |
|
\f[B]pipedial\f[] < \f[I]list\-of\-inputs\f[] |
|
| 13 |
|
.PP |
|
| 14 |
|
\f[I]input\-generator\f[] | \f[B]pipedial\f[] | |
|
| 15 |
|
\f[I]output\-consumer\f[] |
|
|
11 |
|
\f[I]input\-generator\f[R] | \f[B]pipedial\f[R] | |
|
12 |
|
\f[I]output\-consumer\f[R] |
| 16 |
13 |
.PP |
.PP |
| 17 |
|
\f[I]output\-consumer\f[] $(\f[I]input\-generator\f[] | |
|
| 18 |
|
\f[B]pipedial\f[]) |
|
|
14 |
|
\f[I]output\-consumer\f[R] $(\f[I]input\-generator\f[R] | |
|
15 |
|
\f[B]pipedial\f[R]) |
| 19 |
16 |
.SH OPTIONS |
.SH OPTIONS |
| 20 |
|
.SS \f[B]\f[C]\-\-help\f[], \f[C]\-h\f[]\f[] |
|
| 21 |
|
.PP |
|
|
17 |
|
.SS \f[B]\f[CB]\-\-help\f[B], \f[CB]\-h\f[B]\f[R] |
| 22 |
18 |
Display short usage help. |
Display short usage help. |
| 23 |
|
.SS \f[B]\f[C]\-\-version\f[]\f[] |
|
| 24 |
|
.PP |
|
|
19 |
|
.SS \f[B]\f[CB]\-\-version\f[B]\f[R] |
| 25 |
20 |
Display version information. |
Display version information. |
| 26 |
|
.SS \f[B]\f[C]\-\-title\ <title>\f[], \f[C]\-t\ <title>\f[]\f[] |
|
| 27 |
|
.PP |
|
|
21 |
|
.SS \f[B]\f[CB]\-\-title <title>\f[B], \f[CB]\-t <title>\f[B]\f[R] |
| 28 |
22 |
Customize title. |
Customize title. |
| 29 |
|
.SS \f[B]\f[C]\-\-filter\f[], \f[C]\-f\f[]\f[] |
|
| 30 |
|
.PP |
|
|
23 |
|
.SS \f[B]\f[CB]\-\-filter\f[B], \f[CB]\-f\f[B]\f[R] |
| 31 |
24 |
Start in filtering mode. |
Start in filtering mode. |
| 32 |
25 |
.SH SHORTCUTS |
.SH SHORTCUTS |
| 33 |
|
.PP |
|
| 34 |
|
\f[B]{Escape}\f[] \-\- abort partially typed shortcut. |
|
|
26 |
|
\f[B]{Escape}\f[R] \(en abort partially typed shortcut. |
| 35 |
27 |
.SS Normal Mode |
.SS Normal Mode |
|
28 |
|
\f[B]q\f[R] \(en quit the application with no selection. |
| 36 |
29 |
.PP |
.PP |
| 37 |
|
\f[B]q\f[] \-\- quit the application with no selection. |
|
| 38 |
|
.PP |
|
| 39 |
|
\f[B]h\f[] \-\- enter Help mode. |
|
|
30 |
|
\f[B]h\f[R] \(en enter Help mode. |
| 40 |
31 |
.PP |
.PP |
| 41 |
|
\f[B]{Enter}\f[] \-\- select current item and quit. |
|
|
32 |
|
\f[B]{Enter}\f[R] \(en select current item and quit. |
| 42 |
33 |
.PP |
.PP |
| 43 |
|
\f[B]e\f[] \-\- edit current item and accept the result. |
|
|
34 |
|
\f[B]e\f[R] \(en edit current item and accept the result. |
| 44 |
35 |
.PP |
.PP |
| 45 |
|
\f[B]/\f[] \-\- start interactive filtering. |
|
|
36 |
|
\f[B]/\f[R] \(en start interactive filtering. |
| 46 |
37 |
Case is respected unless no matches are found. |
Case is respected unless no matches are found. |
| 47 |
38 |
.PP |
.PP |
| 48 |
|
\f[B][count]gg\f[] \-\- put cursor on the first or \f[B][count]\f[]\-th |
|
| 49 |
|
element. |
|
|
39 |
|
\f[B][count]gg\f[R] \(en put cursor on the first or |
|
40 |
|
\f[B][count]\f[R]\-th element. |
| 50 |
41 |
.PP |
.PP |
| 51 |
|
\f[B][count]G\f[] \-\- put cursor on the last or \f[B][count]\f[]\-th |
|
|
42 |
|
\f[B][count]G\f[R] \(en put cursor on the last or \f[B][count]\f[R]\-th |
| 52 |
43 |
element. |
element. |
| 53 |
44 |
.PP |
.PP |
| 54 |
|
\f[B][count]j\f[] \-\- move cursor \f[B][count]\f[] (1 by default) |
|
|
45 |
|
\f[B][count]j\f[R] \(en move cursor \f[B][count]\f[R] (1 by default) |
| 55 |
46 |
elements down. |
elements down. |
| 56 |
47 |
.PP |
.PP |
| 57 |
|
\f[B][count]k\f[] \-\- move cursor \f[B][count]\f[] (1 by default) |
|
|
48 |
|
\f[B][count]k\f[R] \(en move cursor \f[B][count]\f[R] (1 by default) |
| 58 |
49 |
elements up. |
elements up. |
| 59 |
50 |
.PP |
.PP |
| 60 |
|
\f[B]Ctrl\-E\f[] \-\- scroll one line down. |
|
|
51 |
|
\f[B]Ctrl\-E\f[R] \(en scroll one line down. |
| 61 |
52 |
.PP |
.PP |
| 62 |
|
\f[B]Ctrl\-Y\f[] \-\- scroll one line up. |
|
|
53 |
|
\f[B]Ctrl\-Y\f[R] \(en scroll one line up. |
| 63 |
54 |
.SS Help Mode |
.SS Help Mode |
|
55 |
|
\f[B]h\f[R] \(en return to Normal mode. |
| 64 |
56 |
.PP |
.PP |
| 65 |
|
\f[B]h\f[] \-\- return to Normal mode. |
|
|
57 |
|
\f[B]gg\f[R] \(en scroll to the top. |
| 66 |
58 |
.PP |
.PP |
| 67 |
|
\f[B]gg\f[] \-\- scroll to the top. |
|
|
59 |
|
\f[B]G\f[R] \(en scroll to the bottom. |
| 68 |
60 |
.PP |
.PP |
| 69 |
|
\f[B]G\f[] \-\- scroll to the bottom. |
|
|
61 |
|
\f[B]j\f[R]/\f[B]Ctrl\-E\f[R] \(en scroll one line down. |
| 70 |
62 |
.PP |
.PP |
| 71 |
|
\f[B]j\f[]/\f[B]Ctrl\-E\f[] \-\- scroll one line down. |
|
| 72 |
|
.PP |
|
| 73 |
|
\f[B]k\f[]/\f[B]Ctrl\-Y\f[] \-\- scroll one line up. |
|
|
63 |
|
\f[B]k\f[R]/\f[B]Ctrl\-Y\f[R] \(en scroll one line up. |
| 74 |
64 |
.SH EXAMPLES |
.SH EXAMPLES |
| 75 |
|
.PP |
|
| 76 |
|
Switch to a branch inside git repository (doesn\[aq]t handle |
|
|
65 |
|
Switch to a branch inside git repository (doesn\(cqt handle |
| 77 |
66 |
cancellation): |
cancellation): |
| 78 |
67 |
.IP |
.IP |
| 79 |
|
.nf |
|
| 80 |
|
\f[C] |
|
| 81 |
|
git\ checkout\ $(git\ branch\ |\ pipedial\ \-\-title\ \[aq]Pick\ destination\ branch:\[aq]) |
|
| 82 |
|
\f[] |
|
| 83 |
|
.fi |
|
|
68 |
|
.EX |
|
69 |
|
git checkout $(git branch | pipedial \-\-title \(aqPick destination branch:\(aq) |
|
70 |
|
.EE |
| 84 |
71 |
.SH AUTHORS |
.SH AUTHORS |
| 85 |
72 |
xaizek <xaizek@posteo.net>. |
xaizek <xaizek@posteo.net>. |