File: INSTALL.html

package info (click to toggle)
rasmol 2.7.6.0-4
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 17,760 kB
  • sloc: ansic: 78,466; xml: 4,254; sh: 1,538; perl: 816; makefile: 373; csh: 216; yacc: 215
file content (626 lines) | stat: -rwxr-xr-x 25,503 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
<!doctype html public "-//IETF//DTD HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>
RasMol V2.7.5 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="README.html"><IMG SRC="html_graphics/rasmolbutton.jpg"
ALT="[RasMol]"></A>
<hr>
<CENTER>
| <a href="http://www.OpenrasMol.org">OpenRasMol</a> |
<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="doc/rasmol.html">RasMol Manual</A> |
<a href="doc/esrasmol27.html">Spanish Translation of RasMol Manual</a> | 
<a href="doc/itrasmol.hlp">Italian Translation of RasMol Help File</a> |<BR>
| <a href=http://www.rasmol.org/donate.shtml>Donate to Support RasMol</a> |
<a href="README.html">Release README</A> |
<a href=http://www.rasmol.org/register.shtml>Register your RasMol</a> |
</CENTER>

<font color="#0808A0">
<H1 ALIGN=CENTER>Installation Instructions<BR>
RasMol 2.7.5</H1>
<center>
<table celpadding=0>
<tr>
<td valign=top bgcolor="#A0FFFF"><font face="Helvetica,Arial,Times" size=2>
<ul>
<li><a href=http://www.rasmol.org/software/RasMol_Latest_Windows_Installer.exe>RasMol Latest Windows Installer</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/software/RasMol_Latest.tar.gz>RasMol Latest Source Tarball </a><br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/software/RasMol_Latest_Manual.html>RasMol Latest Manual </a><br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/donate.shtml>Donate to Support RasMol </a><br />
<li><a href=http://www.rasmol.org/register.shtml>Register your RasMol</a><br />
</ul>
</font>
<td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<td><IMG  SRC="html_graphics/rasmollogo.jpg" ALT="RasMol">
<td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<td valign=top bgcolor="#FFFFA0"><font face="Helvetica,Arial,Times" size=2>
<ul>
<li><a href=http://www.rasmol.org/software/RasMol_2.7.5_Windows_Installer.exe>RasMol 
2.7.5 Windows Installer</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/software/RasMol_2.7.5.tar.gz>RasMol 2.7.5 Source 
Tarball</a><br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/software/RasMol_2.7.5_Manual.html>RasMol 2.7.5 
Manual</a><br />
&nbsp;<br />
<li><a href=http://www.rasmol.org/donate.shtml>Donate to Support RasMol </a><br />
<li><a href=http://www.rasmol.org/register.shtml>Register your RasMol</a><br />
</ul>
</font>
</table>
</center>
<H3 ALIGN=CENTER>
Molecular Graphics Visualisation Tool<BR>
3 June 2009 (rev. 17 July 2009)<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
<table border=3>
<tr><th align="left">Author<th align="left">Version, Date<th align="left">Copyright
<tr><td>Arne Mueller<td>RasMol 2.6x1 May 1998<td>&#169 Arne Mueller 1998
<tr><td valign="top">Gary Grossman and<br>Marco Molinaro<td>RasMol 2.5-ucb November 1995<br>RasMol 2.6-ucb November 1996
<td valign="top">&#169 UC Regents/ModularCHEM<br>Consortium 1995, 1996
<tr><td>Philippe Valadon<td>RasTop 1.3 August 2000<td>&#169 Philippe Valadon 2000
<tr><td valign="top">Herbert J. Bernstein<td>RasMol 2.7.0 March 1999<br>
RasMol 2.7.1 June 1999<br>RasMol 2.7.1.1 January 2001<BR>
RasMol 2.7.2 August 2000<br>RasMol 2.7.2.1 April 2001<BR>
RasMol 2.7.2 August 2000<br>RasMol 2.7.2.1 April 2001<br>
RasMol 2.7.2.1.1 January 2004<br />
RasMol 2.7.3 February 2005<br />
RasMol 2.7.3.1 Apr 06<br />
RasMol 2.7.4 Nov 07<br />
RasMol 2.7.4.1 Jan 08<br />
RasMol 2.7.4.2 Mar 08<br />
RasMol 2.7.5 June 2009<br />
RasMol 2.7.5.1 July 2009<br />
<td valign="top">&#169 Herbert J. Bernstein 1998-2008
</table>
</CENTER>
<P>
RasMol 2.7.5 incorporates changes by T. Ikonen, G. McQuillan, N. Darakev
and L. Andrews (via the neartree package).  Work on RasMol 2.7.5
supported in part by grant 1R15GM078077-01 from the National Institute
of General Medical Sciences (NIGMS), U.S. National Institutes of Health
and by grant ER63601-1021466-0009501 from the Office of Biological &amp;
Environmental Research (BER), Office of Science, U. S. Department of
Energy.  RasMol 2.7.4 incorporated  changes by G. Todorov, Nan Jia,
N. Darakev, P. Kamburov, G. McQuillan, and J. Jemilawon. Work on RasMol
2.7.4 supported in part by grant 1R15GM078077-01 from the NIGMS/NIH and
grant ER63601-1021466-0009501 from BER/DOE.  RasMol 2.7.3 incorporates
changes by Clarice Chigbo, Ricky Chachra, and Mamoru Yamanishi.  Work
on RasMol 2.7.3 supported in part by grants DBI-0203064, DBI-0315281
and EF-0312612 from the U.S. National Science Foundation and grant
DE-FG02-03ER63601 from BER/DOE. The content is solely the responsibility
of the authors and does not necessarily represent the official views of
the funding organizations.
<P>
The code for use of RasMol under GTK in RasMol 2.7.4.2 was written by
Teemu Ikonen.
<P>
<CENTER>
and Incorporating Translations by
<table border=3>
<tr><th align="left">Author<th align="left">Item<th align="left">Language
<tr><td>Isabel Serv&aacute;n Mart&iacute;nez,<br>
Jos&eacute; Miguel Fern&aacute;ndez Fern&aacute;ndez
<td valign="top">2.6 Manual<td valign="top">Spanish
<tr><td>Jos&eacute; Miguel Fern&aacute;ndez Fern&aacute;ndez<td>2.7.1 Manual<td>Spanish
<tr><td>Fernando Gabriel Ranea<td>2.7.1 menus and messages<td>Spanish
<tr><td>Jean-Pierre Demailly<td>2.7.1 menus and messages<td>French
<tr><td>Giuseppe Martini, Giovanni Paolella,<br>A. Davassi, M. Masullo, C. Liotto
<td valign="top">2.7.1 menus and messages<br>
2.7.1 help file<td valign="top">Italian
<tr><td>G. Pozhvanov<td valign="top">2.7.3 menus and messages<td>Russian
<tr><td>G. Todorov<td valign="top">2.7.3 menus and messages<td>Bulgarian
<tr><td>Nan Jia, G. Todorov<td valign="top">2.7.3 menus and messages<td>Chinese
<tr><td>Mamoru Yamanishi, Katajima Hajime<td valign="top">2.7.3 menus and messages<td>Japanese
<tr>
</table>
</CENTER>
<P>
<CENTER>
This Release by
<BR>Herbert J. Bernstein,
Bernstein + Sons, 5 Brewster Lane, Bellport, NY, USA<BR>
<script language="javascript" type="text/javascript">
<!--
      var name = "yaya@";
      var domain = "bernstein-plus-sons";
      var domext = ".com";
      document.write ("<a href=\"mailto:" + name + domain + domext + "\">" + name + domain + domext+"</a>");
