From: http://anastigmatix.net/ Date: Sun, 21 Sep 2014 21:37:11 +0000 (-0400) Subject: create question about setup updates following ikiwiki updates X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/commitdiff_plain/35233214bd655638d0fe80ea18ee1915e4a32255 create question about setup updates following ikiwiki updates --- diff --git a/doc/forum/best_way_to_update_setup_file_after_an_ikiwiki_update__63__.mdwn b/doc/forum/best_way_to_update_setup_file_after_an_ikiwiki_update__63__.mdwn new file mode 100644 index 000000000..8dfd5180c --- /dev/null +++ b/doc/forum/best_way_to_update_setup_file_after_an_ikiwiki_update__63__.mdwn @@ -0,0 +1,41 @@ +Ok, I'm trying to get into a good routine where I keep ikiwiki updated for my site. +The plan is to keep a local (partial) git clone, and rebuild from tagged release commits. + +I started out with 3.20140831, more or less like this: + + $ git clone ... + $ git checkout 3.20140831 + $ perl Makefile.PL PREFIX=$HOME/blah + $ make + $ make install + $ cd ~/my-wiki-admin-stuff + $ ~/blah/bin/ikiwiki --dumpsetup=my.wiki.setup + $ vi my.wiki.setup + $ ~/blah/bin/ikiwiki --setup my.wiki.setup + +So far so good. Fast-forward (heh) to 3.20140916: + + $ git fetch ... + $ git merge --ff-only FETCH_HEAD + $ git checkout 3.20140916 + $ perl Makefile.PL ... ; make ; make install + $ cd ~/my-wiki-admin-stuff ; ~/blah/bin/ikiwiki --setup my.wiki.setup + +This happened to work, but in general if the new ikiwiki version had new +setup options I needed to know about, I wouldn't necessarily find out, and +I could be running the new version with something important taking an +inappropriate default because I didn't add it to the setup file. + +What I'm looking for is some sort of + + ikiwiki --read-my-current-setup-file-and-write-one-with-the-same-config-but-with-new-options-shown-and-commented + +command. + +Will `ikiwiki --changesetup setupfile` do what I'm looking for? + +I'm hoping for something simple that takes care of the way the setup sections are conditional +(so `--dumpsetup` doesn't even show you `git` options unless it knows `rcs=git`, so ideally it +would look in the current setup to learn what to dump). + +How are other folks handling this routinely?