head	1.1;
access;
symbols;
locks
	yaya:1.1; strict;
comment	@# @;


1.1
date	99.07.15.11.49.26;	author yaya;	state Exp;
branches;
next	;


desc
@@


1.1
log
@Initial revision
@
text
@<!doctype html public "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>
RasMol V2.7.1 INSTALL
</TITLE>
</HEAD>
<BODY BACKGROUND="../html_graphics/rasmolwallpaper.jpg">

<a href="http://www.iucr.org/iucr-top/welcome.html">
<img alt="[IUCr Home Page]" src="../html_graphics/iucrhome.jpg"></a>
<a href="http://www.iucr.org/iucr-top/cif/home.html">
<img alt="[CIF Home Page]" src="../html_graphics/cifhome.jpg"></a>
<A HREF=rasmol.html"><IMG SRC="../html_graphics/rasmolbutton.jpg"
ALT="[RasMol]"></A>
<hr>
<CENTER>
| <A href="../README.html#Copying">Copying and Distribution</A> |
<A href="../README.html#Contents">Contents</A> |
<A href="../INSTALL.html">Installation Instructions</A> |<BR>
| <A href="../ChangeLog.html">Changes</A> |
<A href="../TODO.html">Things To Do</A> |
<A href="../README.html#Introduction">Introduction</A> | 
<A href="../README.html#CodeAndBinaries">Source Code and Binaries</A> |<BR>
| <A href="rasmol.html">RasMol Manual</A> |
<a href="../README.html">Release README</A> |<BR>
</CENTER>

<font color="#0808A0">
<H1 ALIGN=CENTER>Installation Instructions<BR>
RasMol 2.7.1</H1>
<H3 ALIGN=CENTER>
<IMG  SRC="../html_graphics/rasmollogo.jpg" ALT="RasMol"><BR>
Molecular Graphics Visualisation Tool<BR>
22 June 1999<BR>
</H3>
</font><font color="#000000">
<CENTER>
Based on RasMol 2.6 by
Roger Sayle<BR>
Biomolecular Structures Group, Glaxo Wellcome Research & Development<BR>
Stevenage, Hertfordshire, UK<BR>
Version 2.6, August 1995, Version 2.6.4, December 1998<BR>
Copyright &#169; Roger Sayle 1992-1999<BR>
</CENTER>
<P>
<CENTER>
and Based on Mods by Arne Mueller<BR>
Version 2.6x1, May 1998<BR>
Copyright &#169; Arne Mueller 1998<BR>
</CENTER>
<P>
<CENTER>
Version 2.7.0, 2.7.1 Mods
by
Herbert J. Bernstein<BR>
Bernstein + Sons,
P.O. Box 177, Bellport, NY, USA,
<A HREF="mailto:yaya@@bernstein-plus-sons.com">yaya@@bernstein-plus-sons.com</A><BR>
2.7.0 March 1999, 2.7.1 June 1999<BR>
Copyright &#169; Herbert J. Bernstein 1998-1999
</CENTER>
<P>
 The original RasMol manual was created by Roger Sayle.  In July 1996,
 Dr. Margaret Wong of the Chemistry Department, Swinburne University
 of Technology, Australia, made extensive revisions to the RasMol 2.5
 manual to accurately reflect the operation of RasMol 2.6.  Eric Martz
 of the University of Massachusetts made further revisions.  In May
 1997, William McClure of Carnegie Mellon University reorganized the
 HTML version of the manual into multiple sections which could be
 downloaded quickly and added use of frames.   Portions of the 2.7.1
 version of the RasMol manual were derived with  permission from
 William McClure's version using Roger Sayle's rasmol.doc for
 version 2.6.4 as the primary source.
<p>
<CENTER>Documentation Last Updated 5 July 1999<BR>
Edited by Herbert J. Bernstein and Frances C. Bernstein</CENTER>
<p>
<HR>

<H4 ALIGN=CENTER>
THIS IS A PRELIMINARY RELEASE INVOLVING EXTENSIVE MODIFICATIONS<BR>
*****  USE WITH CAUTION  ******<BR>
</H4>
<HR>
<H2 ALIGN=CENTER>IMPORTANT</H2>
<P>
   This version is based on RasMol version 2.6_CIF.2, on RasMol version
