workaround exif crash
[booh] / INSTALL
diff --git a/INSTALL b/INSTALL
index 71cc7635fec5fc7b10d02e8a3670e544855faf33..6066c8f9fa89c8cd9e9921baaeff56e511792bc7 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -24,8 +24,7 @@ And for runtime:
 - identify (from ImageMagick) - for photos captions
 - exif - to show full formatted EXIF information from photos
 - mplayer - for videos thumbnails generation
-- ffmpeg (with mp3lame compiled in) - for generating embedded
-  .flv videos, to use with flowplayer (may not be a hard require)
+- ffmpeg - for generating .mp4 videos
 - 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)
@@ -40,19 +39,33 @@ Type this as normal user:
  # cd ext
  # ruby extconf.rb && make
 
-If that fails on missing GTK header file (gtk.h), you can try to
-inject cflags with such a command:
+*** Troubleshooting:
+
+- on ubuntu 20, I received a failure on mkmf-gnome2 lib loading
+  indicating missing mkmf-gnome, and "sudo gem install gtk3"
+  workarounded 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 still fails on redefinition of struct re_registers, you can
-try to workaround with:
+- 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