Issue #8340: document bytearray in Python 2.7.
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 4b4c9b2..0b16327 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -78,6 +78,32 @@
If no argument is given, this function returns :const:`False`.
+.. function:: bytearray([source[, encoding[, errors]]])
+
+ Return a new array of bytes. The :class:`bytearray` type is a mutable
+ sequence of integers in the range 0 <= x < 256. It has most of the usual
+ methods of mutable sequences, described in :ref:`typesseq-mutable`, as well
+ as most methods that the :class:`str` type has, see :ref:`string-methods`.
+
+ The optional *source* parameter can be used to initialize the array in a few
+ different ways:
+
+ * If it is a *string*, you must also give the *encoding* (and optionally,
+ *errors*) parameters; :func:`bytearray` then converts the string to
+ bytes using :meth:`str.encode`.
+
+ * If it is an *integer*, the array will have that size and will be
+ initialized with null bytes.
+
+ * If it is an object conforming to the *buffer* interface, a read-only buffer
+ of the object will be used to initialize the bytes array.
+
+ * If it is an *iterable*, it must be an iterable of integers in the range
+ ``0 <= x < 256``, which are used as the initial contents of the array.
+
+ Without an argument, an array of size 0 is created.
+
+
.. function:: callable(object)
Return :const:`True` if the *object* argument appears callable,