2.6x1 and on RasMol version 2.6.4. Please read the file <A HREF = NOTICE.html">NOTICE</A> for
important notices which apply to this package.  If you are not going to
make changes to RasMol, you are not only permitted to freely make copies
and distribute them, you are encouraged to do so, provided you do the
following:
<UL>
<LI>  1.  Either include the complete documentation, especially the file
 <A HREF = NOTICE.html">NOTICE</A>, with what you distribute or
provide a clear indication where people can get a copy of the documentation; and
<LI>  2.  Please give credit where credit is due citing the version and
original authors properly; and
<LI>  3.  Please do not give anyone the impression that the original authors
are providing a warranty of any kind.
</UL>
<P>
If you would like to use major pieces of RasMol in some other program, make
modifications to RasMol, or in some other way make what a lawyer would call
a "derived work", you are not only permitted to do so, you are encouraged
to do so.   In addition to the things we discussed above, please do the
following:
<UL>
<LI>  4.  Please explain in your documentation how what you did differs from
this version of RasMol; and
<LI>  5.  Please make your modified source code available.
</UL>
<P>
This version of RasMol is <b>not</b> in the public domain, but it is given
freely to the community in the hopes of advancing science.  If you make
changes, please make them in a responsible manner, and please offer
us the opportunity to include those changes in future versions of RasMol.
<HR>
<P>
                        
    This file explains how to transfer, compile and install RasMol v2.7.1
on your system. This version of the RasMol Molecular graphics package will 
run on UNIX, VMS, Macintosh and Microsoft Windows. 
<P>
<hr>
<H3>Obtaining RasMol v2.7.1</H3>
<P>

This version of RasMol may be obtained by anonymous FTP either by
anonymous FTP at:
<P>
    <A
HREF="ftp://ftp.bernstein-plus-sons.com/software/rasmol">ftp://ftp.bernstein-plus-sons.com/software/rasmol</A>
<P>
or on the web at:
<P>
    <A HREF="http://www.bernstein-plus-sons.com/software/rasmol">http://www.bernstein-plus-sons.com/software/rasmol</A>
<P>
To transfer by anonymous ftp, type &quot;ftp 
ftp.bernstein-plus-sons.com&quot; on the command
line. Several seconds later you'll be prompted for a username. Use the
username &quot;anonymous&quot; and when asked for a password enter your e-mail
address. Once logged in, type the command &quot;cd software/rasmol&quot; to change
the directory to /software/rasmol and then type &quot;binary&quot; to avoid corrupting
the files during the transfer. For each file you wish to transfer, type
&quot;get &lt;filename&gt;&quot; and when you've finished type &quot;quit&quot;. If these files 
are subsequently transfered to other machines, please remember to
transfer them in BINARY mode. The file sizes should be identical before
and after the transfer.
<P>
<B>NOTE:</B>   The Mac uses the &quot;carriage return&quot; character to signify the
end of a line, while UNIX machines use a &quot;linefeed&quot;. If a file is
transfered between these two machines in &quot;ASCII&quot; mode all such
characters are exchanged, thereby corrupting the archive. Please
ensure that you type the FTP command &quot;binary&quot; before you transfer the
file, indicating that the file should be transfered without
translation. 
<P>
To build/rebuild RasMol 2.7.1 on any platform, you'll need to transfer 
the following file:
<P>
<TABLE>
<TR><TD VALIGN=TOP><A HREF="../RasMol.tar.gz">RasMol.tar.gz</A><TD>UNIX 'tar'ed 'gzip'ped archive containing the
                        complete source code and documentation of the
                        RasMol molecular graphics package.
</TABLE>
<P>
To unpack the file on a UNIX machine type the command &quot;gunzip
RasMol.tar.gz&quot; and then the command &quot;tar -xvf
RasMol.tar&quot; to extract the files in a subdirectory under the
current directory.
<P>
There are command-line and GUI-interface versions of tar and gzip for
the Macintosh and for Windows, so we have discontinued the former
practice of providing StuffIt or ZIP archives for those platforms.
However, note that MacIntosh-specific files are actually provided in gzipped
MacBinary form with a &quot;.bin.gz&quot; extension.
<P>
If you are in a hurry, the following pre-compiled binary files are available:
<B>WARNING:  <B>ALL</B> binaries and help files are gzipped!!!</B>


   
<P>
<TABLE>

