TODO

   1 # -*- org -*-
   2
   3 * Completeness
   4
   5 ** Complete the high-level GL binding.
   6
   7 Would be nice to bind newer versions as well, while keeping the
   8 compatibility profile.
   9
  10 ** Complete the high-level GLU binding.
  11
  12 ** Complete the high-level GLX binding.
  13
  14 ** Complete the high-level GLUT binding.
  15
  16 ** Write an EGL binding.
  17
  18 There is a wip-egl branch with upstream documentation.
  19
  20 * Naming
  21
  22 ** Mangle low-level binding names.
  23
  24 Probably we should do this only if this low-level bindings are good
  25 enough.  In practice this means that output arguments should be natively
  26 supported, and they low-level bindings should check errors as
  27 appropriate.
  28
  29 ** Document the naming convention.
  30
  31 Specifically we should document when a name changes significantly, like
  32 when to use a "set-" prefix.
  33
  34 * Documentation
  35
  36 ** Figure out how to incorporate low-level bindings into the
  37    documentation.
  38
  39 Often-times the high-level bindings just duplicate information from the
  40 low-level bindings, but poorly.  To do this, we'd have to make a map of
  41 how to organize the low-level bindings, probably according to their
  42 section in the specification.
  43
  44 ** Mangle enumeration names to link to the enumerator documentation.
  45
  46 ** Give an @anchor{} to each API element so that we can link back and
  47    forth.
  48
  49 * Meta
  50
  51 ** Mailing list?
  52
  53 ** Web page for documentation?
  54
  55 Both of these point towards hosting on savannah at some point.  Figl
  56 could become a GNU project but it will not have copyright assignment.