booh sort by exif date: fallback on filename content if exif date failed (many device...
[booh] / INSTALL
diff --git a/INSTALL b/INSTALL
index 4f55943ff4427a78adf0a8aa63545462b21572df..f4ba8910b0a4d79f5bebd8c849da5db70d9d8aea 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,12 +1,16 @@
 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
+- devel of libexiv2 (and thus, g++)
 
     Note: theoretically, gtk and ruby-gtk2 are not needed if
     you're gonna use only the backend script (the only lost
@@ -16,12 +20,16 @@ This software requires for compiling:
 
 And for runtime:
 
-- convert (from ImageMagick)
-
-For runtime, not strictly needed but nice to have:
-
-- transcode and mencoder (not strictly needed if you won't manipulate any video)
-
+- convert (from ImageMagick) - for photos thumbnails generation
+- 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)
+- 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
 
@@ -30,7 +38,7 @@ Type this as normal user:
  # ruby setup.rb config
  # ruby setup.rb setup
  # cd ext
- # ./build.sh
+ # ruby extconf.rb && make
 
 And type this as superuser:
 
@@ -39,16 +47,17 @@ And type this as superuser:
  $ make install
 
 If you want to package as normal user to another root:
- $ rm -rf %buildroot
- $ ruby setup.rb install --prefix=%buildroot
- $ cd ext
- $ make install DESTDIR=%buildroot libdir=%buildroot%{_libdir} archdir=%buildroot%ruby_archdir
 
- ruby_archdir being the result of: ruby -rrbconfig -e "puts Config::CONFIG['sitearchdir']"
+ $ ruby_archdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitearchdir']"`
+ $ libdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitelibdir']"`
+ $ rm -rf ${buildroot}
+ $ ruby setup.rb install --prefix=${buildroot}
+ $ cd ext
+ $ make install DESTDIR=${buildroot} libdir=${buildroot}${libdir} archdir=${buildroot}${ruby_archdir}
 
 Note: it will install things in traditional directories plus
-ruby_archdir and ruby_libdir, the latter one being the result of
-ruby -rrbconfig -e "puts Config::CONFIG['sitelibdir']"
-
+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 you menu system in the icons/ subdir.
+Find desktop stuff (.desktop entry and icons) for your menu/packaging system
+in the destkop/ subdir.