// -->
</script>
<noscript>
yaya&#64;bernstein-plus-sons&#46;com
</noscript>
<BR>
Copyright &#169; Herbert J. Bernstein 1998-2009<BR>
</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. Changes were made in
August 2000 for RasMol version 2.7.2, January 2001 for RasMol
version 2.7.1.1 and April 2001 for RasMol version 2.7.2.1 and
February 2005 for RasMol version 2.7.3.
<p>
<CENTER>Documentation Last Updated 19 July 2009<BR>
Edited by Herbert J. Bernstein and Frances C. Bernstein
</CENTER>
<p>
<H4 Align="CENTER">Translations</H4>
<P>Thanks to the efforts of Jos&eacute; Miguel Fern&aacute;ndez
Fern&aacute;ndez (Departamento 
de Bioqu&iacute;mica y Biolog&iacute;a Molecular. Universidad de Granada.
Espa&ntilde;a (<A HREF="mailto:jmfernan@ugr.es">jmfernan@ugr.es</A>)) a 
<a href="doc/esrasmol27.html">translation of the
Manual for Rasmol version 2.7.1 into Spanish</a> is now available.
La traducci&oacute;n espa&ntilde;ola del manual de la
versi&oacute;n de la Dra. Wong revisada por Eric Martz fue realizada por
Isabel Serv&aacute;n Mart&iacute;nez y Jos&eacute; Miguel Fern&aacute;ndez
Fern&aacute;ndez.  La actual traducci&oacute;n del Manual de RasMol 2.7.1
ha sido realizada usando como base la anterior de RasMol 2.6 por
&nbsp;Jos&eacute; Miguel Fern&aacute;ndez Fern&aacute;ndez.
<P>
Thanks to translations by Fernando Gabriel Ranea <davinci@dinamica.com.ar> in late 2000
and early 2001, RasMol is now
capable of rendering most menu items and messages in Spanish.  
Jean-Pierre Demailly <Jean-Pierre.Demailly@ujf-grenoble.fr> provided French
translations of menus and messages in January 2001.  
Giuseppe Martini <martini@iigb.na.cnr.it> and Giovanni Paolella <paolella@dbbm.unina.it>
with contributions by A. Davassi, M. Masullo and C. Liotto provided Italian
translation of menus and messages in March 2001.
</P>
<HR>
<H4 ALIGN=CENTER>
THIS IS A PRELIMINARY RELEASE INVOLVING EXTENSIVE MODIFICATIONS<BR>
*****  USE WITH CAUTION  ******<BR>
</H4>
<HR>
<H2 ALIGN=CENTER><a name=Copying></a>IMPORTANT - Copying and Distribution</H2>
<P>
This version is based directly on RasMol version 2.7.4.2,
on RasMol version 2.7.4.1,
on RasMol version 2.7.4,
on RasMol version 2.7.3.1,
on RasMol vesion 2.7.3, on RasMol version 2.7.2.1.1,
on RasMol version 2.7.2, on RasMol version 2.7.1, on RasMol
version 2.6_CIF.2, on RasMol version 2.6x1, on RasMol version
2.6.4, and RasMol 2.5-ucb and 2.6-ucb.
<P>
Please read the file <A HREF = "doc/NOTICE.html">NOTICE</A> for
important notices which apply to this package and for
license terms (<a href=GPL>GPL</a> or <A href=RASLIC>RASLIC</a>).
<HR>
<a name="CodeAndBinaries"></a>
<H3>Obtaining RasMol v2.7.5</H3>
<P>
  In order to install RasMol, you may start with a compiled binary or work from
 the source code.
