X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/b2d0a940d8f975199bdb3f7e1590cf303eb0be1c..2aaab7db29f154816d6338a1329b42090209d966:/doc/wrapperparamstrick.mdwn

diff --git a/doc/wrapperparamstrick.mdwn b/doc/wrapperparamstrick.mdwn
new file mode 100644
index 000000000..d55629a79
--- /dev/null
+++ b/doc/wrapperparamstrick.mdwn
@@ -0,0 +1,20 @@
+ikiwiki --wrapper can be used to generate a wrapper
+program that runs ikiwiki with the specified parameters. This is used for
+[[post-commit]] hooks, [[CGI]], etc, both for convenience and because these
+things often need suid wrapper scripts to make ikiwiki run as the right
+user.
+
+The generated wrapper is a binary program. What if you want to regenerate
+it with different parameters, or just run ikiwiki like it would but with
+some parameter changed? To easily accomomplish this, the wrappers all
+support being run with --params, which causes them to print out the
+parameters they run ikiwiki with. 
+
+You can use this trick to regenerate a wrapper, adding or changing a
+parameter:
+
+	ikiwiki $(./ikiwiki-wrap --params) --wikiname="newname" --wrapper
+
+Or just to run ikiwiki like the wrapper would, and add a parameter:
+
+	ikiwiki $(./ikiwiki-wrap --params) --rebuild