From 5a9e8d156efffc56207e10dceb3989593b2b6c2b Mon Sep 17 00:00:00 2001
From: "Janet B. Anderson" <jba@aps.anl.gov>
Date: Tue, 19 Dec 2006 17:02:01 +0000
Subject: [PATCH] Initial version from Kazuro Furukawa.

---
 documentation/README.tru64unix | 77 ++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 documentation/README.tru64unix

diff --git a/documentation/README.tru64unix b/documentation/README.tru64unix
new file mode 100644
index 000000000..889f08fa1
--- /dev/null
+++ b/documentation/README.tru64unix
@@ -0,0 +1,77 @@
+Compiling EPICS and Building IOC Applications on Tru64Unix/Alpha
+  (former Digital-Unix, and even former OSF1)
+  for architectures "osf-alpha" and "osf-alpha-gnu"
+
+======================================================================
+
+Tools needed
+------------
+
+For C/C++ Compiler, you need one of these compiler set.
+
+  - DEC/Compaq/HP's ANSI C/C++ compilers for "osf-alpha"
+    I used 
+      cc -V
+      Compaq C V6.5-303 (dtk) on Compaq Tru64 UNIX V5.1B (Rev. 2650)
+      Compiler Driver V6.5-302 (dtk) cc Driver
+      cxx -V
+      Compaq C++ V6.5-042 for Compaq Tru64 UNIX V5.1B (Rev. 2650)
+      Compiler Driver V6.5-042 (cxx) cxx Driver
+
+  - GNU gcc/g++ compiler for "osf-alpha-gnu"
+    I used
+      gcc --version
+      gcc (GCC) 3.4.3
+
+Environment
+-----------
+
+Before compiling, please set the environment variable EPICS_HOST_ARCH
+dependent on your compiler.  
+
+ for cc/cxx
+  setenv EPICS_HOST_ARCH osf-alpha
+  (setenv EPICS_HOST_ARCH `startup/EpicsHostArch.pl`)
+  export EPICS_HOST_ARCH=osf-alpha
+
+ for gcc/g++
+  setenv EPICS_HOST_ARCH osf-alpha-gnu
+  export EPICS_HOST_ARCH=osf-alpha-gnu
+
+Building
+--------
+
+Should be quite straightforward. Edit (if necessary) the CONFIG_SITE 
+files and "make".  (Be sure that GNU make is in your path or call it 
+explicitly as the standard make on Tru64Unix is _not_ GNU.)
+
+For example (with csh):
+  setenv EPICS_HOST_ARCH `startup/EpicsHostArch.pl` 
+  make |& tee ../make-base-osf.log
+  make runtests | & tee ../test-base-osf.log
+  setenv EPICS_HOST_ARCH `startup/EpicsHostArch.pl gnu`
+  make |& tee ../make-base-osfgnu.log
+
+Minor errors are detected in epicsSnprintf and timer.  They should 
+be investigated later. 
+
+Some internals
+-----------------------
+
+__alpha is used to distinguish this architecture from others. 
+__DECCXX is used to distinguish DEC/Compaq/HP C++ compiler from GNU's.
+There are several ways to specify compiler options for pthread. 
+  Please consult the pthread(3) manual page.  
+src/libCom/osi/os/osf is used for osi definitions, 
+  src/libCom/osi/os/alpha is not used. 
+About 230 warning messages with cc/cxx, and 6 with gcc.  Sometimes
+  errors from cxx are intuitive. 
+I just started to use IOC application for a gateway purpose. There 
+  can be architecture-dependent problems, that I didn't find yet. 
+
+Only several lines in configure and src files were modified from 
+  base-3.14.4/5/6/7/8/8.2/9pre.  Thanks the core team for keeping 
+  the alpha-osf dependent part in the distribution. 
+
+<URL:http://www-linac.kek.jp/jk/osf/>
+Kazuro Furukawa <kazuro.furukawa at kek.jp>