Add the possibility to read settings from a configuration file.

The file must have the same name as the executable but with a dot as prefix.
It must follow the .ini format.

1 files changed, 35 insertions, 0 deletions

diff --git a/smenu.1 b/smenu.1
index 7c033f0..3b6968a 100644
--- a/smenu.1
+++ b/smenu.1
@@ -120,6 +120,41 @@ This utility is Unicode aware and should be able to display correctly
 any Unicode character (even double-width ones) as long as the current
 encoding is \fBUTF-8\fP (\fBUTF-8\fP in the output of the \fIlocale\fP
 command).
+.SS Configuration
+If a file with adequates permissions and the same name as the
+executable prefixed with a dot is present in the user home
+directory, then it will be parsed as a \fIini\fP file.
+.P
+For now, only color informations are considered.
+.P
+Here is an example giving the syntax and color names to use:
+.P
+.nf
+[colors]
+  ; The terminal must have at least 8 colors for this to be usefull
+  ; if not the following settings will be ignored.
+
+  method=ansi          ; classic | ansi
+
+  bar_foreground = 2   ; scroll bar foreground
+  bar_background=0     ; scroll bar background
+
+  search_foreground=11 ; search color foreground
+  search_background=1  ; search color background
+
+[window]
+  lines = 7            ; default number of lines of the window
+.fi
+.IP * 2
+The \fBmethod\fP keyword can take the two possible values displayed
+above and determines if you want to use the native method (limited to 8
+colors) of the \fBansi\fP method (ISO 8613-6) if your terminal supports
+more than 8 colors. The default value corresponds to \fBansi\fP.
+.IP * 2
+Spaces are allowed anywhere in the lines and between them, even around
+the \fB=\fP.
+.IP * 2
+Everything following a \fB;\fP is ignored.
 .SH OPTIONS
 .IP \fB-h\fP
 Displays a short help message and exists.