aboutsummaryrefslogtreecommitdiff
path: root/doc/remembering.1
blob: d26da065eac8cdcc5be4e0b19a6428825b13f534 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
.TH REMEMBERING 1 @DATE@ "remembering @VERSION@"


.SH NAME

remembering - sort list from \fISTDIN\fR using past choices as weight.


.SH SYNOPSYS

\fBremembering\fR \fB-p\fR \fIPROFILE\fR \fB-c\fR \fICOMMAND\fR


.SH DESCRIPTION

\fBremembering\fR takes a command that chooses an option as its behaviour, such as \fBfzf\fR(1) or \fBdmenu\fR(1), and \fIremembers\fR what option is chosen, and as it is used, will put the most used choices at the beginning of the list.

\fBremembering\fR reads from STDIN and writes to STDOUT.
It expects STDIN to be sorted.


.SH OPTIONS

.TP
\fB-c\fR \fICOMMAND\fR
The \fICOMMAND\fR to be executed, reading from standard input (STDIN).

.TP
\fB-p\fR \fIPROFILE\fR
The name of the \fIPROFILE\fR where to look up and store raking data.

.TP
\fB-h\fR
Show short help text.

.TP
\fB-V\fR
Show version number.


.SH EXAMPLES

List current directory and feed it to \fBfzf\fR(1) via \fBremembering\fR:

.nf
	$ ls | remembering -p fzf-ls -c fzf
.fi


Lists all executables available in \fI$PATH\fR, and feed those to \fBdmenu\fR(1) via \fBremembering\fR, and execute with \fBsh\fR(1) the choice picked:

.nf
	$ dmenu_path | remembering -p dmenu-exe -c 'dmenu' | sh
.fi

.P
Successive invocations will put the frequent choices at the beginning.


.SH SEE ALSO

\fBremembering\fR(5)


.SH AUTHORS

.MT eu@euandre.org
EuAndreh
.ME
and contributors.


.SH BUGS

.IP \(bu
Report bugs to the
.MT ~euandreh/public-inbox@lists.sr.ht
mailing list
.ME .
Use the subject "\fC[remembering] BUG or TASK: <description>\fR".
.IP \(bu
Browse bugs
.UR https://euandreh.xyz/remembering/TODOs.html
online
.UE .
.IP \(bu
.UR https://euandreh.xyz/remembering/
Homepage
.UE .
.IP \(bu
.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bremembering%5D
Comments and discussions
.UE .