document new alternative mechanism
fix issues in install.sh, following fabrice recommendations