p4vasp Version 0.3.29 (Release 1)
Distribution built:
February 18 2014

******************************************************************
*  p4vasp                                                        *
******************************************************************

Copyright notes:
The p4vasp is distributed under the General Public License version 2 (GPL2).

For more information and support visit www.p4vasp.at.

Binary distributions
==========================

Binary distribution contains a single executable file.
Place this file at a convenient location (e.g. Desktop)
and add it to the system PATH.
P4vasp is a portable application - it can be started from a usb drive.


Source-code distributions
==========================

Compilation Quickstart
--------------------------

For local installation run:

   install-local.sh

For global installation run:

   install.sh


Installation (local)
--------------------------

1) Make sure you have all the dependencies.
   In Ubuntu you can do it with a supplied script:
     install/install-ubuntu-dependencies.sh
2) If there are previous versions of p4vasp, uninstall them.
   You can do it with the uninstall.sh residing in the P4VASP_HOME directory.
3) Unpack the file:                tar -xvzf p4vasp-x.x.x.tgz
4) Change directory:               cd p4vasp-x.x.x
5) Configure:                      make local
6) check and adjust the paths in
   install/Configuration.mk
7) Install:                        make install
8) Add path to p4v in the .bashrc  make bashrc


Installation (global)
--------------------------

1) Make sure you have all the dependencies.
   In Ubuntu you can do it with a supplied script:
     install/install-ubuntu-dependencies.sh
2) Uninstall the old version (as root):
                        This usually (depending on your installation) can be done with an uninstall script:
                        sudo bash /usr/lib/p4vasp/uninstall.sh
3) Unpack the file:     tar -xvzf p4vasp-x.x.x.tgz
4) Change directory:    cd p4vasp-x.x.x
5) Configure:           make config
6) install (as root):   make install
x) If something goes wrong
   - Run the diagnostic.py script, it may provide you with some hints.
   - Check FAQ
   - We can try to help you if you visit forum at www.p4vasp.at, please provide us with the output from diagnostic.py.


Starting:
--------------------------

Start with: p4v

Look at the documentation in the doc/intro/intro.html
(or /usr/lib/p4vasp/doc/intro.html, when installed),
if you need some clues how to deal with the p4v GUI.

Some people prefer command-line tools and automatic scripts
to a graphical interface. For those, there are some simple
scripts in the utils directory (/usr/lib/p4vasp/utils).
They are also a good example for the p4vasp-API.


P4vasp package embeds the odpdom library, that is available also as a separate
project (http://sourceforge.net/projects/odpdom) and a slightly modified version
of the piddle library (piddle.sourceforge.net).
Both odpdom and piddle are available under the LGPL License (see
odpdom/COPYING).

This package as well may contain other packages (in ext directory) under various open-source licenses:
fltk (www.fltk.org), sqlite (www.sqlite.org) and pysqlite (code.google.com/p/pysqlite).
These packages are provided for convenience only to make the installation easier.

