X-Git-Url: http://git.zarb.org/?p=booh;a=blobdiff_plain;f=INSTALL;h=e0c1787d026cfd73c6c9a1096f2bc99a8875dcc0;hp=a259b813f2c88a0cb736828ff01c19df1f641b5d;hb=3638b1933c7b824029e4fe010dec76db9fa9f7bc;hpb=1c949fbc2f7d12359596b0a761fe59e68dc7eb46

diff --git a/INSTALL b/INSTALL
index a259b81..e0c1787 100644
--- a/INSTALL
+++ b/INSTALL
@@ -29,7 +29,7 @@ And for runtime:
 - gimp - for photos editing (may not be a hard require)
 - mozilla-firefox - for showing albums in browser, and going on the
   web for tutorials (may not be a hard require)
-
+- lftp - for uploading web-albums
 
         Compiling and Installing Quick Start
 
@@ -40,6 +40,32 @@ Type this as normal user:
  # cd ext
  # ruby extconf.rb && make
 
+*** Troubleshooting:
+
+- on ubuntu 20, I receive a failure on mkmf-gnome2 lib loading indicating missing
+  mkmf-gnome; "sudo gem install gtk3" workarounds this problem
+
+- if that fails on missing GTK header file (gtk.h), you can try to
+  inject cflags with such a command:
+
+ # perl -pi -e 's/(CXXFLAGS.*)/$1 `pkg-config --cflags gtk+-2.0`/' Makefile
+ # make
+
+- if that fails on redefinition of struct re_registers and you have
+  ruby-2.3, you can try to workaround with:
+
+ # cp /usr/include/ruby-2.3.0/ruby.h .
+ # perl -pi -e 's/.*HAVE_RUBY_ENCODING_H.*//' ruby.h
+ # make
+
+- if that fails on redefinition of struct re_registers and you have
+  ruby-2.5, you can try to workaround with:
+
+ # mkdir exiv2
+ # cp -a /usr/include/exiv2/* exiv2
+ # perl -pi -e 's/#define EXV_HAVE_REGEX 1//' exiv2/exv_conf.h
+ # make
+
 And type this as superuser:
 
  $ ruby setup.rb install