ubuntu 20
[booh] / INSTALL
diff --git a/INSTALL b/INSTALL
index 281f0bd7ea9dedeff861881cddc119ea25cf10df..e0c1787d026cfd73c6c9a1096f2bc99a8875dcc0 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,10 +1,14 @@
 This software requires for compiling:
 
-- gtk >= 2.6
+- gtk >= 2.8
 - devel of gtk
 - ruby
 - ruby-gettext >= 0.8.0
-- ruby-gtk2 >= 0.12
+- ruby-gtk2 >= 0.12; notice:
+  - ruby-gtk2 0.15.0, 0.17.0 and 0.18.1 should be avoided, they are known
+    problematic versions
+  - with ruby >= 1.8.7, ruby-gtk2 >= 0.18.0 should be used, otherwise
+    crashes will occur
 - devel of ruby-gnome2 (mkmf-gnome2.rb, rbgobject.h)
 - devel of libexiv2 (and thus, g++)
 
@@ -20,8 +24,12 @@ And for runtime:
 - identify (from ImageMagick) - for photos captions
 - exif - to show full formatted EXIF information from photos
 - mplayer - for videos thumbnails generation
-- gimp - for photos editing
-
+- ffmpeg (with mp3lame compiled in) - for generating embedded
+  .flv videos, to use with flowplayer (may not be a hard require)
+- 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
 
@@ -32,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
@@ -51,4 +85,5 @@ Note: it will install things in traditional directories plus
 ruby_archdir and ruby_libdir.
 Change FPATH in ${buildroot}/local/lib/site_ruby/1.8/booh/config.rb to suit your $buildroot
 
-Find icons for your menu system in the icons/ subdir.
+Find desktop stuff (.desktop entry and icons) for your menu/packaging system
+in the destkop/ subdir.