comment

[git.ikiwiki.info.git] / doc / install / discussion.mdwn

diff --git a/doc/install/discussion.mdwn b/doc/install/discussion.mdwn
index c21664c79ccc286756d86e097877704604ff7248..b27cc4bacb13d011dc16aee6243265f0fe132fec 100644 (file)
--- a/doc/install/discussion.mdwn
+++ b/doc/install/discussion.mdwn
@@ -280,11 +280,10 @@ This where my steps:
 
 As root (#):
 
-    # aptitude install build-essential curl perl
+        aptitude install build-essential curl perl
 
-As plain user ($):
 
-    I use to install user perl modules using local::lib
+As plain user ($), I use to install user perl modules using local::lib
 
         mkdir -p "$HOME/downloads"
         cd "$HOME/downloads/"
@@ -319,9 +318,41 @@ After all, here it's:
         ikiwiki -version
         ikiwiki version 3.20100831
 
-But it seems like this installation looses the /etc files...
+It seems like this installation looses the /etc files (we're as plain user), but this can be used as a workaround:
+
+        ikiwiki -setup ~/downloads/ikiwiki/auto.setup
+
+I've not investigated more the /etc files ussage, but does not seems like a good idea to be as plain user...
+
+        /etc/ikiwiki/wikilist does not exist
+        ** Failed to add you to the system wikilist file.
+        ** (Probably ikiwiki-update-wikilist is not SUID root.)
+        ** Your wiki will not be automatically updated when ikiwiki is upgraded.
 
-        $ find /home/ikiwiki/.perl5/ -iname '*.setup'
-        $
 
 Iñigo
+
+-----
+
+
+Portability fixes encountered while maintaining the pkgsrc package:
+
+* In `IkiWiki::Setup::Standard::gendump()`, generate a shebang
+  matching the current `perl`.
+* In `Makefile.PL`, provide overridable defaults for `SYSCONFDIR`
+  and `MANDIR`.
+* In `Makefile.PL`, use `perl` to bump `ikiwiki.spec` instead of
+  `sed -i`.
+* In `Makefile.PL`, specify more portable options to `cp`.
+
+I've attempted to mergeably patch these in my git, commit
+5c177c96ac98b24aaa0613ca241fb113f1b32c55.
+
+--[[schmonz]]
+
+-----
+
+[[!template id=gitbranch branch=schmonz/portability author="[[schmonz]]"]]
+
+My git was in a screwy state so I started over. These changes are
+now on a branch. --[[schmonz]]