Add Gtk+2.0.
[pinentry.git] / README
1 PIN Entry
2 ---------
3
4 This is a collection of simple PIN or passphrase entry dialogs which
5 utilize the Assuan protocol as described by the aegypten project; see
6 http://www.gnupg.org/aegypten/ for details.
7
8 There are programs for different toolkits available.  For all GUIs it
9 is automatically detected which modules can be built, but it can also
10 be requested explicitely.
11
12 GUI             OPTION                   DEPENDENCIES
13 Curses          --enable-pinentry-curses Curses library, for example ncurses
14 GTK+ V1.2       --enable-pinentry-gtk    Gimp Toolkit Library Version 1.2
15                                          eg. libgtk-1.2 and libglib-1.2
16 GTK+ V2.0       --enable-pinentry-gtk2   Gimp Toolkit Library, Version 2.0
17                                          eg. libgtk-x11-2.0 and libglib-2.0
18 Qt              --enable-pinentry-qt     Qt, eg. libqt or libqt-mt
19
20 The GTK+ and Qt pinentries can fall back to the curses mode.  The
21 option to enable this is --enable-fallback-curses, but this is also
22 detected automatically in the same way --enable-pinentry-curses is.
23 The fallback to curses also works if --disable-pinentry-curses is
24 specified.  So to disable linking to curses completely you have to
25 pass --disable-fallback-curses to the configure script as well.
26
27 Examples:
28 * To only build the GTK+ 1.2 pinentry with curses support:
29 ./configure --enable-pinentry-gtk --enable-fallback-curses \
30         --disable-pinentry-curses --disable-pinentry-qt
31
32 * To build the Qt pinentry, and the other pinentries if they are
33   supported:
34 ./configure --enable-pinentry-qt
35
36 * To build everything that is supported (complete auto-detection):
37 ./configure
38
39 Some of the code is taken from Robert Bihlmeyer's Quintuple-Agent.
40 For security reasons, all internationalization has been removed.  The
41 client is expected to tell the PIN entry the text strings to be
42 displayed.