git.demorecorder.com Git - free-sw/xcb/proto/blob - README

   1 About xcb-proto
   2 ===============
   3
   4 xcb-proto provides the XML-XCB protocol descriptions that libxcb uses to
   5 generate the majority of its code and API. We provide them separately
   6 from libxcb to allow reuse by other projects, such as additional
   7 language bindings, protocol dissectors, or documentation generators.
   8
   9 This separation between the XCB transport layer and the
  10 automatically-generated protocol layer also makes it far easier to write
  11 new extensions. With the Xlib infrastructure, client-side support for
  12 new extensions requires significant duplication of effort. With XCB and
  13 the XML-XCB protocol descriptions, client-side support for a new
  14 extension requires only an XML description of the extension, and not a
  15 single line of code.
  16
  17 Python libraries: xcb-proto also contains language-independent Python
  18 libraries that are used to parse an XML description and create objects
  19 used by Python code generators in individual language bindings.  These
  20 libraries are installed into $(prefix)/lib/pythonX.X/site-packages.  If
  21 this location is not on your system's Python path, scripts that import
  22 them will fail with import errors.  In this case you must add the
  23 install location to your Python path by creating a file with a `.pth'
  24 extension in a directory that _is_ on the Python path, and put the
  25 path to the install location in that file.  For example, on my system
  26 there is a file named 'local.pth' in /usr/lib/python2.5/site-packages,
  27 which contains '/usr/local/lib/python2.5/site-packages'.  Note that
  28 this is only necessary on machines where XCB is being built.
  29
  30 Please report any issues you find to the freedesktop.org bug tracker,
  31 at:
  32
  33         <https://bugs.freedesktop.org/enter_bug.cgi?product=XCB>
  34
  35 Discussion about XCB occurs on the XCB mailing list:
  36
  37         <mailto:xcb at lists.freedesktop.org>
  38         <http://lists.freedesktop.org/mailman/listinfo/xcb>
  39
  40 You can obtain the latest development versions of XCB using GIT.
  41 For anonymous checkouts, use:
  42
  43         git clone git://anongit.freedesktop.org/git/xcb/proto
  44
  45 For developers, use:
  46
  47         git clone git+ssh://git.freedesktop.org/git/xcb/proto