docs/readme_vms.txt

   1 This distribution contains makefiles for VMS. It is a very preliminary release
   2 and many tests have still to be done.
   3
   4 The compilation was tested with
   5     -OpenVMS Alpha 7.2-1
   6     -DECC 6.2
   7     -Compac C++ 6.2
   8     -DECWindows 1.2-5
   9     -GTK1.2.8 (for wxGTK)
  10
  11 To get everything compiled you'll need to have installed prior to compiling
  12 wxWindows:
  13     -Bison
  14       get it from http://www.openvms.digital.com/freeware/
  15       You' have to fix the following bug:
  16         add the following 3 lines in BISON.SIMPLE
  17           #elif __VMS
  18           #include <stdlib.h>
  19           #define alloca malloc
  20         before
  21           #endif /* __hpux */
  22
  23     -Flex
  24       get it from http://www.openvms.digital.com/freeware/
  25
  26     -Sed
  27       get it from http://www.openvms.digital.com/freeware/
  28
  29     -sys$library:libjpeg.olb  (from ftp://ftp.uu.net/graphics/jpeg/ )
  30         add /name=(as_is,short) to CFLAGS in the descrip.mms file
  31         don't forget to mms/descrip=Makefile/macro="ALPHA=1"
  32
  33     -sys$library:libpng.olb & sys$library:libz.olb (from
  34           http://www.cdrom.com/pub/png/pngcode.html )
  35         add /name=(as_is,short) to CFLAGS in the descrip.mms of both png and
  36         zlib
  37
  38     -sys$library:libtiff.olb (from: ftp://ftp.sgi.com/graphics/tiff/ )
  39        - add /name=(as_is,short) to the C_COMPILE variable in MAKVMS.COM
  40        - the following patch is needed in the tiff3.4 distribution:
  41 polka-jj) diff TIFFCOMP.H;3 TIFFCOMP.H;1
  42 ************
  43 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3
  44    97   #ifndef HAVE_UNISTD_H
  45    98   #define HAVE_UNISTD_H   1
  46    99   #endif
  47   100   #endif
  48 ******
  49 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
  50    97   #define HAVE_UNISTD_H   1
  51    98   #endif
  52 ************
  53 ************
  54 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;3
  55   108   #if !defined(SEEK_SET) && defined( HAVE_UNISTD_H )
  56   109   #include <unistd.h>
  57 ******
  58 File $DISK2:[JOUKJ.PUBLIC.TIFF.TIFF.LIBTIFF]TIFFCOMP.H;1
  59   106   #if !defined(SEEK_SET) && HAVE_UNISTD_H
  60   107   #include <unistd.h>
  61 ************
  62
  63     -X11:libxpm.olb ( from ftp://koala.inria.fr/pub/xpm/ )
  64         add /name=(as_is,short) to cc_defs in the descrip.mms file
  65
  66     -GTK & VMS Porting library (only needed for wxGTK)
  67        ( from http://www.openvms.digital.com/openvms/products/ips/gtk.html )
  68
  69     -Redefine the logical SYS$LIBRARY in such a way that it also points
  70      to the includefile/library directories of the obove packages:
  71      i.e.
  72 $ define sys$library sys$sysroot:[syslib],-
  73      $disk2:[joukj.public.xpm.xpm.lib],-
  74      $disk2:[joukj.public.jpeg.jpeg],-
  75      $disk2:[joukj.public.png.libpng],-
  76      $disk2:[joukj.public.tiff.tiff.libtiff],-
  77      $disk2:[joukj.public.png.zlib],-
  78      $disk2:[joukj.public.gtk.gtk.glib],-
  79      $disk2:[joukj.public.gtk.gtk.glib.gthread],-
  80      $disk2:[joukj.compaq.porting_library.dist.include]
  81
  82     -redefine the logical X11 in such a way that also points to the
  83       xpm-distribution.
  84       i.e.
  85 $  define/nolog X11 $disk2:[joukj.public.xpm.xpm.lib],decw$include
  86
  87     -for wxGTK you'll have to redefine SYS$SHARE to compile and run the
  88          applications.
  89      i.e.
  90 $  ass $disk2:[joukj.public.gtk.gtk.glib],-
  91        $disk2:[joukj.public.gtk.gtk.glib.gmodule],-
  92        $disk2:[joukj.public.gtk.gtk.gtk.gdk],-
  93        $disk2:[joukj.public.gtk.gtk.gtk.gtk],-
  94        $disk2:[joukj.compaq.porting_library.dist.lib],-
  95        sys$sysroot:[syslib] sys$share
  96
  97     -At the moment you'll have to hack the [.src.common]descrip.mms file
  98        to include the right location of bison/flex and sed, but i intend to
  99        make this better in future.
 100
 101     -The following is a work-around a include file bug which occurs on some
 102       versions of VMS. If you get lib$get_current_invo_context undefined
 103       while linking you'll have to add
 104          "lib$get_current_invo_context"="LIB$GET_CURR_INVO_CONTEXT"
 105       in [.src.unix]descrip.mms to CXX_DEFINE. and recompile wxWindows.
 106
 107     -Some versions of the CC compiler give warnings like
 108        %CC-W-CXXKEYWORD, "bool" is a keyword in C++ .... when compiling
 109        if You encounter these, replace mms by mms/ignore=warning in the
 110        following
 111
 112   -Now build evrything using one of the following
 113       mms
 114       mms gtk
 115       mms motif
 116     in the main directory of the distribution. Without an argument both wxGTK
 117     and wxMOTIF are build. The libraies are build in the [.lib] directory.
 118     All the samples I tried are build automatically.
 119
 120   -I think in general wxGTK is better maintained, so that version is my
 121     first choice.
 122
 123   -Note that only a few people have used wxWindows on VMS so many problems are
 124    to be expected.
 125
 126
 127  -Many thanks for testing and reporting problems to:
 128     -Walter Braeu
 129
 130 Finally :
 131  I like the idea of Robert Roebling that CD's with classical music should be
 132 send to the authors.
 133
 134
 135 >-----------------------------------------------------------------------------<
 136
 137   Jouk Jansen
 138
 139   joukj@hrem.stm.tudelft.nl
 140
 141
 142   Technische Universiteit Delft        tttttttttt  uu     uu  ddddddd
 143   Nationaal centrum voor HREM          tttttttttt  uu     uu  dd    dd
 144   Rotterdamseweg 137                       tt      uu     uu  dd     dd
 145   2628 AL Delft                            tt      uu     uu  dd     dd
 146   Nederland                                tt      uu     uu  dd    dd
 147   tel. 31-15-2781536                       tt       uuuuuuu   ddddddd
 148
 149 >-----------------------------------------------------------------------------<