1 files changed, 105 insertions, 0 deletions
diff --git a/doc/remembering.eo.5.in b/doc/remembering.eo.5.in
new file mode 100644
index 0000000..f02787a
--- /dev/null
+++ b/doc/remembering.eo.5.in
@@ -0,0 +1,105 @@
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH REMEMBERING 5 @DATE@ "remembering @VERSION@" 
+
+
+.SH NOMO
+
+remembering \- format of the \fIPROFILE\fP text file.
+
+
+.SH PROFILE
+
+The \fIPROFILE\fP is a text file, stored on \f(CR$XDG_DATA_HOME/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 "VIDU ANKAŬ"
+
+\fBremembering\fP(1)
+
+
+.SH AŬTOROJ
+
+.MT eu@euandre.org
+EuAndreh
+.ME
+kaj la kontribuuloj.
+
+
+.SH MISFUNKCIOJ
+
+.IP \(bu
+Raportu misfunkcioj al la
+.MT ~euandreh/public\-inbox@lists.sr.ht
+dissendolisto
+.ME .
+Uzu la subjekton "\f(CR[remembering] BUG aŭ TASK:
+<priskribo>\fR".
+.IP \(bu
+Foliumu misfunkcioj
+.UR https://euandreh.xyz/remembering/TODOs.html
+rete
+.UE .
+.IP \(bu
+.UR https://euandreh.xyz/remembering/
+Ĉefpaĝo
+.UE .
+.IP \(bu
+.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bremembering%5D
+Komentoj kaj diskutoj
+.UE .