From 511324a538a034f7f0766b7689ed50ed4e21ee43 Mon Sep 17 00:00:00 2001
From: Daniel Drake <dsd@gentoo.org>
Date: Thu, 17 Sep 2009 23:49:53 +0545
Subject: [PATCH] Document breakage from internal handle structure change

Code exists which expects usb_dev_handle to always have the same
contents as it did in libusb-0.1.12. Such code will not work with the
compat layer since the structure has changed.
---
 README |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/README b/README
index 15f17a5..97ab68d 100644
--- a/README
+++ b/README
@@ -29,6 +29,11 @@ Known quirks/differences from libusb-0.1:
  5. Error codes returned on certain events may not exactly match the error
     codes returned by libusb-0.1. Patches accepted to bring us closer to the
     behaviour of libusb-0.1 on Linux.
+ 6. The internal structure of usb_dev_handle is different from libusb-0.1. Of
+    course, since this is a purely internal structure, that shouldn't cause
+    any problems. In reality, some libusb-0.1 users make assumptions about what
+    is inside (bad programming practice) and those assumptions are no longer
+    true, resulting in broken software.
 
 libusb homepage:
 http://libusb.sourceforge.net
-- 
1.7.2.2