Merge branch 'master' into xapian
[ikiwiki] / doc / bugs / Command-line_arguments_should_override_settings_in_the_setup_file.mdwn
1 In setting up my wiki I followed the [[setup]] instruction which point
2 to an [[ikiwiki.setup]] file that contains "verbose => 0".
3
4 I hadn't noticed that setting in there, but later when I changed my
5 standard command of:
6
7         ikiwiki --setup ikiwiki.setup
8
9 to:
10
11         ikiwiki --verbose --setup ikiwiki.setup
12
13 I was quite surprised that that change didn't have any effect.
14
15 So two suggestions to fix this:
16
17 1. Make command-line arguments override settings in the setup file
18
19 > This is difficult to do, since reading a setup file replaces values for
20 > config items with the values in the setup file. Also, when you say
21 > --setup foo, you're asking ikiwiki to set up the wiki using the
22 > comnfiguration in file foo. Which is what it does.
23
24 2. Comment out all settings in the example setup file that are simply
25    setting options to their default values. That way, the file will
26    still be self-documenting, but command-line arguments will at least
27    work for these settings while they remain commented out.
28
29 > I've done that, I also fixed some issues with --verbose handling earlier.
30 > I'm pretty sure that those fixes fix the real issue, so calling this
31 > [[done]].
32 > --[[Joey]]