<TR><TH ALIGN=LEFT>System <TH ALIGN=LEFT>Binary <TH ALIGN=LEFT>Help Files<BR>

   
<TR><TH ALIGN=LEFT>SGI (IRIX 5.3):
<TD><A HREF="../RasMol.SGI/IRIX_5.3/rasmol_8BIT.gz">
RasMol.SGI/IRIX_5.3/rasmol_8BIT.gz</A>
<TD><A href="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.SGI/IRIX_5.3/rasmol_16BIT.gz">
RasMol.SGI/IRIX_5.3/rasmol_16BIT.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.SGI/IRIX_5.3/rasmol_32BIT.gz">
RasMol.SGI/IRIX_5.3/rasmol_32BIT.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>SGI (IRIX 6.4):
<TD><A HREF="../RasMol.SGI/IRIX_6.4/rasmol_8BIT.gz">
RasMol.SGI/IRIX_6.4/rasmol_8BIT.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.SGI/IRIX_6.4/rasmol_16BIT.gz">
RasMol.SGI/IRIX_6.4/rasmol_16BIT.gz</A>   
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.SGI/IRIX_6.4/rasmol_32BIT.gz">
RasMol.SGI/IRIX_6.4/rasmol_32BIT.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>Alpha (OpenVMS 7.1):
<TD><A HREF="../RasMol.DEC/OpenVMS_7.1/rasmol_8bit.exe.gz">
RasMol.DEC/OpenVMS_7.1/rasmol_8bit.exe.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.DEC/OpenVMS_7.1/rasmol_16bit.exe.gz">
RasMol.DEC/OpenVMS_7.1/rasmol_16bit.exe.gz</A>   
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.DEC/OpenVMS_7.1/rasmol_32bit.exe.gz">
RasMol.DEC/OpenVMS_7.1/rasmol_32bit.exe.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>VAX (OpenVMS 6.2):
<TD><A HREF="../RasMol.DEC/OpenVMS_6.2/rasmol_8bit.exe.gz">
RasMol.DEC/OpenVMS_6.2/rasmol_8bit.exe.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.DEC/OpenVMS_6.2/rasmol_16bit.exe.gz">
RasMol.DEC/OpenVMS_6.2/rasmol_16bit.exe.gz</A>   
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="../RasMol.DEC/OpenVMS_6.2/rasmol_32bit.exe.gz">
RasMol.DEC/OpenVMS_6.2/rasmol_32bit.exe.gz</A>
<TD><A HREF="rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>
              
<TR><TH ALIGN=LEFT>Mac:  <TD><A HREF="../src/mac/RasMac_FAT.bin.gz">RasMac_FAT.bin.gz</A>  <TD><A href="../src/mac/rasmol.hlp.gz">rasmol.hlp.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD><A HREF="../src/mac/RasMac_PPC.bin.gz">RasMac_PPC.bin.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD><A HREF="../src/mac/RasMac_68K.bin.gz">RasMac_68K.bin.gz</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>
              
<TR><TH ALIGN=LEFT>Windows: <TD><A href="../src/mswin/raswin.exe.gz">RasWin.exe.gz</A> <TD><A href="../src/mswin/rasmol.hlp.gz">rasmol.hlp.gz</A>, <A href="../src/mswin/raswin.hlp.gz">raswin.hlp.gz</A><BR>
</TABLE>

<P>

For those who have difficulty downloading &quot;gzipped&quot; files,
uncompressed files are available:
<TABLE>

<TR><TH ALIGN=LEFT>System <TH ALIGN=LEFT>Binary <TH ALIGN=LEFT>Help Files<BR>

   
<TR><TH ALIGN=LEFT>SGI (IRIX 5.3):
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_5.3/rasmol_8BIT">
RasMol.SGI/IRIX_5.3/rasmol_8BIT</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_5.3/rasmol_16BIT">
RasMol.SGI/IRIX_5.3/rasmol_16BIT</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_5.3/rasmol_32BIT">
RasMol.SGI/IRIX_5.3/rasmol_32BIT</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>SGI (IRIX 6.4):
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_6.4/rasmol_8BIT">
RasMol.SGI/IRIX_6.4/rasmol_8BIT</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_6.4/rasmol_16BIT">
RasMol.SGI/IRIX_6.4/rasmol_16BIT</A>   
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.SGI/IRIX_6.4/rasmol_32BIT">
RasMol.SGI/IRIX_6.4/rasmol_32BIT</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>Alpha (OpenVMS 7.1):
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_7.1/rasmol_8bit.exe">
RasMol.DEC/OpenVMS_7.1/rasmol_8bit.exe</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_7.1/rasmol_16bit.exe">
RasMol.DEC/OpenVMS_7.1/rasmol_16bit.exe</A>   
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_7.1/rasmol_32bit.exe">
RasMol.DEC/OpenVMS_7.1/rasmol_32bit.exe</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>

