Update documentation. Closes #18

Make sure no other setup.py from `sys.path` is accidentally loaded

alsaaudio.c

@@ -826,7 +826,11 @@ frames as bytes (or a string in Python 2.x). The length of the returned data\n\
  will be periodsize*framesize bytes.\n\
 \n\
 In PCM_NONBLOCK mode, the call will not block, but will return (0,'')\n\
-if no new period has become available since the last call to read.");
+if no new period has become available since the last call to read.\n\
+\n\
+In case of an overrun, this function will return a negative size: -EPIPE.\n\
+This indicates that data was lost, even if the operation itself succeeded.\n\
+Try using a larger periodsize");
 
 
 static PyObject *alsapcm_write(alsapcm_t *self, PyObject *args)

doc/conf.py

@@ -13,7 +13,7 @@
 
 import sys, os
 
-sys.path.append('..')
+sys.path.insert(0, '..')
 from setup import pyalsa_version
 
 # If your extensions are in another directory, add it here. If the directory
@@ -39,7 +39,7 @@ master_doc = 'index'
 
 # General substitutions.
 project = u'alsaaudio'
-copyright = u'2008-2009, Casper Wilstrup, Lars Immisch'
+copyright = u'2008-20017, Casper Wilstrup, Lars Immisch'
 
 # The default replacements for |version| and |release|, also used in various
 # other places throughout the built documents.