README

   1 Graphical User Interfaces, The UNIX Way
   2 =======================================
   3
   4 Pipeglade is a helper program that displays graphical user interfaces
   5 for other programs. It renders the GUI definition found in a
   6 GtkBuilder file (created using the Glade Interface Designer), and
   7 communicates with the main program solely via pipes or fifos.
   8
   9 Visit http://pipeglade.boundp.org
  10
  11
  12 INSTALLATION
  13 ============
  14
  15   make
  16
  17 should build a usable binary.
  18
  19   make PREFIX=/some/dir/ install
  20
  21 installs the pipeglade binary in /some/dir/bin/ and its manual page in
  22 /some/dir/man/man1/.  Default PREFIX is /usr/local/.
  23
  24 To get rid of the installation, call
  25
  26   make uninstall
  27
  28 or
  29
  30   make PREFIX=/some/dir/ uninstall
  31
  32 respectively.
  33
  34
  35 TESTS AND FIRST STEPS
  36 =====================
  37
  38   ./pipegladetest.sh
  39
  40 runs pipeglade's tests (which require some human assistance).  The
  41 GtkBuilder file for the test GUI, pipeglade.ui, is also used in the
  42 demonstration script
  43
  44   ./echo.sh,
  45
  46 which redirects the messages initiated by user activity on the GUI
  47 back into a text area of the same GUI.  Another example,
  48
  49   ./clock.sh,
  50
  51 uses the GtkBuilder file clock.ui and displays an analog clock.
  52
  53 There are three other example GtkBuilder files.  To see how they look
  54 like, call
  55
  56   ./pipeglade -u simple_dialog.ui
  57
  58 or
  59
  60   ./pipeglade -u simple_open.ui.
  61
  62 The third one, bad_window.ui, is for testing, and is intentionally
  63 broken.
  64
  65
  66 SUCCESSFUL BUILDS
  67 =================
  68
  69 FreeBSD 10.1, GTK+ 3.14.5
  70 Debian wheezy, GTK+ 3.4.2