<TR><TH ALIGN=LEFT>VAX (OpenVMS 6.2):
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_6.2/rasmol_8bit.exe">
RasMol.DEC/OpenVMS_6.2/rasmol_8bit.exe</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_6.2/rasmol_16bit.exe">
RasMol.DEC/OpenVMS_6.2/rasmol_16bit.exe</A>   
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp;
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../RasMol.DEC/OpenVMS_6.2/rasmol_32bit.exe">
RasMol.DEC/OpenVMS_6.2/rasmol_32bit.exe</A>
<TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>
              
<TR><TH ALIGN=LEFT>Mac:  <TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mac/RasMac_FAT.bin">RasMac_FAT.bin</A>  <TD><A href="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mac/rasmol.hlp">rasmol.hlp</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mac/RasMac_PPC.bin">RasMac_PPC.bin</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD><A HREF="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mac/RasMac_68K.bin">RasMac_68K.bin</A><BR>
<TR><TH ALIGN=LEFT>&nbsp; <TD>&nbsp; <TD>&nbsp; <BR>
              
<TR><TH ALIGN=LEFT>Windows: <TD><A href="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mswin/raswin.exe">RasWin.exe</A> <TD><A href="/cgi-bin/yaya/decomp.cgi/software/RasMol_2.7.1/doc/../src/mswin/rasmol.hlp">rasmol.hlp</A>, <A href="../src/mswin/raswin.hlp">raswin.hlp</A><BR>
</TABLE>


<P> 
You will need both an appropriate binary and a copy of rasmol.hlp for each
system, and, under Windows, a copy of raswin.hlp for the WinHelp sub-system.
<P>
On an SGI, rename the appropriate binary as rasmol and copy it to
/usr/local/bin/rasmol (or to some appropriate location specified
by the environment variable PATH) and copy rasmol.hlp to
/usr/local/lib/rasmol/rasmol.hlp (or to the location indicated by the
environment variable RASMOLPATH)
 <P>
 <HR>
 
<H3>Installing RasMol v2.7.1</H3>
<P>

<H4>UNIX X11:</H4>
<P>
<OL>
<LI> In the src subdirectory:
    Type the command &quot;xmkmf&quot; to generate a &quot;Makefile&quot; for your particular 
    system from the distributed Imakefile 

    Alternatively (or if the first method fails), copy the file Makefile.in
    to Makefile, using the command &quot;cp Makefile.in Makefile&quot;, then modify 
    the contents of the Makefile to determine your local C compiler,
    compiler and linker options. The default set up is for an 8bit UNIX
    workstation with the X11 shared memory extension, compiled using the
    GNU C Compiler. Changing the line &quot;CC=gcc&quot; to &quot;CC=cc&quot; will use the
    machines native compiler but will require changing &quot;CFLAGS&quot; for your
    platform.

    A common problem is that SUN OpenWindows keeps its include files in the
    directory /usr/openwin/include/X11, hence the compiler directive 
    -I/usr/openwin/include must be added to CFLAGS.

    A common problem on IBM RS6000s running AIX is that the MIT shared
    memory extensions to X windows are in the library -lXextSam, hence
    this must be added to the LIBS lines in either the Makefile or Imakefile.

<LI> Modify the #defines in the file rasmol.h (see below)
        Note: IBMPC should not be defined.
<LI> Compile the program using the UNIX make utility. (i.e. type &quot;make&quot;)
<LI> Place the 'rasmol' executable on the execution PATH, i.e. /usr/local/bin
<LI> Install rasmol.hlp as /usr/local/lib/rasmol/rasmol.hlp (or at a loctaion
    indicated by the environment variable RASMOLPATH).
<LI> If you have the UNIX utilities &quot;uncompress&quot; or &quot;gunzip&quot; ensure they are
    on the user's default PATH.
<LI> Set the environment variable RASMOLPDBPATH to the directory containing
    the Broohaven PDB database, if one exits.
<LI> Place any system wide initialisation parameters into the file &quot;rasmolrc&quot;
    in the directory pointed to by RASMOLPATH.
