• Home
  • History
  • Annotate
  • only in this directory
NameDateSize

..29-Mar-2016141

.autom4te.cfgH A D13-Aug-2013183

acinclude.m4H A D13-Aug-20132.6 KiB

aclocal.m4H A D13-Aug-2013238.3 KiB

apidocs/H13-Aug-20136

AUTHORSH A D13-Aug-2013130

bsd.cH A D13-Aug-201316.4 KiB

ChangeLogH A D13-Aug-2013189

compileH A D13-Aug-20133.6 KiB

config.guessH A D13-Aug-201341.1 KiB

config.h.inH A D13-Aug-20132.4 KiB

config.subH A D13-Aug-201329.5 KiB

configureH A D13-Aug-2013728.7 KiB

configure.inH A D13-Aug-20136.6 KiB

COPYINGH A D13-Aug-201325.8 KiB

darwin.cH A D13-Aug-201334.8 KiB

depcompH A D13-Aug-201314.5 KiB

descriptors.cH A D13-Aug-201314.7 KiB

doc/H22-Apr-201610

Doxyfile.inH A D13-Aug-201343.1 KiB

error.cH A D13-Aug-2013759

error.hH A D13-Aug-2013716

install-shH A D13-Aug-20139 KiB

INSTALL.libusb.inH A D13-Aug-20132 KiB

libusb-config.inH A D13-Aug-20131.2 KiB

libusb.pc.inH A D13-Aug-2013196

libusb.spec.inH A D13-Aug-20131.3 KiB

LICENSEH A D13-Aug-20132.2 KiB

linux.cH A D13-Aug-201322.8 KiB

linux.hH A D13-Aug-20133.1 KiB

ltmain.shH A D13-Aug-2013179.4 KiB

Makefile.amH A D13-Aug-20132.2 KiB

Makefile.inH A D14-Aug-201333.4 KiB

missingH A D13-Aug-201310.4 KiB

NEWSH A D13-Aug-20138

README.inH A D13-Aug-20132.5 KiB

tests/H22-Apr-201612

usb.cH A D13-Aug-20136.3 KiB

usb.h.inH A D13-Aug-20138.3 KiB

usbi.hH A D13-Aug-20131.7 KiB

usbpp.cppH A D13-Aug-201313.2 KiB

usbpp.hH A D13-Aug-201323.9 KiB

README.in

1General Information
2===================
3
4This is libusb version @LIBUSB_VERSION@. libusb is a library which allows
5userspace application access to USB devices.
6
7The official ftp site is:
8  ftp://ftp.libusb.sourceforge.net/pub/libusb/
9
10The official web site is:
11  http://libusb.sourceforge.net/
12
13A mailing list is located at:
14  libusb-devel@lists.sourceforge.net
15
16Installation
17============
18
19See the file 'INSTALL'
20
21How to report bugs
22==================
23
24To report a bug, visit http://www.sourceforge.net/projects/libusb/ and fill
25out a bug report form.
26
27Please make sure to include:
28
29* The version of libusb
30
31* Information about your system. For instance:
32
33   - What operating system and version
34   - For Linux, what version of the C library
35
36  And anything else you think is relevant.
37
38* How to reproduce the bug. 
39
40  If you can reproduce it with the testlibusb program that is built 
41  in the libusb/ directory, that will be most convenient.  Otherwise, 
42  please include a short test program that exhibits the behavior. 
43  As a last resort, you can also provide a pointer to a larger piece 
44  of software that can be downloaded.
45
46* If the bug was a crash, the exact text that was printed out
47  when the crash occured.
48
49* Further information such as stack traces may be useful, but
50  is not necessary.
51
52Patches
53=======
54
55Patches can be sent to libusb-devel@lists.sourceforge.net.
56
57If the patch fixes a bug, it is usually a good idea to include
58all the information described in "How to Report Bugs".
59
60Building
61========
62
63It should be as simple as running these two commands:
64
65./configure
66make
67
68One common problem is building the SGML documentation. On some systems,
69like SuSE, you will need to set the SGML_CATALOG_FILES environment
70variable to something similar to this (actual paths may vary):
71
72export SGML_CATALOG_FILES="/usr/share/sgml/CATALOG.docbook_3:/usr/share/sgml/CATALOG.docbook-dsssl-stylesheets:/usr/share/sgml/openjade/catalog"
73
74On recent versions of Fedora Core (FC5 Test 2 atleast), this command may be
75needed:
76
77export SGML_CATALOG_FILES="/etc/sgml/catalog"
78
79or possibly:
80
81export SGML_CATALOG_FILES="/etc/sgml/docbook"
82
83C++ Support
84===========
85
86There are reasonable unit tests available - run "make check" to do the
87tests. Note that some of the tests will unexpectedly pass if you don't have
88a specfic type of Logitech mouse connected, and some are expected to fail
89unless you are running as root (or otherwise have permissions to access the
90device).
91
92Building the C++ documentation requires Doxygen
93(http://www.stack.nl/~dimitri/doxygen/) 
94
95