<P>
 The complete source code
and user documentation of RasMol 2.7.5 may be obtained 
from <a href=http://blondie.dowling.edu/projects/rasmol>http://blondie.dowling.edu/projects/rasmol</a>
and
<a href=http://www.sourceforge.net/projects/openrasmol>http://blondie.dowling.edu/projects/rasmol</a>.
and
by
anonymous FTP at:
<P>
    <A 
href="ftp://ftp.bernstein-plus-sons.com/software/RasMol_2.7.5.tar.gz">ftp://ftp.bernstein-plus-sons.com/software/RasMol_2.7.5.tar.gz</A>
<P>
or on the web at:
<P>
    <A 
href="http://www.bernstein-plus-sons.com/software/RasMol_2.7.5.tar.gz">http://www.bernstein-plus-sons.com/software/RasMol_2.7.5.tar.gz</A>
<P>	
As compiled version become available, they will be posted at <a href=http://blondie.dowling.edu/projects/rasmol>http://blondie.dowling.edu/projects/rasmol</a>
and
<a href=http://www.sourceforge.net/projects/openrasmol>http://blondie.dowling.edu/projects/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>
If you wish to start from source code, you will need a RasMol source kit, and
you may need one or more external packages that are not part of RasMol, but which
are used by RasMol.
<p>
To build/rebuild RasMol 2.7.5 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>
<center>
<b>*** IMPORTANT CHANGE IN INSTALLATION INSTRUCTIONS FOR RELEASE 2.7.5 ***</b>
</center>
<p>
You will either need to have the following packages installed in your system, or
to ensure that the indicated defines are at the start Imakefile:
<P>
</P>
<ul>
<li><a href=http://downloads.sf.net/neartree/NearTree-2.1.3.tar.gz>
http://downloads.sf.net/neartree/NearTree-2.1.3.tar.gz</a> or <br />
#define NEARTREE_LOCAL
<P>
<li><a href=http://downloads.sf.net/cqrlib/CQRlib-1.0.3.tar.gz>
http://downloads.sf.net/cqrlib/CQRlib-1.0.3.tar.gz</a> or <br />
#define CQRLIB_LOCAL
<p>