<LI> It is possible to set-up RASMOLPATH and RASMOLPDBPATH each time the 
    program is running by renaming rasmol to rasmol.exe, and using a script
    similar to the one in &quot;rasmol.sh&quot; of the standard distribution.
<LI> If appropriate place &quot;rasmol.1&quot; or &quot;rasmol.0&quot; in the appropriate place
     for UNIX man pages, and optionally place &quot;rasmol.html&quot; somewhere in 
     your WWW hierarchy (if available at your site).
</OL>
<P>
<H4>MS Windows:</H4>
<P>
<OL>
<LI> Copy the executable RASWIN.EXE and the help files RASMOL.HLP and RASWIN.HLP
    to an appropriate directory.  You may execute the program immediately by 
    double-clicking the icon of RASWIN.EXE.
<LI> Under Windows/95 and similar systems, create a shortcut icon to RasWin 
    on the Desktop or in a folder.  Select the RasWin icon then simultaneously 
    press ALT-ENTER (or right click on the icon and select &quot;Properties&quot; from 
    the menu).  Select the &quot;Shortcut&quot; tab in the Properties dialog box.
<LI> At the &quot;Start In:&quot; prompt, type in the path of the appropriate working
    directory.
<LI> Under Windows 3.1 and similar systems Install the program in MS Windows 
    using the New option of the Program Manager's File Menu. Set the 
    Description of the Program to &quot;RasWin v2.7.1&quot; and the Current Directory, 
    to the directory containing the files.  Install the RasMol Help file using 
    the New option of the Program, Manager's File Menu. Set the Description to 
    &quot;RasWin Manual&quot;, the command to &quot;C:\WINDOWS\WINHELP RASWIN.HLP&quot; and the 
    working directory to the appropriate directory.
</OL>
<P>
<H4>Macintosh and PowerMac:</H4>
<P>
<OL>
<LI> Place both &quot;RasMac_FAT&quot;  (or &quot;RasMac_PPC&quot; or
&quot;RasMac_68k)&quot; and &quot;rasmol.hlp&quot; in the same Macintosh folder
</OL>
<P>
<H4>VAX/VMS:</H4>
<P>
<OL>
<LI> There is a VMS-ready copy of rasmol.h in the &quot;src/vms&quot; 
     directory.
     Modify the #defines in the file rasmol.h (see below)
        Note: IBMPC, MITSHM and TERMIOS should not be defined.
<LI> Copy all the files from the &quot;src/vms&quot; directory to the 
     source directory.
<LI>  Copy the file "rasmol.hlp" from the "doc" directory to the source
     directory.
<LI> If your VAX site has an MMS license type the command &quot;MMS&quot;,
    otherwise use the DCL build script by typing &quot;@@build.com&quot;
<LI> The program may be run by typing &quot;RUN RASMOL.EXE&quot;, the X Windows
    server is specified by a VMS command of the form:<BR>
	SET&nbsp;DISPLAY/CREATE/TRANSPORT=TCPIP/NODE=&lt;hostname&gt;
<LI> The symbol RASMOL should be defined to be the path of RASMOL.EXE using :==
<LI> The file doc/rasmol.vms contains a ascii VMS help file that can
    be compiled in to the VMS on-line help system.
</OL>
<P>
<HR>
<H3>Recompiling RasMol v2.7.1</H3>
<P>For both Windows and Mac, this version has been built with MetroWerks
CodeWarrior, and the necessary projects are included in the src/mswin and
src/mac directories.  The following more general instructions adapted from the
RasMol v2.6 release are provided for your information, but have _not_ been
tested against RasMol_2.7.1:
<P>
<P>
<H4>MS Windows v3.1:</H4>
<P>
<OL>
<LI> Use Makefile.pc instead of Makefile, by copying it to MAKEFILE.
<LI> Modify the contents of the Makefile to determine your local C compiler,
    compiler and linker options. 
<LI> Modify the #defines in the file rasmol.h (see below)
        Note: EIGHTBIT and IBMPC should all be defined
              APPLEMAC, DIALBOX, MITSHM and TERMIOS should not be defined.
<LI> Compile the program using the Microsoft Optimizing C Compiler Version
    7's (or Microsoft Visual C++'s) NMAKE program under MS-DOS.
</OL>
<P>
<H4>MS Windows</H4>
<P>
<OL>
<LI> Using Microsoft Visual C++, create a new project adding all the
    &quot;*.c&quot; source files except &quot;rasmol.c&quot;, &quot;x11win.c&quot;, &quot;rasmac.c&quot; and
    &quot;applemac.c&quot;. Add the Windows resource source file &quot;raswin.rc&quot;.
    or alternatively use Makefile.nt by copying it to MAKEFILE.
