doc/forum/best_way_to_update_setup_file_after_an_ikiwiki_update__63__.mdwn

   1 Ok, I'm trying to get into a good routine where I keep ikiwiki updated for my site.
   2 The plan is to keep a local (partial) git clone, and rebuild from tagged release commits.
   3
   4 I started out with 3.20140831, more or less like this:
   5
   6     $ git clone ...
   7     $ git checkout 3.20140831
   8     $ perl Makefile.PL PREFIX=$HOME/blah
   9     $ make
  10     $ make install
  11     $ cd ~/my-wiki-admin-stuff
  12     $ ~/blah/bin/ikiwiki --dumpsetup=my.wiki.setup
  13     $ vi my.wiki.setup
  14     $ ~/blah/bin/ikiwiki --setup my.wiki.setup
  15
  16 So far so good. Fast-forward (heh) to 3.20140916:
  17
  18     $ git fetch ...
  19     $ git merge --ff-only FETCH_HEAD
  20     $ git checkout 3.20140916
  21     $ perl Makefile.PL ... ; make ; make install
  22     $ cd ~/my-wiki-admin-stuff ; ~/blah/bin/ikiwiki --setup my.wiki.setup
  23
  24 This happened to work, but in general if the new ikiwiki version had new
  25 setup options I needed to know about, I wouldn't necessarily find out, and
  26 I could be running the new version with something important taking an
  27 inappropriate default because I didn't add it to the setup file.
  28
  29 What I'm looking for is some sort of
  30
  31     ikiwiki --read-my-current-setup-file-and-write-one-with-the-same-config-but-with-new-options-shown-and-commented
  32
  33 command.
  34
  35 Will `ikiwiki --changesetup setupfile` do what I'm looking for?
  36
  37 I'm hoping for something simple that takes care of the way the setup sections are conditional
  38 (so `--dumpsetup` doesn't even show you `git` options unless it knows `rcs=git`, so ideally it
  39 would look in the current setup to learn what to dump).
  40
  41 How are other folks handling this routinely?