Changes:
========

2008-01-07:
  Python-ogre compilation using ebuilds is working now for ogre, ois, and ogrenewt.

2008-04-21:
  Updating the ebuilds according to today's state of python-ogre svn.

  updated in portage:
    scons-0.97, nvidia-cg-toolkit-2.0.0010 (removed in overlay), ois-1.2.0, cmake-2.4.8

  overlay changes:
    boost-1.34.1_p99, ogre-1.4.7_p99

  unsure TODO:
    freeimage-3.9.3-r1 (python-ogre svn now references 3100)

2008-04-23:
  separate ebuilds for the python-ogre (wrappers for ogre and ois) and python-ogre-ogrenewt
  to make rebuilding parts and adding new parts easier

Dependency Tree:
================

(suffixes -9999  (direct from version control) and _p99 indicate
packages in the overlay with the reason in parentheses.)

* dev-games/python-ogre-9999 (svn)

runtime dependencies:

  - >= python-2.5.2

  - dev-games/ogre-1.4.7_p99 (gentoo version + freeimage support + python-ogre specific patch)

    USE="cegui cg freeimage -devil -gtk -threads"

    (automatic dependencies: cegui, cg, freeimage, zzlib. Takes care of:
    zzlib-0.13.49, freeimage-3.9.3-r1, cegui-0.5.0b-r3, nvidia-cg-toolkit-2.0.0010)
    (boost would be a dependency for threads support, but I could not get python-ogre to
    compile with a threading-enabled ogre, and Andy on the python-ogre list confirmed that
    the distributed ogre in python-ogre is built without thread support. It should work, however.)

    possible TODO: freeimage in python-ogre svn is now 3100 but maybe the old one works?

  - dev-games/ois-1.2.0

compile-time-only dependencies:

  - >= scons-0.97

  - dev-python/py++-9999 (svn)

    - dev-python/pygccxml-9999 (svn)

      - dev-cpp/gccxml-9999 (cvs)

        - >= cmake-2.4.6

    - >=dev-libs/boost-1.34.1_p99

optional additional installs:
(all these are functionally identical to python-ogre, but compile different parts)

* dev-games/python-ogre-ogrenewt-9999 (svn)

  - dev-games/ogrenewt-9999 (cvs ogreaddons + patches)

    - dev-games/newton-1.53_p99 (gentoo version + python-ogre specific patch)

    - dev-libs/boost-1.34.1_p99 (gentoo version + patch, bjam (boost-build) is automatically used)


TODO: more optional libraries

  - dev-games/ogrebullet-????

    - sci-physics/bullet-2.67

-------

- bullet-2.67 (currently in portage)

- CEGUI-0.5.0b (should be taken care of by the ogre build)
- ogreode-9999 (cvs ogreaddons + patch)
  - ODE-0.9
- ogreal
  - libogg-1.1.3
  - libvorbis-1.2.0
  - openal-0.0.8
((- nxogre-9999 (svn) ))


Notes:
======
 
If the ogre ebuild is compiled with use-flag gtk it forgets to install
the gtk headers in include/OGRE/gtk (according to the python-ogre forums
this might be an ogre bug),
anyway python-ogre needs Xt/glx not gtk, so the package.use entries below
add USE="-gtk" to the ogre package.

If you want to save some download time: the different python-ogre* ebuilds
all reference python-ogre svn, but portage updates these svn checkouts as
separate ones. You can change that in /usr/portage/distfiles/svn-src with:
# ln -s python-ogre python-ogre-ogrenewt

Portage configs:
================

Necessary entries in package.keywords:

~dev-lang/python-2.5.2
=media-gfx/nvidia-cg-toolkit-2.0.0010
=dev-cpp/gccxml-9999
=dev-python/pygccxml-9999
=dev-python/py++-9999
=dev-games/python-ogre-9999
~dev-games/ogre-1.4.7_p99
~dev-libs/boost-1.34.1_p99
~dev-util/boost-build-1.34.1
~media-libs/freeimage-3.10.0
~dev-games/ois-1.2.0
=dev-games/ogrenewt-9999
=dev-games/newton-1.53_p99
=dev-games/python-ogre-ogrenewt-9999
=media-libs/openjpeg-1.2

Necessary entries in package.use:

~dev-games/ogre-1.4.7_p99 freeimage -gtk cegui cg -devil -threads
=dev-libs/boost-1.34.1_p99 pythoncontainer -pyste
dev-games/python-ogre ogrenewt

In package.unmask:

~media-libs/freeimage-3.10.0