Git Repositories

Merge branch 'master' of ssh://git.xfce.org/git/xfce/thunar
[thunar.git] / README
1 What is it?
2 ===========
3
4 Thunar is a modern file manager for the Unix/Linux desktop, aiming to be
5 easy-to-use and fast.
6
7 THIS BRANCH (migration-to-gio) IS CONSIDERED HIGHLY EXPERIMENTAL! It is
8 used for the migration from ThunarVFS to GIO as part of a student thesis:
9
10   http://lunar-linux.org/~jannis/migrating-thunar-to-gio/
11
12
13 Required packages
14 =================
15
16 Thunar depends on the following packages:
17
18  - perl 5.6 or above
19  - GTK+ 2.6.0 or above
20  - libexo 0.3.2 or above
21  - intltool 0.30 or above
22  - libpng12 1.2.0 or above
23  - shared-mime-info 0.15 or above
24  - desktop-file-utils 0.10 or above
25
26 Thunar can optionally use the following packages:
27
28  - D-BUS 0.34 or above (strongly suggested)
29  - HAL 0.5.0 or above (esp. the libhal-storage devel package)
30  - freetype 2.0 or above (for the font thumbnailer)
31  - gamin 0.1.0 or above
32  - gconf 2.4 or above
33  - libexif 0.6 or above
34  - libjpeg 6 or above
35  - libstartup-notification 0.4 or above
36  - pcre 6.0 or above
37  - xfce4-panel 4.3.90 or above (for the trash applet)
38
39
40 Installation
41 ============
42
43 The file 'INSTALL' contains generic installation instructions. For more
44 detailed information, visit the Thunar website at http://thunar.xfce.org/.
45
46
47 Debugging Support
48 =================
49
50 Thunar currently supports four different levels of debugging support, which
51 can be setup using the configure flag `--enable-debug' (check the output of
52 `configure --help'):
53
54   `full'        Use this if you want to debug Thunar to locate a bug. The
55                 build will most probably be noticably slower. This is also
56                 recommended for people that want to develop Thunar stuff.
57
58   `yes'         This is the default for SVN snapshot builds. It adds all
59                 kinds of checks to the code, and is therefore likely to run
60                 slower. Use this if you want to develop for Thunar (e.g.
61                 writing Thunar extensions and such).
62
63   `minimum'     This is the default for release builds, and presents the
64                 recommended behaviour.
65
66   `no'          Disables all sanity checks. Don't use this unless you know
67                 exactly what you do.
68
69
70 Standards compliance
71 ====================
72
73 Thunar supports the following standards/specifications:
74
75   * XDG Base Directory Specification
76     http://freedesktop.org/wiki/Standards_2fbasedir_2dspec
77
78   * Shared MIME Database Specification
79     http://freedesktop.org/wiki/Standards_2fshared_2dmime_2dinfo_2dspec
80
81   * X Direct Save (XDS) Protocol for the X Window System
82     http://freedesktop.org/wiki/Standards_2fdirect_2dsave
83
84   * Icon Theme Specification
85     http://freedesktop.org/wiki/Standards_2ficon_2dtheme_2dspec
86
87   * Thumbnail Managing Standard
88     http://jens.triq.net/thumbnail-spec/index.html
89
90   * File URI Specification
91     http://freedesktop.org/wiki/Standards_2ffile_2duri_2dspec
92
93   * Desktop Trash Can Specification
94     http://freedesktop.org/wiki/Standards_2ftrash_2dspec
95
96
97 How to report bugs?
98 ===================
99
100 Bugs should be reported to the Xfce bug tracking system
101 (http://bugzilla.xfce.org, product Thunar). You will need to
102 create an account for yourself.
103
104 Please read the HACKING file for information on where to send
105 changes or bugfixes for this package.