<LI> Follow the instructions from [2] onwards as for MS Windows v3.1.
</OL>
<P>
<H4>Apple Macintosh and PowerMac</H4>
<P>
<OL>
<LI> Create a project in either the Symmantec C/C++, Think C or Metrowerks 
    C compiler environments and add all the C source files (&quot;*.c&quot;) to 
    the project. On 68k development systems all C files should be placed
    in separate segments [however rasmac.c and applemac.c can share a
    segment and abstree.c and command.c can share a segment].
<LI> Add the &quot;rasmac.rsrc&quot; resource file to the project.
<LI> For the Symantec/Think C environment add the &quot;ANSI&quot; or &quot;ANSI-small&quot;
    library from &quot;Standard Libraries&quot; folder and the &quot;MacTraps&quot; library
    from the &quot;Mac Libraries&quot; folder. 
    The choice of &quot;ANSI&quot; or &quot;ANSI-small&quot;
    is dependent upon the size of integer by the compiler. See dialog
    'Edit'-&gt;'Options'-&gt;'Think C..'-&gt;'Compiler Settings'.  2-byte integers 
    require &quot;ANSI-small&quot; and 4-byte integers require &quot;ANSI&quot;.
<LI> A project files has been provided for Metrowerks 68K, PPC and FAT versions.
<LI> If that project file is not satisfactory, for the Metrowerks 68K Compiler 
     add the libraries &quot;MacOS.lib&quot; and
    &quot;ANSI (2i) C.68K.Lib&quot; to the project. [Note: If compiling for 4byte 
    integer size and/or 68881 maths instructions select the approriate 
    ANSI C Library].
<LI> For some Metrowerks 68K compiler releases the &quot;C/C++ Language Settings&quot;
     &quot;Enums Always Int&quot; must be selected for proper execution.
<LI> For the Metrowerks PPC Compiler add the libraries &quot;MWCRuntime.Lib&quot;,
    &quot;InterfaceLib&quot;, &quot;MathLib&quot; and &quot;ANSI C.PPC.Lib&quot;. This should work
    fine for Metrowerks C++ v1.1.  Apparently, Metrowerks C++ v1.2 also
    requires &quot;console.stubs.c&quot;. [Thanks to Graham Palmer]
<LI> In Metrowerk's &quot;Edit&quot; &quot;Preferences&quot; &quot;Project&quot; or Symmantec's &quot;Project&quot;
    &quot;Set Project Type&quot;, set the project type to Application (Type 'APPL'), 
    Creator 'RSML', and the SIZE flags to include &quot;is32bitCompatible&quot;, 
    &quot;isHighLevelEventAware&quot;, &quot;localAndRemoteHLEvents&quot;.
<LI> Modify the #defines in the file &quot;rasmol.h&quot; (see below).
        Note: APPLEMAC should all be defined
              IBMPC, DIALBOX, MITSHM and TERMIOS should not be defined.
