home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / doc / liboil0.3 / README < prev   
Encoding:
Text File  |  2005-12-27  |  2.6 KB  |  79 lines
  1.  
  2.  
  3. Requirements
  4. ============
  5.  
  6. Liboil has no required dependecies (other than a decent C compiler
  7. and standard C library).  A few extra tests and examples are enabled
  8. if you have glib-2.0 installed, but these extras are neither required
  9. nor installed.
  10.  
  11. Using GCC is strongly recommended, since the most interesting bits
  12. of liboil are written in GCC-style inline assembly.  GCC versions
  13. prior to 3.2 are not supported.
  14.  
  15.  
  16. Problems Compiling?
  17. ===================
  18.  
  19. Function implementations in liboil are designed to be modular, so
  20. if your compiler is having difficulty compiling a particular function,
  21. simply disable it and the corresponding OIL_DEFINE_IMPL() line.
  22.  
  23.  
  24. ABI warning
  25. ===========
  26.  
  27. In general, liboil is not ABI stable.  However, portions of liboil
  28. are guaranteed to be stable through the 0.3.x series, and by using
  29. a compatibility library, through the 0.4.x series as well.  This
  30. policy is designed to provide almost all applications the necessary
  31. ABI stability for the symbols likely to be used in liboil.
  32.  
  33. Any symbols declared by including <liboil/liboil.h> follow this
  34. ABI policy.  This includes all liboil function classes as well
  35. as a limited number of core functionality, such as oil_init().
  36.  
  37.  
  38.  
  39. ABI Implementation
  40. ==================
  41.  
  42. The liboil-0.3.x series create the shared library liboil-0.3.so.
  43. Applications that use liboil are linked against this library, and
  44. will load liboil-0.3.so at runtime.
  45.  
  46. The liboil-0.4.x series will create two shared libraries,
  47. liboil-0.4.so and a compaitiblity library liboil-0.3.so that
  48. implements functionality removed in the 0.3->0.4 transition.
  49. The 0.3 shared library will be binary compatible with the
  50. liboil-0.3.x releases.  Thus, applictions compiled with a
  51. liboil-0.3.x release will continue to function after the shared
  52. library is upgraded to a 0.4.x release.  Applications compiled
  53. with 0.4.x will use liboil-0.4.so directly.
  54.  
  55. Distributions can use this compatibility library in order to
  56. smooth transitions between liboil major releases.  For example,
  57. consider the case where AppA depends on libB and libC, and both
  58. libraries use liboil.  When liboil-0.4 is released, the distro
  59. can start using it immediately, and AppA will continue to work
  60. correctly.  Then, at a convenient time, libB and libC can
  61. independently be recompiled using liboil-0.4.x, and the packages
  62. will no longer depend on liboil-0.3.so.
  63.  
  64. The traditional way of dealing with these changes is to migrate
  65. all packages to the new library as quickly as possible.  This is
  66. unduly cumbersome.
  67.  
  68.  
  69.  
  70. Random Ideas
  71. ============
  72.  
  73. Why is trans8x8_f64 so slow on powerpc (compared to trans8x8_u16)?
  74.  
  75. oil_restride_XXX() - copy with stride
  76.  
  77.  
  78.  
  79.