From 043d97d7ecd01da7c5ac43a0e87565ba0f3bd35b Mon Sep 17 00:00:00 2001
From: Jan Pipek <jan.pipek@gmail.com>
Date: Tue, 10 Sep 2019 15:53:10 +0200
Subject: Docstrings in requested format.

---
 pyasn1/codec/ber/decoder.py | 46 +++++++++++++++++++++++++++++++++++++--------
 1 file changed, 38 insertions(+), 8 deletions(-)

diff --git a/pyasn1/codec/ber/decoder.py b/pyasn1/codec/ber/decoder.py
index 9fa5374..0bd804c 100644
--- a/pyasn1/codec/ber/decoder.py
+++ b/pyasn1/codec/ber/decoder.py
@@ -34,10 +34,20 @@ _PY2 = sys.version_info < (3,)
 
 
 def asSeekableStream(substrate):
-    """Convert object to seekable bytes stream.
+    """Convert object to seekable byte-stream.
 
-    :type substrate: Union[bytes, IOBase, univ.OctetString]
-    :rtype: IOBase
+    Parameters
+    ----------
+    substrate: :py:class:`bytes` or :py:class:`io.IOBase` or :py:class:`univ.OctetString`
+
+    Returns
+    -------
+    : :py:class:`io.IOBase`
+
+    Raises
+    ------
+    ~pyasn1.error.PyAsn1Error
+        If the supplied substrate cannot be converted to a seekable stream.
     """
     if isinstance(substrate, bytes):
         return BytesIO(substrate)
@@ -56,10 +66,19 @@ def asSeekableStream(substrate):
 
 
 def endOfStream(substrate):
-    """Check whether we have reached an end of stream.
+    """Check whether we have reached the end of a stream.
+
+    Although it is more effective to read and catch exceptions, this
+    function
 
-    :type substrate: IOBase
-    :rtype: bool
+    Parameters
+    ----------
+    substrate: :py:class:`IOBase`
+        Stream to check
+
+    Returns
+    -------
+    : :py:class:`bool`
     """
     if isinstance(substrate, BytesIO):
         cp = substrate.tell()
@@ -72,9 +91,20 @@ def endOfStream(substrate):
 
 
 def peek(substrate, size=-1):
-    """Peak the stream
+    """Peek the stream.
+
+    Parameters
+    ----------
+    substrate: :py:class:`IOBase`
+        Stream to read from.
+
+    size: :py:class:`int`
+        How many bytes to peek (-1 = all available)
 
-    :param size:
+    Returns
+    -------
+    : :py:class:`bytes` or :py:class:`str`
+        The return type depends on Python major version
     """
     if hasattr(substrate, "peek"):
         return substrate.peek(size)
-- 
cgit v1.2.1