blob: c37c893175065ec1c95acb1086a0fe6f1f39f766 (
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
94
95
96
97
98
99
100
101
102
103
104
105
106
|
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH REMEMBERING 5 @DATE@ "remembering @VERSION@"
.SH NOME
remembering \- format of the \fIPROFILE\fP text file.
.SH PROFILE
The \fIPROFILE\fP is a text file, stored on
\f(CR$XDG_DATA_HOME/remembering/profile\-name\fR if \f(CR$XDG_DATA_HOME\fR is
defined. Otherwise, it lives in
\f(CR~/.local/share/remembering/profile\-name\fR.
Each line of the \fIPROFILE\fP contains three pieces of information:
.RS
.IP 1
the \fBrank\fP of the current entry;
.IP 2
the \f(CR:\fR separator;
.IP 3
the \fBentry\fP itself.
.RE
The \fBrank\fP is a number, and the \fBentry\fP is all the text until the end of
the line after the \f(CR:\fR separator:
.RS
.nf
0:an entry
0:banana
0:entry
0:something
0:zzz
.fi
.RE
Above is an example of a \fIPROFILE\fP file where all the entries have the
default \fBrank\fP value: \fB0\fP.
If the \fICOMMAND\fP runs and chooses \f(CRbanana\fR, the new \fIPROFILE\fP will
be:
.RS
.nf
0:an entry
1:banana
0:entry
0:something
0:zzz
.fi
.RE
Now the next time the \fICOMMAND\fP runs it will get \f(CRbanana\fR at the
beginning of the list, and as new picks happen their weight will increase,
and will keep going up in priority.
The entries of the \fIPROFILE\fP are created and kept sorted.
\fBremembering\fP(1) expects to always find sorted entries in the \fIPROFILE\fP.
The current raking algorithm increments entries as a simple counter. Every
time an entry is picked, its ranked is incremented in the \fIPROFILE\fP.
.SH "VEJA TAMBÉM"
\fBremembering\fP(1)
.SH AUTORES
.MT eu@euandre.org
EuAndreh
.ME
e colaboradores.
.SH BUGS
.IP \(bu
Relate bugs na
.MT ~euandreh/public\-inbox@lists.sr.ht
lista de discussão
.ME .
Use o assunto "\f(CR[remembering] BUG ou TASK:
<descrição>\fR".
.IP \(bu
Veja os bugs
.UR https://euandreh.xyz/remembering/TODOs.html
online
.UE .
.IP \(bu
.UR https://euandreh.xyz/remembering/pt/
Página inicial
.UE .
.IP \(bu
.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bremembering%5D
Comentários e discussões
.UE .
|