Changeset cfb368e1db62670a62e73af5ee589e663e9dc999

Show
Ignore:
Timestamp:
06/29/07 01:50:26 (6 years ago)
Author:
dsmith <dsmith@…>
Children:
efbd885d7c8e6cecb1c6fccc45f845249630e0e1
Parents:
bb2d26b30a8b224fea2167a2eb881d38cddc0043
git-author:
L. Donnie Smith <donnie.smith@…> (06/29/07 01:50:26)
git-committer:
dsmith <dsmith@…> (06/29/07 01:50:26)
Message:

docs update

git-svn-id: http://abstrakraft.org/cwiid/svn/trunk@132 918edb2d-ff29-0410-9de2-eb38e7f22bc7

Files:
3 modified

Legend:

Unmodified
Added
Removed
  • NEWS

    re1e47e1 rcfb368e  
     10.6.00 
     2        - renamed libwiimote to libcwiid to avoid naming conflict with other projects 
     3        - rewrite of libcwiid architecture 
     4        - Python libcwiid interface 
     5        - Python wminput plugins 
     6        - rewrite of ir_ptr plugin 
     7 
    180.5.03 
    29        - Bugfixes, lswm utility, disconnect messages, wminput infinite wait 
  • README

    r20c5b08 rcfb368e  
    2424The CWiid package contains the following parts: 
    25251.libcwiid - wiimote API. 
    26 2.wmgui - GTK gui to the wiimote. 
    27 3.wminput - an event/joystick/mouse driver for the wiimote. 
    28 4.lswm - list wiimote devices (in the spirit of ls{,pci,usb}, etc. 
    29 4.wmdemo - a minimal demonstration of the libwiimote API. (not installed) 
     262.cwiid module - python interface to libcwiid 
     273.wmgui - GTK gui to the wiimote. 
     284.wminput - an event/joystick/mouse driver for the wiimote. 
     295.lswm - list wiimote devices (in the spirit of ls{,pci,usb}, etc. 
     306.wmdemo - a minimal demonstration of the libwiimote API. (not installed) 
    3031 
    3132REQUIREMENTS 
    3233------------------------------------------------------------------------------------------------ 
    33 awk, bison, flex, bluez-libs, gtk+-2 dev libs, uinput kernel support, kernel sources 
     34awk, bison, flex, bluez-libs, gtk+-2 dev libs, python 2.4 or greater, uinput kernel support, kernel sources 
    3435 
    3536INSTALLATION 
     
    4142To install global configuration files to the more familiar /etc rather than /usr/etc or /usr/local/etc, execute configure with --sysconfdir=/etc. 
    4243 
    43 While CWiid is still in the early development stages, installation directories and filenames are changed more often than in a mature, stable package.  In order to prevent the collection of obselete directories and files, it is recommended that you run 'make uninstall && make uninstall_config' from your current CWiid source directory before installing a new one.  Files are currently installed to the following directories: /usr/local/{bin,etc,lib,lib/cwiid}.  Recently, but no longer, used directories include /usr/share/CWiid - this directory may be deleted. 
     44While CWiid is still in the early development stages, installation directories and filenames are changed more often than in a mature, stable package.  In order to prevent the collection of obselete directories and files, it is recommended that you run 'make uninstall && make uninstall_config' from your current CWiid source directory before installing a new one.  Files are currently installed to the following directories: /usr/local/{bin,etc,lib,lib/cwiid,lib/python2.X/site-packages,share/doc,share/man}.  Recently, but no longer, used directories include /usr/share/CWiid - this directory may be deleted. 
    4445 
    4546Many distributions do not have /usr/local/lib in the library search path, and on many of these same distributions, the library installation directory (as determined by autoconf) is /usr/local/lib, creating a problem when you try to run programs depending on libraries installed there. There are two clean ways to fix this: 
    46471.Add a --prefix=/usr argument to ./configure 
    47 2.Add /usr/local/lib to /etc/ld.so.conf, then run ldconfig.  
     482.Add /usr/local/lib to /etc/ld.so.conf, then run ldconfig. 
    4849 
    4950I prefer the second method since it keeps local software in the local directory where it should be, and it fixes the problem for every package using /usr/local/lib, not just CWiid.  Until someone offers a convincing argument for the omission of /usr/local/lib from /etc/ld.so.conf, I consider this to be a distribution bug, and method #2 above is the fix. 
  • wminput/README

    rc01a5a4 rcfb368e  
    9191For developers, the plugin API is specified in cwiid/wminput/wmplugin.h.  The examples cover most of the functionality, except buttons, which are triggered by asserting the i^th bit of the buttons element of struct wmplugin_data, where i is the index of the button. 
    9292 
     93Plugins may now be implemented in Python, as well as C.  A Python version of the acc plugin may be found in cwiid/wminput/plugins/acc.