mirror of https://gitlab.com/QEF/q-e.git
106 lines
3.2 KiB
Plaintext
106 lines
3.2 KiB
Plaintext
|
|
________________________________________________________________________
|
|
|
|
*** INSTALLATION instructions for PWgui ***
|
|
________________________________________________________________________
|
|
|
|
|
|
The PWgui package comes in two flavors:
|
|
|
|
(i) STANDALONE EXECUTABLE, which runs out of the box (but works
|
|
only on the platform for which it has been built)
|
|
|
|
(ii) SOURCE PACKAGE
|
|
|
|
N.B.: for the usage of repository version of PWgui see file INSTALL.repository
|
|
|
|
________________________________________________________________________
|
|
|
|
(i) Installation instructions for STANDALONE EXECUTABLE
|
|
________________________________________________________________________
|
|
|
|
For zipped pwgui-xxx.zip package do:
|
|
|
|
* unzip pwgui-xxx.zip
|
|
|
|
whereas for tar-gzipped pwgui-xxx.tgz package do either:
|
|
|
|
* tar zxvf pwgui-xxx.tgz
|
|
or:
|
|
* gunzip -c pwgui-xxx.tgz | tar xvf -
|
|
|
|
To launch the program type either:
|
|
|
|
* ./pwgui
|
|
or
|
|
* pwgui
|
|
|
|
|
|
The standalone executable is always available for Linux platform, and
|
|
occasionally also for Mac and Windows.
|
|
|
|
|
|
________________________________________________________________________
|
|
|
|
(ii) Installation instructions for SOURCE PACKAGE
|
|
________________________________________________________________________
|
|
|
|
|
|
To use the source package you need required Tcl software, in
|
|
particular Tcl + Tk + Itcl + Itk + Iwidgets. PWgui requires the Tcl/Tk
|
|
version 8.4 or later. You may install the software from your OS
|
|
distribution.
|
|
|
|
For example, for GNU/Linux Debian-based distributions, execute as root
|
|
(or sudo):
|
|
|
|
* apt-get update; apt-get install iwidgets4
|
|
|
|
(this will install also tcl/tk/itcl/itk, because iwidgets depend on them).
|
|
On RedHat-based distributions, the analogous command is "yum". Hence:
|
|
|
|
* yum install iwidgets
|
|
|
|
As for the Archlinux consider the following installation instructions
|
|
(due to Gonzalo Aguirre): neither itk nor iwidgets are in the official
|
|
repositories, so they should be obtained from the AUR using the
|
|
following recipe:
|
|
|
|
* yaourt -S itk-cvs
|
|
* yaourt -S iwidgets
|
|
|
|
If an issue arises during the iwidgets installation, check where the
|
|
itk-cvs is installed (pacman -Ql itk-cvs) and specify the directory
|
|
explicitly while building the iwidgets package (e.g.:
|
|
--with-itk=/usr/lib/itk3.4)
|
|
|
|
|
|
Alternatively you may install ActiveTcl8.4 (which has all the required
|
|
software built-in) from:
|
|
|
|
http://www.activestate.com/activetcl/downloads/
|
|
|
|
BEWARE: do not install the newer 8.5 or 8.6 version of ActiveTcl,
|
|
because they do not contain all the needed software. The
|
|
version 8.4 is mandatory !!!
|
|
|
|
|
|
Once your computer has all the needed software, your source package is
|
|
ready to run. You only need to untar the PWgui source tarball, i.e.:
|
|
|
|
* gunzip -c PWgui-<version>.tgz | tar xvf -
|
|
or
|
|
* tar zxvf PWgui-<version>.tgz
|
|
|
|
where <version> stands for version number. To launch the PWgui
|
|
program, type: pwgui.
|
|
|
|
You may add the PWgui root directory to your PATH.
|
|
|
|
If you would like to copy "pwgui" launcher to some common place, such
|
|
as /usr/local/bin, then you need either to define PWGUI environmental
|
|
variable so that "pwgui" will be able to locate its root directory
|
|
(i.e. source files) or alternatively hardcode it into pwgui lanucher
|
|
itself.
|
|
|