summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-03-23 07:37:16 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2006-03-23 07:37:16 +0000
commitb645dc5a4118feabd37d95fabbc6aaa803e3c45f (patch)
tree305ffea8613c8dce53e752d74ea3c07237cb6da2 /doc
parent6c8cf5dd571662f981227489f7c4652a1a1f10cd (diff)
Getopt::Long is a huge, heavy perl module. So why use it?
This {gross,amazing} hack makes all wrapped uses of ikiwiki forgo any option parsing at all. Options come in preparses via an env var from the wrapper. As a bonus, Wrapper.pm no longer needs to be updated when command line options are added to the program. Load time is sped up by around 10%. ikiwikiwrap --params is no longer supported by this change. You will need to rebuild your wrappers to take advantage of it.
Diffstat (limited to 'doc')
-rw-r--r--doc/usage.mdwn4
-rw-r--r--doc/wrapperparamstrick.mdwn20
2 files changed, 1 insertions, 23 deletions
diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 83866c1a8..b9744438b 100644
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -44,9 +44,7 @@ flags such as --verbose can be negated with --no-verbose.
The wrapper is designed to be safely made suid and be run by untrusted
users, as a [[Subversion]] [[post-commit]] hook, or as a [[CGI]].
- Note that the generated wrapper will ignore all command line parameters
- except for --params, which will make it print out the parameters it would
- run ikiwiki with.
+ Note that the generated wrapper will ignore all command line parameters.
* --wrappermode mode
diff --git a/doc/wrapperparamstrick.mdwn b/doc/wrapperparamstrick.mdwn
deleted file mode 100644
index d55629a79..000000000
--- a/doc/wrapperparamstrick.mdwn
+++ /dev/null
@@ -1,20 +0,0 @@
-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