From adc0d800e1e9547c351151fc1135a62fc2f66351 Mon Sep 17 00:00:00 2001
From: Lars Immisch <lars@ibp.de>
Date: Fri, 17 Mar 2017 20:40:40 +0100
Subject: [PATCH] Document EPIPE

---
 doc/libalsaaudio.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/libalsaaudio.rst b/doc/libalsaaudio.rst
index 8fc3b87..c1fc337 100644
--- a/doc/libalsaaudio.rst
+++ b/doc/libalsaaudio.rst
@@ -233,6 +233,9 @@ PCM objects have the following methods:
    ``(0,'')`` if no new period has become available since the last
    call to read.
 
+   In case of an overrun, this function will return a negative size: :const:`-EPIPE`.
+   This indicates that data was lost, even if the operation itself succeeded.
+   Try using a larger periodsize;
 
 .. method:: PCM.write(data)