
UPGRADING FROM EFM

* the typebuffer exists.  it opens when typing any of / ' Esc

* evidence --efm will select more efm'ish defaults (backdrop, icons, ...)

* evidence supports meta-data plugins; expect more info in tooltips.
  expect more info in file-info dialogs, often editable (edit MP3/ID3
  or Vorbis tags in evidence!).  evidence supports ACLs.  evidence
  supports automatic "emblems" ("read-only" labels etc.).



QUICKSTART GUIDE

* Tested regularly on Linux, intermittently on Solaris, FreeBSD, ...

* If this did not come as a package (RPM, Deb, ...), do the usual
  configure, make, make install.
  THE DEFAULTS ARE SENSIBLE.
  Changing anything but --prefix may enable experimental features.

* If there is no "configure", run "./autogen.sh" to create one!

* If you do not "make install", THINGS WILL BE VERY BROKEN!



WHEN IT'S REALLY REALLY SLOW

* Some themes using animations for opening folders/applications that
  are pigs.  Or show-offs, if you prefer.  Simply modify the theme to
  use leaner and meaner animation plugins, or use a different theme.



CONFIGURING EVIDENCE

* For a quick look at different themes, use the -T <theme> switch.

* evidence can be configured using evsh or exsh, using the evidence
  "typebuffer" micro-shell, or graphically using examine.
  (Type "help" in evsh; exsh/examine should come with instructions
  ("examine evidence" for a quick peek); and "'property-name value"
  to set properties in the type-buffer, '<tab> to show current
  properties.)



DEBUGGING EVIDENCE

* There seems to be some breakage in current (late 5.3 - 6.0) versions
  of gdb.  If evidence crashes in gdb, it bombs right out of the debugger
  or as soon as you ask for a "bt" (backtrace).  This works fine in early
  versions of gdb-5.3; later versions and gdb 6.0 seem to blow up on Linux.
  gdb-6.0 also seems to crash when trying to debug itself ("gdb gdb"
  in the gdb source-directory, or "gdb gdb", "(gdb) b internal_error").
  If you can at all, use an earlier version of gdb until this issue is
  resolved. : (



LOOKS

  EFMish look:            evidence --efm
  (which is short for)    evidence -T essence -iI --no-shelf --no-tabs

  with tabs ("notebook"): evidence --with-tabs

  with "shelf":           evidence --with-shelf

  start in icon-view:     evidence -i

  fish-tank theme:        evidence -T fishtank -i

  butterfly theme:        evidence -T metallo -i



IMPORTANT

  When there are no tabs, you can still get to all views:

                         icon-view   browser  tree-view
  - at start-up time:    -i          -b       -t
  - using the keyboard:  Alt-I       Alt-B    Alt-T
  - using the mouse:     right-click where no icon is

- The GTK2-tree related stuff /is/ slow on very large dirs
  (hundreds or thousands of items).  Sorry, but it's not me
  (if it were, the evas icon-view would be slow, as well) --
  if you need a tree-view on large dirs, kindly wait for the
  view that uses the EWL-tree instead of the GTK one.  : (

- This version seems to work on the author's machine, but
  has not been tested extensively.  USE AT YOUR PERIL!
  BY USING THIS YOU ACCEPT THAT ANYTHING BAD HAPPENING WHILE
  OR BECAUSE OF USING THIS PROGRAM IS YOUR FAULT, AND YOUR
  FAULT ONLY!



SCREENSHOTS

  http://evidence.sourceforge.net/features.html



AUTHOR

  Azundris  <evidence@azundris.com>  http://www.azundris.com/

  DO NOT report bugs directly to that address, please go through
  the mailing list.  If you do not wish to subscribe to the list,
  still post there and ask for a courtesy copy.  Thank you!
  See docs/FAQ for information on how to post to the mailing list.
