Commit aef3fd25 authored by thomas.forbriger's avatar thomas.forbriger

[WP] (install): adjust installation instructions to match Seitosh

parent 5746cd26
......@@ -6,7 +6,7 @@ Recommended steps to take
1. Read [src/README.compile](src/README.compile)
which provides a thourough overview of requirements and
environment variables expected by Makefiles.
2. Read [src/README.pgplot](src/README.pgplot)
2. Read [contrib/pgplot/README.pgplot](contrib/pgplot/README.pgplot)
to understand how to install the PGPLOT library, which is
required by programs producing graphical output.
3. Once you feel ready (having installed all required compilers
......
......@@ -10,6 +10,8 @@
#
# ============================================================================
#
# options to be set for src/compile.sh
COMPILEOPT=--pause
all:
......@@ -32,6 +34,15 @@ edit: flist; vim $<
clean: ;
-find . -name \*.bak | xargs --no-run-if-empty /bin/rm -v
-/bin/rm -vf flist
src/compile.sh $(COMPILEOPT) clean
# ======================================================================
# compile and install
#
# install
.PHONY: install
.PHONY: doc
.PHONY: all
install doc all: %: ; src/compile.sh $(COMPILEOPT) $@
# ----- END OF Makefile -----
......@@ -21,14 +21,10 @@
# 13/10/2010 V1.2 add MATLABBINDIR
# 21/01/2011 V1.3 add TF_EDIT
# 03/02/2014 V1.4 discard TF_REMCMMNT
# 20/05/2015 V1.5 adjust for Seitosh
#
# ============================================================================
#
# I recommend that you use the following settings for character encoding:
#
## export LANG=de_DE@utf8
## export GDM_LANG=de_DE@utf8
## export LC_MESSAGES=C
# default is: grant write permission only to file owner
umask 022
......@@ -55,8 +51,8 @@ umask 022
## esac
# ----------------------------------------------------------------------------
#
# set standard environment variables (see README.compile)
# -------------------------------------------------------
# set standard environment variables (see src/README.compile)
# -----------------------------------------------------------
# set standard locations
export LOCBINDIR=$HOME/bin
......@@ -96,33 +92,6 @@ export CPPFLAGS="-I$LOCINCLUDEDIR -I$SERVERINCLUDEDIR"
export LDFLAGS="-L$LOCLIBDIR -L$SERVERLIBDIR"
export FFLAGS="-ff2c -Wall -ffixed-line-length-0 -fno-backslash"
# ----------------------------------------------------------------------------
# variables needed by maintainers (not by package users)
# ------------------------------------------------------
# a helpful variable when using TFSoftware
# e.g. you can call
#
# svn switch $SVNTF/branches/anybranch
#
# when switching to another branch <anybranch>
export SVNTF=http://gpitrsvn.gpi.uni-karlsruhe.de/repos/TFSoftware
# path to pure git export repository (used in Makefile.packages - see there)
export GITTFSEXPORT=$HOME/git/TFSoftware.export
# place to drop packages
export TF_PUBLICATIONPATH=$HOME/public_html/download/software
# path of Makefile.packages
# this should be set only for package maintainers
#export TF_MAKEPKG=$HOME/work/src/pakete/Makefile.packages
# used for make edit rules, if desired
#export TF_EDIT="$HOME/work/src/Makefile.buildingblocks \
# $HOME/work/src/README.dependencies \
# $HOME/git/TFSoftware/texts/thof/*.txt"
# ----------------------------------------------------------------------------
# execution path and man path
......
this is <README.pgplot>
============================================================================
information on PGPLOT usage
---------------------------
$Id: $
Quick installation instructions for PGPLOT
============================================================================
This is a copy of
http://gpitrsvn.gpi.uni-karlsruhe.de:8000/TFSoftware/wiki/docs/PGPLOT
to support offline usage of packages
https://git.scc.kit.edu/Seitosh/Seitosh/wikis/doc/PGPLOT
to support offline usage.
Purpose
=======
PGPLOT (http://www.astro.caltech.edu/~tjp/pgplot/) is a Fortran graphics
library for scientific data display. Many programs in this repository make use
of PGPLOT either directly in Fortran or through the C++ API (libpgplot++).
of PGPLOT either directly in Fortran or through the C++ API (libpgplotxx).
PGPLOT supports output to many different devices, including interactive screen
plots als well as Postscript files. In the early days PGPLOT was attractive in
particular due to his ability to produce interactive screen plots from Fortran
......@@ -32,12 +30,14 @@ with specific notes for Unix systems:
http://www.astro.caltech.edu/~tjp/pgplot/install-unix.html
Quick installation guide for use with TFSoftware
------------------------------------------------
Quick installation guide for use with Seitosh
---------------------------------------------
1. Download pgplot5.2.tar.gz
from http://www.astro.caltech.edu/~tjp/pgplot/ (download address is
ftp://ftp.astro.caltech.edu/pub/pgplot/pgplot5.2.tar.gz)
2. Copy `pgplot5.2.tar.gz` to `~/repo/pgplot`
3. Extract tar file:
tar xvfpsz pgplot5.2.tar.gz
......@@ -53,19 +53,19 @@ Quick installation guide for use with TFSoftware
We call this the ''source-code directory''. Any other directory name or
path for the ''source-code directory'' will do as well, just use its name
consistently throughout the installation process.
5. PGPLOT does not come with `gfortran` support.
To use `gfortran` to compile PGPLOT, you might like to copy one of the
files in the attachment of the wiki page to
files in contrib/pgplot to
`~/repo/pgplot/pgplot5.2.2/sys_linux`:
gfortran_gcc.conf uses standard system library paths
gfortran_gcc_64.conf uses path names `lib64` to refer to X11
and TK libraries (this is necessary on 64bit
systems to links against the 64bit version of
and TK libraries (it is necessary on 64bit
systems to link against the 64bit version of
the binary library instead of the 32bit
version).
In snapshot packages these files are provided in directory
contrib/pgplot.
Edit the files to match your system configuration
6. Create the library directory
mkdir -pv ~/repo/pgplot/linuxgfortran
......@@ -75,6 +75,7 @@ Quick installation guide for use with TFSoftware
files, and documentation. Any other directory name or path for the
''installation directory'' will do as well, just use its name
consistently throughout the installation process.
7. Change your working directory to the ''installation directory'':
cd ~/repo/pgplot/linuxgfortran
......@@ -98,6 +99,7 @@ Quick installation guide for use with TFSoftware
Further drivers may be activated but some of them require special
prerequisites. See comments in the ''source-code directory'' for details.
10. Call
~/repo/pgplot/pgplot5.2.2/makemake ~/repo/pgplot/pgplot5.2.2 linux gfortran_gcc
......@@ -108,12 +110,18 @@ Quick installation guide for use with TFSoftware
for example issue the commands in the ''source-code directory'' the
installation apparently will procede, but will be incomplete at the
end.
11. Call `make` to compile Fortran library.
11. Run `make` to compile Fortran library.
12. Edit `~/repo/pgplot/pgplot5.2.2/makehtml` to use correct path to perl
binary.
13. Call `make pgplot.html` compile HTML documentation.
14. Call `make cpg` to prepare C bindings.
15. Call `make clean` to remove binary object files.
13. Run `make pgplot.html` compile HTML documentation.
14. Run `make cpg` to prepare C bindings.
15. Run `make clean` to remove binary object files.
16. Install library files in place
/bin/cp -vpd lib* $LOCLIBDIR
......@@ -123,13 +131,14 @@ Quick installation guide for use with TFSoftware
export PGPLOT_DIR=$HOME/repo/pgplot/linuxgfortran
such that {{{PGPLOT_DIR}}} points to your ''installation directory''.
See also README.compile for comments on `~/.TFbashrc`.
such that PGPLOT_DIR points to your ''installation directory''.
See also README.compile for comments on `~/.SeitoshBashrc`.
* You may use any other path alterantively to `~/repo/pgplot/pgplot5.2.2`
for ''source-code directory'' and `~/repo/pgplot/linuxgfortran` for the
''installation directory'', respectively. Just adjust all path names in
the above commands consistently.
* For more details see `install-unix.txt` and other files in the
''source-code directory''.
......@@ -138,7 +147,7 @@ Environment variables
At least two environment variables (PGPLOT_DIR and TF_LINK_PGPLOT)
must be set appropriately to use PGPLOT together with source code from the
TFSoftware repository. See also README.compile. A template bashrc is provided
in TFbashrc.
in contrib/SeitoshBashrc.
PGPLOT_DIR
This variable contains the path of the PGPLOT ''installation directory''.
......@@ -217,13 +226,13 @@ PGPLOT_IDENT
PGPLOT_PS_BBOX
Normally, PGPLOT computes the bounding box for the entire plot (the smallest
rectangle that includes all the graphics) as it creates the PostScript
file, and writes this information in a %%!BoundingBox comment in the file
file, and writes this information in a %%BoundingBox comment in the file
trailer. Some programs that read encapsulated PostScript files expect to
find the %%!BoundingBox comment in the file header, not the trailer, and may
find the %%BoundingBox comment in the file header, not the trailer, and may
not display the plot correctly. To fix this problem, you may need to move
the comment from the trailer to the header with a text editor or special
program. Alternatively, you can define PGPLOT_PS_BBOX = MAX. This tells
PGPLOT to put a %%!BoundingBox comment in the header of the PostScript
PGPLOT to put a %%BoundingBox comment in the header of the PostScript
file; the bounding box is one which encompasses the whole plottable area,
not a minimal one, because PGPLOT does not know the correct bounding box
until it has finished writing the file.
......
This diff is collapsed.
......@@ -4,7 +4,7 @@ library dependencies
============================================================================
This file tells you on which libraries/modules the different software
packages in Seitosh depend on. There are a lot of internal dependencies
packages in Seitosh depend. There are a lot of internal dependencies
(libraries in Seitosh depend on other libraries in Seitosh) as well as
external dependencies (libraries in Seitosh depend on non-standard external
libraries).
......@@ -13,12 +13,12 @@ External libraries
------------------
External non-standard libraries on which parts of Seitosh depend are:
PGPLOT
boost
gsl
lapack
fftw3
f2c
- PGPLOT
- boost
- gsl
- lapack
- fftw3
- f2c
Make sure that you have the external libraries together with the
header files available.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment