5 \h'-\w'\\$1\ 'u'\\$1\ \c
11 .TH splitconf 1 "9 October 2003" "Straylight/Edgeware"
13 splitconf \- break a single configuration file out into small chunks
33 program breaks a configuration file into lots of small files, and
34 remembers what they are. It is designed to be
36 if writing any of the components fails, none of the files is changed.
37 Alas, the update is not quite atomic -- doing that involves messing with
38 symbolic links and is just too much like hard work.
40 The command-line arguments are as follows:
43 Print a very short help message to standard output and exit.
49 .BR splitconf -managed
54 Delete the files split out from
60 (This is the default.)
67 section, followed by a number of
71 The preamble section may contain:
73 blank lines, which are ignored;
75 meta-comments, which begin with a
77 pair, and are also ignored;
79 option settings, of the form
85 one-liner file contents descriptions, of the form
90 A file section begins with a line of the form
94 and is followed by lines to write to the file. In these lines, comments
95 (lines beginning with a
97 are stripped out, and any trailing blank lines are removed. Also, any
98 line beginning with an exclamation mark
100 is written out with the leading exclamation mark removed.
102 A file section with an empty
104 is treated specially: its contents are scanned for more preamble
107 Options are as follows.
110 A string to attach to the front of all subsequent filenames, until
111 overridden. (Default is empty.)
114 A shell command to execute before starting to write any files. There is
115 only one before-command, which is the one current when the first file is
119 A shell command to execute after committing the changes or backing out.
120 There is only one after-command, which is the last one set in the
125 Mark Wooding, <mdw@nsict.org>