(no commit message)

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

diff --git a/doc/install/discussion.mdwn b/doc/install/discussion.mdwn
index 69c2abddc2f60000ed7c86c0728377fb3e0b53ac..b4ec5ebf474a46335a89490b2b1e64a18e5de32c 100644 (file)
--- a/doc/install/discussion.mdwn
+++ b/doc/install/discussion.mdwn
@@ -280,11 +280,10 @@ This where my steps:
 
 As root (#):
 
 
 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/"
 
         mkdir -p "$HOME/downloads"
         cd "$HOME/downloads/"


@@ -294,31 +293,59 @@ As plain user ($):
         cd local-lib-1.006007/
         perl Makefile.PL --bootstrap=~/.perl5
         make test && make install
         cd local-lib-1.006007/
         perl Makefile.PL --bootstrap=~/.perl5
         make test && make install

-        echo 'eval $(perl -I$HOME/.perl5/lib/perl5 -Mlocal::lib)' >>~/.bashrc
+        echo 'eval $(perl -I$HOME/.perl5/lib/perl5 -Mlocal::lib=$HOME/.perl5)' >>~/.bashrc

         . ~/.bashrc
         curl -L http://cpanmin.us | perl - App::cpanminus
         . ~/.bashrc
         curl -L http://cpanmin.us | perl - App::cpanminus

-        source "/home/$USER/.bashrc"

         cpanm CGI::FormBuilder
         cpanm CGI::Session
         cpanm HTML::Parser
         cpanm HTML::Template
         cpanm CGI::FormBuilder
         cpanm CGI::Session
         cpanm HTML::Parser
         cpanm HTML::Template

-        cpanm -f HTML::Scrubber    # tests failed
+        cpanm HTML::Scrubber

         cpanm Text::Markdown
         cpanm URI
         cpanm Text::Markdown
         cpanm URI

+        cd ..

         tar -zxf ikiwiki_3.20100831.tar.gz
         cd ikiwiki/
         perl Makefile.PL INSTALL_BASE= PREFIX=/home/$USER/.perl5
         tar -zxf ikiwiki_3.20100831.tar.gz
         cd ikiwiki/
         perl Makefile.PL INSTALL_BASE= PREFIX=/home/$USER/.perl5

-        make tests   # All tests successful
-        make
+        make test    # All tests successful.

         make install INSTALL_BASE=/home/$USER/.perl5
         . ~/.bashrc
 
         make install INSTALL_BASE=/home/$USER/.perl5
         . ~/.bashrc
 

-Using cpan or cpanm with local::lib, you can install any other needed dependency, as plain user in your home (XS modules may need -dev packages)
+Using cpan or cpanm with local::lib, you can install any other dependency, as plain user (in your home). XS modules may need -dev packages.

 
 After all, here it's:
 
         ikiwiki -version
         ikiwiki version 3.20100831
 
 
 After all, here it's:
 
         ikiwiki -version
         ikiwiki version 3.20100831
 

-Hope this can be useful for someone.
+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.
+
+

 Iñigo
 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]]