docs/README.OS2

   1             README for port of Mesa 3.x to XFree86 on OS/2 (X/2)
   2                           (as of 19990514)
   3
   4
   5                            Contents:
   6
   7                            1) Binary release
   8                            2) Building from sources
   9                            3) History
  10                            4) Todo
  11                            5) Mesa Home Page
  12
  13
  14 1) Binary release
  15
  16    Though the Mesa sources should build in a quite reasonable time even on
  17    a 585 class machine a binary relase is available (check topic 4) for an URL)
  18    This package includes:
  19
  20      - lib/MesaGL.dll,  MesaGL.a
  21      - lib/MesaGLU.dll, MesaGLU.a
  22      - lib/glut.dll,    glut.a
  23      - include/GL/*.h
  24
  25     Installing this in your XFree86 tree will enable you to build and
  26     run all applications compatible with Mesa (and the current DLL
  27     interface, of course ;-)
  28     As usual the OMF-style libraries can be created using emxomf.
  29     (e.g. "emxomf foo.a"  creates the foo.lib omf-style library).
  30     The static libraries are rarely used and you have to rebuild
  31     Mesa to get them. They're a supported target, so you get
  32     them in a straightforward way (see below).
  33
  34     The testing of these libraries was limited to the supplied
  35     demos/examples and a quite small number of third-party apps.
  36     No warranty ... as usual ...  ;-)
  37
  38
  39 2)  Instructions to build Mesa 3.x for XFree86/OS2 from sources:
  40
  41     Except the official Mesa source distribution you need:
  42       - a recent version of XFree86 (3.3.x or above) including
  43         the programming libraries
  44       - EMX 0.9c (0.9d might work, never checked)
  45       - GNU make
  46       - REXX (!)
  47
  48     The creation of the DLLs as well as of the static libraries
  49     (if you want to have them) is handled in "mklib-emx.cmd",
  50     a small REXX script. Perhaps not the best idea, but this
  51     way it fits best in the scheme used to build libraries
  52     on all platforms in Mesa 3.x.
  53
  54     To actually build the libraries and demos, check mklib-emx.cmd
  55     and modify it as desired. Then type
  56       make os2-x11
  57     and wait for completion ;-)
  58
  59
  60 3)  History
  61
  62     Initially Darren Abbott (abbott@hiwaay.net) ported Mesa versions 2.x
  63     to XFree86 OS/2. This port might still be available from
  64        http://fly.HiWAAY.net/~abbott/xfree86-os2/xfree86.html
  65
  66     The current port picked up things during the beta test for 3.0.
  67     No major changes in the source were done. The build mechanism under OS/2
  68     has been made very similar to other platforms (if you treat mklib-emx.cmd
  69     as a "black box").
  70     Advantage is that X/2 is now a valid target and all files are
  71     integrated in the official source distribution.
  72     Disadvantage is that this port (i.e. the DLLs' interface itself) is
  73     definitly NOT COMPATIBLE to those of version 2.x.
  74     It's uncertain whether this would be at all possible but since there
  75     a _very_ few those apps it's not worth to find out anyway.
  76     Also some libs (MesaTK, MesaAUX) are withdrawn from the Mesa distribution,
  77     and accordingly from the OS/2 port.
  78
  79 4) Todo
  80
  81     By now binary compatiblity is ensured by using the function names
  82     as entry points instead of ordinals. This might cost performance and
  83     is subject to change in future. In addition the supplied X86 assembler
  84     source is not used yet.
  85
  86 5)  Mesa Home Page
  87
  88     You can get the source code and more information about Mesa from
  89        http://www.mesa3d.org/
  90
  91     The OS/2 ports should be available from
  92        http://r350.ee.ntu.edu.tw/~hcchu/os2/ports
  93
  94 --
  95 Alexander Mai
  96 st002279@hrzpub.tu-darmstadt.de