<a href=http://http://downloads.sf.net/cvector/CVector-1.0.3.tar.gz>
http://http://downloads.sf.net/cvector/CVector-1.0.3.tar.gz</a> or <br />
#define CVECTOR_LOCAL
<p>

<li><a 
href=http://download.savannah.gnu.org/releases-noredirect/xforms/xforms-1.0.91.tar.gz>
http://download.savannah.gnu.org/releases-noredirect/xforms/xforms-1.0.91.tar.gz</a> 
or <br />
#define XFORMSLIB_LOCAL
<p>

<li><a href=http://downloads.sf.net/cbflib/CBFlib-0.8.1.tar.gz>
http://downloads.sf.net/cbflib/CBFlib-0.8.1.tar.gz</a> or <br />
#define CBFLIB_LOCAL
<p>
</ul>
<p>

In addition, depending on what has already been installed on your system,
you may need one or more of certain font kits.  These packages are 
not part
of RasMol and normally whould be obtained from their primary web sites, but,
for convenience in installing RasMol, they have been gathered in the
external_packages module in the CVS and as the External_Packages release on 
<a href=http://blondie.dowling.edu/projects/rasmol>http://blondie.dowling.edu/projects/rasmol</a>
and
<a 
href=http://www.sourceforge.net/projects/openrasmol>http://www.sourceforge.net/projects/openrasmol</a>.
<p>

These font kits  are snapshots of the versions in use at the time
of the build of RasMol 2.7.5.  The primary developer web
site for each package should be consulted for the latest
versions.  Because these kits may not be the same as later,
standard versions that are used by the system, as a whole,
scripts in RasMol that use thses kits (especially font kits)
assume that each kit has been unpacked to a directory _within_
the RasMol build directory, at the same level as the src
directory.  <p>
For RasMol release 2.7.5 the package snapshots other than the font kits have been 
replaced by the table
of downloads listed above.

<p>
For building for MS Windows, do not try to use Visual Studio.  Use MINGW instead.


<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.5</H3>
<P>

<H4>UNIX X11:</H4>

<p>
If you are using a precompiled binary, see the instructions that are provided
with the binary kit.  In general, the binary kits for unix provided directly
by this project are tarballs of the $HOME/lib/RasMol_2_7_5 created by
running the script in src/rasmol_install.sh.  The MS windows kit is
a NSIS installer to be double-clicked after downloading.
<OL>
<LI> Fonts:  Followling the instructions for your system, install whatever
X11 font packages you need to the language variants of RasMol you intend to
use.  Almost all Unix variants come with the appropriate fonts for English,
French, Spanish and Italian.  There is an appropriate cyrillic font package,
cyr-rfx-windows-1251-1.1, in external_packages.  The Chinese and Japanese
fonts in intlfonts-1.2.1.tar.gz in external_pakages seem to be satisfactory.