<LI> Compile RasMol using the &quot;Build Application...&quot; Menu Item.
<LI> To create a `fat' binary, use Apple's ResEdit to copy and paste the
    CODE, DATA and XREF resources from the Metrowerks 68K executable 
    into the resource fork of the Metrowerks PPC executable.
<LI> The Installed Application's name should be &quot;RasMac v2.7.1&quot;
</OL>
<P>
<HR>

<H3>COMPILATION DIRECTIVES</H3>
<P>The file rasmol.h contains a number of #define directives that control
the runtime behaviour of the program. The following directives may be
defined or undefined to suite the local site.
<P>
<TABLE>
<TR><TD>THIRTYTWOBIT<BR>
SIXTEENBIT<BR>
EIGHTBIT<TD>This determines whether RasMol will display and produce
		8bit, 16bit or 32(24) bit output. By default the symbol 
                EIGHTBIT is defined producing images with up to 256 
                colours. This symbol must be defined if IBMPC is defined.

<TR><TD VALIGN=TOP>DIALBOX		<TD>This enables the use of a dials box, that is connected 
		using the X Window System XInput extension. This option
		requires that the program be compiled with the Xi and
		Xext libraries. Note: libXi is called libXinput on some old
		machines, so requires the compiler option -lXinput!

<TR><TD VALIGN=TOP>MITSHM 		<TD>This option enables the use of the X Window System MIT shared
		memory extension. This enables images to be displayed faster
		when RasMol and the X11 server are running on the same host.
		This option requires the program be compiled with the Xext
		library. On IBM RS6000s runnning AIX, MITSHM also requires
                the XextSam library (which requires changing the Makefile or
                Imakefile). This is now enabled by default. This should be
                disabled on E&S ESV workstations as MITSHM support is not 
                provided as standard.

<TR><TD VALIGN=TOP>TERMIOS		<TD>This directive enables the command line processing on UNIXs
		that support the termios terminal handling routines. By 
		leaving this symbol undefined, RasMol omits the interactive
		command line interface. Undefining is not recommended!

<TR><TD VALIGN=TOP>SOCKETS         <TD>This directive enables the TCP/IP server functionality of
                RasMol to be enable.  This enables other software to connect
                to a running RasMol.  This should be undefined on machines
                not supporting BSD-style TCP/IP sockets (such as VMS).

<TR><TD VALIGN=TOP>APPLEMAC        <TD>This determines whether the program is to run on an Apple
                Macintosh or PowerMac. By default, this option is disabled.
                The Macintosh code may be compiled to be either EIGHTTBIT
                or THIRTYTWOBIT and will generate images effectively.

<TR><TD VALIGN=TOP>IBMPC           <TD>This determines whether the program is intended to run on an IBM PC or compatible. By default, this 
                option is disabled.

<TR><TD VALIGN=TOP>MSWIN           <TD>This determines whether the program is intended to run on an
                IBM PC or compatible under MS Windows. By default, this 
                option is disabled. 

<TR><TD VALIGN=TOP>PROFILE           <TD>Defining PROFILE enables code to
                profile RasMol execution.
</TABLE>
<P>
To summarise;
<P>
<PRE>
    A typical UNIX build:
         /* #define IBMPC        */
         /* #define MSWIN        */
         /* #define APPLEMAC     */
         #define X11WIN
         #define UNIX

         /* #define DIALBOX      */
         #define SOCKETS
         #define TERMIOS
         #define PROFILE
         #define MITSHM

    A typical Windows build:
        #define IBMPC
        #define MSWIN
        /* #define APPLEMAC      */
        /* #define X11WIN        */
        /* #define UNIX          */

        /* #define DIALBOX       */
        /* #define SOCKETS       */
        #define TERMIOS
        #define PROFILE
        #define MITSHM

    A typical Macintosh build:
        /* #define IBMPC         */
        /* #define MSWIN         */
        #define APPLEMAC
        /* #define X11WIN        */
        /* #define UNIX          */

        /* #define DIALBOX       */
        #define SOCKETS
        #define TERMIOS
        #define PROFILE
        #define MITSHM
        
    A typical VMS build:
       /* #define IBMPC          */
       /* #define MSWIN          */
       /* #define APPLEMAC       */
       /* #define X11WIN         */
       /* #define UNIX           */

       /* #define DIALBOX        */
       /* #define SOCKETS        */
       /* #define TERMIOS        */
       /* #define PROFILE        */
       /* #define MITSHM         */
</PRE>
<P>
<P>	
Any comments, suggestions or questions about this
modified version should be directed to Herbert J. Bernstein at
<A HREF="mailto:rasmol@@bernstein-plus-sons.com">rasmol@@bernstein-plus-sons.com</A>.
<P>
<CENTER>
| <A href="../README.html#Copying">Copying and Distribution</A> |
<A href="../README.html#Contents">Contents</A> |
<A href="../INSTALL.html">Installation Instructions</A> |<BR>
| <A href="../ChangeLog.html">Changes</A> |
<A href="../TODO.html">Things To Do</A> |
<A href="../README.html#Introduction">Introduction</A> | 
<A href="../README.html#CodeAndBinaries">Source Code and Binaries</A> |<BR>
| <A href="rasmol.html">RasMol Manual</A> |
<a href="../README.html">Release README</A> |<BR>
</CENTER>

<HR>
Updated 5 July 1999.<BR>
Herbert J. Bernstein<BR>
Bernstein + Sons, 5 Brewster Lane, Bellport, NY 11713-2803, USA<BR>
<A HREF="mailto:yaya@@bernstein-plus-sons.com">
yaya@@bernstein-plus-sons.com</A><BR>
+1-516-286-1339<BR>
</font>
</BODY>
</HTML>
@
