-*- mode: text -*-
**********************************************************************
*  Filename:  README
*  Datum:     Donnerstag, 11. September 1997, 23:11:31
*  Autor:     Hartmut Keller
*
*  Beschreibung:
*  -------------
*  Info ueber das Vorgehen zum Compilieren einzelner Parallaxis-III
*  Versionen.
**********************************************************************

In diesem Verzeichnis liegen die Executables von Parallaxis-III fuer
die Verschiedenen Architekturen, so wie sie auf den FTP-Server kommen.
Hier koennen sie auch mit dem Makefile "p3versions" neu erzeugt werden
(siehe dort).

Die Quellfiles werden in einem Referenz-Verzeichnis aus dem
CVS-Repository fuer Parallaxis ausgechecked und durch das
Compilerbautoolkit Cocktail geschickt. Anschliessend wird fuer die
jeweilige Architektur in eigenen Unterverzeichnissen uebersetzt.

Damit die Quellfiles nicht mehrfach vorhanden sein muessen, werden sie
nur im Referenz-Verzeichnis konkret abgelegt. In den anderen
Verzeichnissen zeigen dann nur noch Links auf diese Quellfiles. D.h.
es werden nur die Object-Files und die sonstigen fuer jeden Rechner
spezifischen Files jeweils neu erzeugt. Nachdem die p3*.tar.gz-Files
erzeugt wurden, koennen diese spezifischen Files bei Platzmangel mit
make Clean (grosses C, Rest klein) in den einzelnen Verzeichnissen
wieder geloescht werden. Es gibt entsprechende Targets in p3versions:

  p3versions clean:	.o-Files in allen Verzeichnissen weg
  p3versions Clean:	auch die erzeugten Executables weg
  p3versions CLEAN:	auch alles weg, was mit Cocktail automatisch
			erzeugt werden kann

Die fuer eine einzelne Architektur noetigen Files sind im File
_ln-s-files_ angegeben. Diese Files muessen also mit
  ln -s ../p3referenz/<namen>
im Verzeichnis der entsprechenden Architektur eingerichtet werden.
Zusaetzlich muss noch ein README-File erzeugt werden.

Das alles geht am besten mit:

  mkdir p3xxx
  cd p3xxx
  foreach i (`cat ../_ln-s-files_`)
  ln -s ../p3referenz/$i .
  end
  cp ../p3referenz/README* README.xxx.beta
  emacs README.xxx.beta


Hier ein paar Infos ueber die einzelnen Verzeichnisse:

Verzeichis	Kommentar
----------------------------------------------------------------------
p3alpha/	DEC-Alpha unter OSF-1
p3hp9000/	HP9000, Serie 700 oder 800 unter HP-UX
p3linux/	Intel-PC, Linux (ELF-Version!)
p3rs6000/	IBM RS 6000 unter AIX
p3sgi/		Silicon Graphics MIPS unter IRIX
p3solaris/	CVS-Checkout-Verzeichnis, SUN Sparc unter Solaris 2.x
p3sunos/	SUN Sparc unter SunOS4.1.x
p3ultrix/	DEC-Station unter Ultrix

p3source/	Damit werden alle Files zusammengefasst, um p3 in der
		C-Version uebersetzen zu koennen, ohne dass ein
		Cocktail Toolkit da ist. (Reuse wird gebraucht)
p3develop/	Damit werden alle Files zusammengefasst, die zur
		Entwicklung von p3 noetig sind (ohne MPL und PVM),
		einschliesslich dem Tree-Browser. Es werden keine
		Files mit abgespeichert, die per Cocktail erzeugt
		werden koennen.
p3onlyPVM/	Falls mal wieder jemand die PVM-Version pur haben
		will. Achtung: es gibt Querverweise zu p3libraries!

p3referenz/	Das ist ein Verzeichnis, in dem die aktuellen Files
		ausgecheckt werden und durch Cocktail geschickt
		werden. Alle anderen Verzeichnisse sollten sich ihre
		Quellfiles von hier per symbolischem Link holen.

p3libraries/	Hier sind alle Files drin, die irgendwann mal noch in
		die libp3.a bzw. in eine libp3X.a (mit X-Anbindung)
		kommen sollen. Es sind momentan alles Links nach
		/usr/local/bv/{include,lib} bzw. 
		~braunl/examples/{graphics,storage}
p3system/	Hilfsverzeichnis, um bei Bedarf die SYSTEM_*.[chm]
		Files in ein eigenes .tar-File packen zu koennen.

