Add some internal and useful documentation

diff --git a/docs/0README b/docs/0README
new file mode 100644 (file)
index 0000000..6e831b8
--- /dev/null
+++ b/docs/0README
@@ -0,0 +1,3 @@
+This is a directory with all kinds of developer documentation, not
+really meant for a release, but still good to know.  They should
+eventually go into a documentation repository, but for now...

diff --git a/docs/quirks-and-workarounds.txt b/docs/quirks-and-workarounds.txt
new file mode 100644 (file)
index 0000000..8b091cd
--- /dev/null
+++ b/docs/quirks-and-workarounds.txt
@@ -0,0 +1,12 @@
+It seems like the Linux kernel takes exclusive ownership over the
+Yubikey, making it difficult for our programs to talk with it.
+There's a workaround, though, to set a quirks mode for the key, as
+follows:
+
+  rmmod usbhid && modprobe usbhid quirks=0x1050:0x0010:0x04
+
+In that mode, though, the Yubikey will not work as a keyboard and
+therefore not generate any string at all, so to have it work as usual
+again, you'll have to take usbhid out of quirks more:
+
+  rmmod usbhid && modprobe usbhid