README

What is it?
===========

Thunar is a modern file manager for the Unix/Linux desktop, aiming to be
easy-to-use and fast.


Required packages
=================

Thunar depends on the following packages:

 - perl 5.6 or above
 - GTK+ 2.24.0 or above
 - GLib 2.30.0 or above
 - exo 0.10.0 or above
 - intltool 0.30 or above

Thunar can optionally use the following packages:

 - D-Bus 0.34 or above (strongly suggested)
 - libstartup-notification 0.4 or above
 - xfce4-panel 4.10.0 or above (for the trash applet)
 - xfconf-query


Installation
============

The file 'INSTALL' contains generic installation instructions. For more
detailed information, visit the Thunar website at http://thunar.xfce.org/.


Debugging Support
=================

Thunar currently supports four different levels of debugging support, which
can be setup using the configure flag `--enable-debug' (check the output of
`configure --help'):

  `full'	Use this if you want to debug Thunar to locate a bug. The
  		build will most probably be noticably slower. This is also
		recommended for people that want to develop Thunar stuff.

  `yes'		This is the default for SVN snapshot builds. It adds all
  		kinds of checks to the code, and is therefore likely to run
		slower. Use this if you want to develop for Thunar (e.g.
		writing Thunar extensions and such).

  `minimum'	This is the default for release builds, and presents the
  		recommended behaviour.

  `no'		Disables all sanity checks. Don't use this unless you know
  		exactly what you do.


Standards compliance
====================

Thunar supports the following standards/specifications:

  * XDG Base Directory Specification
    http://freedesktop.org/wiki/Standards_2fbasedir_2dspec

  * Shared MIME Database Specification
    http://freedesktop.org/wiki/Standards_2fshared_2dmime_2dinfo_2dspec

  * X Direct Save (XDS) Protocol for the X Window System
    http://freedesktop.org/wiki/Standards_2fdirect_2dsave

  * Icon Theme Specification
    http://freedesktop.org/wiki/Standards_2ficon_2dtheme_2dspec

  * Thumbnail Managing Standard
    http://jens.triq.net/thumbnail-spec/index.html

  * File URI Specification
    http://freedesktop.org/wiki/Standards_2ffile_2duri_2dspec

  * Desktop Trash Can Specification
    http://freedesktop.org/wiki/Standards_2ftrash_2dspec


How to report bugs?
===================

Bugs should be reported to the Xfce bug tracking system
(http://bugzilla.xfce.org, product Thunar). You will need to
create an account for yourself.

Please read the HACKING file for information on where to send
changes or bugfixes for this package.