X-Git-Url: http://git.tremily.us/?p=ikiwiki.git;a=blobdiff_plain;f=README;h=fdb63227d02e7f26f778e38b327c62413cce9b88;hp=e9ee15dfe91c1e91e4d0a171678911d04f563cce;hb=12c5786df4e74c143f24398b8d0028000b61daba;hpb=0751429ba0cb4cf9a8c132daf54e7dc8dca36df6 diff --git a/README b/README index e9ee15dfe..fdb63227d 100644 --- a/README +++ b/README @@ -1,4 +1,21 @@ -Use ./Makefile.PL to generate a Makefile, "make" will generate docs and a -man page, and "make install" will install ikiwiki. +Use ./Makefile.PL to generate a Makefile, "make" will build the +documentation wiki and a man page, and "make install" will install ikiwiki. -All other documentation is in the ikiwiki documentation wiki. +A few special variables you can set while using the Makefile: + +PROFILE=1 turns on profiling for the build of the doc wiki. Uses Devel::Profile + +NOTAINT=0 turns on the taint flag in the ikiwiki program. (Not recommended +unless your perl is less buggy than mine -- see +http://bugs.debian.org/411786) + +There are also other variables supported by MakeMaker, including PREFIX, +INSTALL_BASE, and DESTDIR. See ExtUtils::MakeMaker(3). + +In particular, INSTALL_BASE is very useful if you want to install ikiwiki +to some other location, as it configures it to see the perl libraries +there. See `doc/tips/nearlyfreespeech.mdwn` for an example of using this to +install ikiwiki and its dependencies in a home directory. + +All other documentation is in the ikiwiki documentation wiki, which is also +available online at