OVERVIEW

  These WarpIN packages are designed to contain everything you need to get the
  GIMP (GNU Image Manipulation Program) version 2.2.8 running on OS/2 without
  having to install the XFree86/2 server.  

  You do need AN X server, somewhere.  It could be HOBLink X11, eXceed, WeirdX,
  or even XFree86/2 if you have it... but the advantage of using HOBLink or
  WeirdX (or eXceed) is that you can run the GIMP in "windowed" mode like a
  native PM application.  

  Alternatively, you could redirect it to a separate Linux box on your network
  (that runs XFree86), although for most people that's probably less useful.

  The install package itself provides more information about how to set up your
  X11 server.  (See also usr\X11R6\doc\XFree86-4.5.0\server-tips.txt after
  installation.)

  This concept has been implemented before, but AFAIK only with 1.x versions of
  the GIMP (when HOB themselves provided a set of WarpIn packages with
  instructions).  Now, with these packages, you can use the latest GIMP
  (version 2.2.8); my packages are also somewhat more sophisticated than the
  ones HOB used to provide.

  The whole thing takes about 64 MB once installed - unless you install the
  non-English helpfiles, in which case add a fair bit more to that total.

  Feedback is appreciated.


FILES

  XFree86-4_5_0-runtime.wpi

    This contains the runtime DLLs from XFree86/2 that ported applications like
    the GIMP need in order to run.  It doesn't include the XFree86 server.  You
    can install to a path of your choice (beneath which it will create a
    standard *nix-ish directory tree, since most X programs expect that); you
    may find, however, that some X programs (though not the GIMP) assume that
    it will be installed to the root directory of a drive.

    Note that you should be able to install most any other XFree86-ported
    program using these libraries, not just the GIMP.  I've tested very briefly 
    with a couple of XFree86/2 utilities, and they seem to work as well (xterm
    will NOT work this way, however).
    
    You will need HOBLink or another X server running, of course.

    This package is required, unless you have the full XFree86/2 product
    already installed (in which case you can skip this package).


  GIMP-2_2_8-install.wpi

    The main GIMP binaries.  This package is required.


  GIMP-2_2_8-required-libs.wpi

    Various external libraries that the GIMP depends on.  This package is 
    required.


  GIMP-2_0_7-help.wpi

    This package is optional.  It contains the help files (HTML format) for the
    GIMP, apparently taken from version 2.0.7.  All of this is available online
    at www.gimp.org as well, so there's really little need to install it.


INSTALLATION

  At a minimum, you need the packages GIMP-2_2_8-install.wpi and 
  GIMP-2_2_8-required-libs.wpi; you will also need XFree86-4_5_0-runtime.wpi
  unless you have XFree86/2 already installed on your system.  Download all 
  of these files to the same directory.

  Install XFree86-4_5_0-runtime.wpi first by opening it in WarpIn.  The install
  package will give you some information on how to install and configure an X11
  server like HOBLink or WeirdX if you don't have one already.  

  Once the X11 libraries are installed, open the file GIMP-2_2_8-install.wpi 
  in WarpIN.  It should detect the GIMP-2_2_8-required-libs.wpi package and 
  add it to the install process automatically.  You MUST install these 
  packages to the same target directory as the XFree86 libraries (this path
  should be detected and preselected for you by default).

  Once everything is installed, make sure your X11 server is set up properly.
  I recommend using HOBLink if you have it; WeirdX is rather sluggish (I have
  no personal experience with Hummingbird eXceed).  Make sure your X11ENV.CMD
  (in the top-level directory where these packages were installed) contains the
  correct display number in the DISPLAY setting (which corresponds to how your
  X11 server is configured).  Then start the X11 server and try running the
  GIMP.  If all goes well, the GIMP should start up and prompt you for some
  configuration paths.  Just do whatever it says, and enjoy using it!

  You may occasionally get video artifacts in the GIMP's windows (usually as a
  result of moving objects or layers).  These can be cleared up by simply
  switching focus to another window and then back again.

  N.B.: I do suggest saving your work frequently.  A crash in either the X11
  server or the GIMP could result in lost work.  I accept no responsibility
  for either.


-- 
Alex Taylor (August 2006)
alextaylor41 [at] rogers [dot] com