1 fx    1.7                                     -*-mode:indented-text; fill-column:78-*-

  2 ccp4  1.1 

  3 fx    1.11 This is a partial list of known problems with the current CCP4 code.  They

  4 ccp4  1.1  are either problematical to fix or have not been fixed yet for lack of time.
  5            
  6            * Carriage control on the printer stream is inconsistent and there's no
  7              guarantee what the preconnected streams are.  The library should make
  8              guarantees about the preconnexion of streams 5 and 6 and whether or not
  9              carraigecontrol is honoured on stream 6, but it's not clear that this is
 10              possible. 
 11            
 12            * Portability: various code uses somewhat non-portable features like

 13 fx    1.3    INTEGER*2, long names (even as library externals :-().  Doubtless there's
 14              more which hasn't come to light yet.

 15 ccp4  1.1  

 16 fx    1.11 * PLTDEV: scaling reportedly wrong HP output and reported to throw blank pages
 17              and hang HPGL plotter.

 18 ccp4  1.1  
 19            * PLUTO has many potential problems, including bad control flow (into loops)

 20 fx    1.2    in routine circo -- NPO is the replacement

 21 ccp4  1.1  

 22 fx    1.16 * The manual *still* needs more work.  See ccp4/manual/README about possible
 23              problems with the PostScript etc.

 24 ccp4  1.1  

 25 fx    1.5  * Documentation for the libraries is still inadequate in some cases -- consult
 26              the library source or a program doing something similar if necessary.
 27            

 28 fx    1.6  * Some man pages assume fixed-pitch fonts and don't format properly with

 29 fx    1.2    troff.

 30 fx    1.3  

 31 fx    1.16 * `man' works differently on different systems.  It may tell you to need
 32              "Doumentor's Workbench" on SGI systems, for instance.  See comments in
 33              $CINCL/ccp4.setup-dist regarding MANPATH etc. or avoid man and just read the
 34              .doc files in an editor.
 35            

 36 fx    1.7  * AMORE may need to use enormous amounts of memory and probably won't work for
 37              large cases on many systems (including most VAXen?).  It also contains
 38              illegal Fortran and thus probably needs to be run with optimisation turned
 39              off (apart from peephole-type things, probably).

 40 fx    1.3  
 41            * Some of the programs may use too much memory to link on small VMS systems --

 42 fx    1.7    no workaround known without changing their dimensions.

 43 fx    1.6  

 44 fx    1.7  * Configure may fail without error messages if the shell runs out of space
 45              wherever it puts temporary files (e.g. /tmp).  It will also not stop if
 46              components fail to avoid lossage in the broken shell on one system that
 47              should remain nameless -- check for error messages as it runs.
 48            
 49            * Some of the example unix sh scripts may not run on system with an old
 50              /bin/sh e.g. Ultrix.  You could install the GNU shell, `bash', and change

 51 fx    1.9    /bin/sh in the scripts to the bash pathname.  I've also seen hints that
 52              there's a /bin/sh5 which should do.

 53 fx    1.7  
 54            * SCALA uses lots of memory.  You can reduce MAXPMR and MAXPAR in
 55              src/scala/parameter.h to save space, especially if running in rotavata mode.
 56            

 57 fx    1.8  * RSPS is reported to crash IRIX f77 3.5.1 (even without optimisation), but I
 58              can't reproduce this, so suspect it depends on available VM or somesuch.
 59              Presumably the remedy is to complain to SGI (but please report a workaround
 60              if you find one).

 61 fx    1.9  

 62 fx    1.10 * VAX C: apparently stdlib.h is missing in some (older?) installations of VAX
 63              C.  The code should work without the #include if you comment it out.

 64 fx    1.11 
 65            * XLOGGRAPH isn't available for VMS.  The Athena widgets it uses don't appear
 66              to be distributed with DECwindows and there may be other problems.  If
 67              anyone with VMS Xaw can make it work, please send the recipe.
 68            

 69 fx    1.13 * ccp4.setup-bash doesn't set aliases up if using ksh rather than bash

 70 fx    1.11 

 71 fx    1.12 * There have been several complaints about messages on SGIs such as:
 72                internal error writing to /tmp/ctmca0076S: Error 0
 73              Clear out your /tmp or read about TMPDIR in man f77

 74 fx    1.13 
 75            * Messages on Irix systems like:
 76                Object file format error in: /usr/local/ccp4/lib/libccp4.a(CCPONL.o): 
 77                cannot mix Elf and COFF objects.
 78              arise from trying to mix Irix4 and Irix5 objects.  Re-compile everything
 79              under Irix5.
 80            

 81 fx    1.16 * compar is known to have runtime-undefined variables which haven't been
 82              tracked down yet.  (Won't cause trouble on most systems with default
 83              compilation options.)

 84 fx    1.14 
 85            * Bugs in VMS DEC Fortran have broken MTZ handling at least with version

 86 fx    1.15   v6.1-68 with optimsiation on; v6.2 is OK, as is 6.1 with /NOOPT.

 87 fx    1.16 
 88            * The lib/src/pack_c.c compiled with the --with-mosflm configuration option
 89              requires ANSI C, i.e. won't work in vanilla SunOS4, at least.  Could be
 90              fixed if anyone needs it.
 91            
 92            * There are unresolved problems compiling under Irix6, which we don't have.
 93              There are reports that binaries from Irix5 mis-behave under Irix6.  These
 94              don't appear to be our fault and if you want them resolving you'll have to
 95              help us, probably by exercising your SGI support contract.

 96 fx    1.17 
 97            * The `proclean' component of Procheck doesn't compile on (some?) ESV systems,

 98 fx    1.18   apparently due to a compiler bug.  The `f2c' compiler reportedly works if
 99              you can't get a fix for the MIPS compiler.  Beware also that there is a
100              system `tplot' command which could clash with one of the prochek components.