[lm-sensors] [RFC PATCH] include statement in sensors.conf/libsensors

[Mark M. Hoffman]

Hello:

Before I get started on the code, is everyone OK with this?
(patch to man page, which serves as spec...)

Index: sensors.conf.5
===================================================================
--- sensors.conf.5	(revision 4062)
+++ sensors.conf.5	(working copy)
@@ -40,7 +40,8 @@
 not work within a comment,
 .B NAME
 or
-.BR NUMBER .
+.BR NUMBER ,
+nor can lines containing an include statement be continued.
 
 .RS
 bus 
@@ -60,6 +61,9 @@
 ignore
 .B NAME
 .sp 0
+include
+.B FILENAME
+.sp 0
 set 
 .B NAME EXPR
 .RE
@@ -71,6 +75,12 @@
 Within quotes, you can use the normal escape\-codes from C.
 
 A
+.B FILENAME
+is a string.  It may contain letters, digits, dots, dashes, underscores,
+slashes and/or spaces only.  A filename must always appear within double
+quotes.
+
+A
 .B NAME\-LIST
 is one or more
 .B NAME
@@ -300,6 +310,33 @@
 The only argument is the feature name, which may be a feature class;
 in that case the label class is used (see below).
 
+.SS INCLUDE STATEMENT
+.RS
+include "/etc/sensors/foo.conf"
+.RE
+.RS
+include "sensors/foo.conf"
+.RE
+.RS
+include "foo.conf"
+.RE
+
+The
+.I include
+statement causes the program to continue reading configuration from the
+named file.  Upon reaching the end of the named file, the program will
+continue reading configuration from the original file beginning with the
+line after the
+.I include
+statement.
+
+If the filename is not absolute, then the program looks for the file in
+the current working directory.  
+
+Nesting of
+.I include
+statements is limited to a maximum of five levels.
+
 .SS LABEL STATEMENT
 .RS
 label in3 "+5V"

Regards,

-- 
Mark M. Hoffman
mhoffman at lightlink.com