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 wxWidgets:
  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 above 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 wxWidgets.
 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 everything 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 built. The libraries are built in the [.lib] directory.
 118     All the samples I tried are built 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 wxWidgets 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
 131  -Known problems :
 132    wxMOTIF :
 133        -The calendar sample puts the boxes of the month and year selection on
 134         top of each other.
 135        -The caret sample: sometimes a non blinking caret remains in the
 136         window.
 137        -checklist sample: There is no way to check/uncheck since this box is
 138         missing
 139        -conftest sample: The boxes in the window are too small to display
 140         texts with the fonts specified.
 141        -controls sample: radiobox does not appear on the screen
 142        -Some samples crash due to colour allocation problems
 143         i.e. -drawing,image
 144
 145    wxGTK :
 146        -In the calendar sample options can only be switched on and not off
 147         again.
 148        -image sample: after clicking "about" the colourmap is permanently
 149         changed resulting in strange images
 150
 151 Finally :
 152  I like the idea of Robert Roebling that CD's with classical music should be
 153 send to the authors.
 154
 155
 156 >-----------------------------------------------------------------------------<
 157
 158   Jouk Jansen
 159
 160   joukj@hrem.stm.tudelft.nl
 161
 162
 163   Technische Universiteit Delft        tttttttttt  uu     uu  ddddddd
 164   Nationaal centrum voor HREM          tttttttttt  uu     uu  dd    dd
 165   Rotterdamseweg 137                       tt      uu     uu  dd     dd
 166   2628 AL Delft                            tt      uu     uu  dd     dd
 167   Nederland                                tt      uu     uu  dd    dd
 168   tel. 31-15-2781536                       tt       uuuuuuu   ddddddd
 169
 170 >-----------------------------------------------------------------------------<