<LI> In the RasMol src directory, either 
  <ul>
  <li><P>
<b>Note for 64 bit CPUs:</b>  If you are building RasMol for a 64-bit CPU
with a compiler that has a 64-bit long data type, you must either use
the build_all.sh script, or manually<P>
#define _LONGLONG
<p>
in rasmol.h

<LI>Modify the #defines in the file rasmol.h (see below)
        Note: IBMPC should not be defined.
  <li> either
      <ul>
      <li> Use the script rasmol_build_options.sh to build a new Imakefile
from Imakefile_base.  The valid options are:<br />
    {--help|-h}<br />
    {--cbflib_local}<br />
    {--cqrlib_local}<br />
    {--cvector_local}<br />
    {--neartree_local}<br />
    {--xformslib_local}<br />
    {--use_xformslib}<br />
    {--use_gtk}<br />
    {--pixeldepth=32}<br />
    {--pixeldepth=16}<br />
    {--pixeldepth=8}<br />
    {--macosx_fink}<br />
<P>
    or
    <li> Edit Imakefile to change the desired options by hand.  Use of 
rasmol_build_options.sh is in general perferred
      </ul>
  <li>either
  <ul>
  <li> execute <br />
    &nbsp;&npsp;xmkmf<br>
    and
  <li> execute <br />
    &nbsp;&npsp;make rasmol
  </ul>
  
 or
   <ul>
   <li>edit the script build_all.sh
   <li>execute build_all.sh
   </ul>
  to build as many variants of rasmol as possible.
<LI>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.
<LI>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.

</OL>
<P>
<H4>MS Windows:</H4>
<P>
If you are using a precompiled binary, follow the instructions that come
with the binary, but in general, you either need to place raswin.exe,
rasmol.hlp and raswin.hlp into the directory from which you will run,
or you need to execute the installer program by double clicking it.
<P>
If you are building from source, you will need MINGW, not visual studio.
CodeWarrior version 9 can also be used.
</OL>
<P>
<H4>Macintosh under OSX:</H4>
<P>
Follow the instructions for unix and run under the X11 system.  A pre-edited
version of the build_all.sh script called build_MACOSX.sh is provided.
<P>

<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&amp;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.
                
<TR><TD VALIGN=TOP>XPROCARCH        <TD>Defining XPROCARCH enables code 
                for raswin that gets detailed information about the operating system
                and processor
                
<TR><TD VALIGN=TOP>USE_UNAME        <TD>Defining USE_UNAME enables code 
                for rasmol under X11 that gets detailed information about the operating system
                and processor.
                

<TR><TD VALIGN=TOP>USE_CBFLIB        <TD>Defining USE_CBFLIB enables code t
                that depends on CBFLIB for map reading and writing.

</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
         #define USE_UNAME
         #define USE_CBFLIB

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

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

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

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

</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="http://www.OpenrasMol.org">OpenRasMol</a> |
<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="doc/rasmol.html">RasMol Manual</A> |
<a href="doc/esrasmol27.html">Spanish Translation of RasMol Manual</a> | 
<a href="doc/itrasmol.hlp">Italian Translation of RasMol Help File</a> |<BR>
| <a href=http://www.rasmol.org/donate.shtml>Donate to Support RasMol</a> |
<a href="README.html">Release README</A> |
<a href=http://www.rasmol.org/register.shtml>Register your RasMol</a> |
</CENTER>

<HR>
Updated 19 July 2009.<BR>
Herbert J. Bernstein<BR>
Bernstein + Sons, 5 Brewster Lane, Bellport, NY 11713-2803, USA<BR>
<script language="javascript" type="text/javascript">
<!--
      var name = "yaya@";
      var domain = "bernstein-plus-sons";
      var domext = ".com";
      document.write ("<a href=\"mailto:" + name + domain + domext + "\">" + name + domain + domext+"</a>");
// -->
</script>
<noscript>
yaya&#64;bernstein-plus-sons&#46;com
</noscript>
</BODY>
</HTML>