==============================================================================
             * * * README file for espresso/GUI directory * * *
 ==============================================================================


This directory contains the Graphical-User-Interface (GUI) for PWscf.

This directory hosts two subdirectories:

  1. PWgui/ -- the GUI itself
  2. Guib/  -- the engine that the PWgui uses

The PWgui GUI is based on Guib engine (see
http://www-k3.ijs.si/kokalj/guib/guib.html). Currently, the Guib
engine is also included in QE repository (espresso/GUI/Guib
directory).


IMPORTANT: 
**********

	1. Enter the PWgui/ directory and read the following files:
			INSTALL.svn      (REQUIRED)
			INSTALL          (optional)
			README           (optional)
			README.developer (optional)

	2. The Guib/ directory can be treated as "technicalities", and
	   except you want to develop Guib, you do not need to enter ever
	   in that directory