From 143de623e72f69b60c092333f4b6e6fa009957e0 Mon Sep 17 00:00:00 2001
From: Georg Brandl <georg@python.org>
Date: Mon, 4 Aug 2008 06:29:36 +0000
Subject: [PATCH] Fix markup.

---
 Doc/library/subprocess.rst | 27 ++++++++++++---------------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 3458003fe5..32a1d667c2 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -193,9 +193,11 @@ Instances of the :class:`Popen` class have the following methods:
    Wait for child process to terminate.  Set and return :attr:`returncode`
    attribute.
 
-   warning:: This will deadlock if the child process generates enough output
-   to a stdout or stderr pipe causing it to block waiting for the OS's pipe
-   buffer to accept more data.
+   .. warning::
+
+      This will deadlock if the child process generates enough output to a
+      stdout or stderr pipe causing it to block waiting for the OS's pipe buffer
+      to accept more data.
 
 
 .. method:: Popen.communicate(input=None)
@@ -249,35 +251,30 @@ Instances of the :class:`Popen` class have the following methods:
 
 The following attributes are also available:
 
+.. warning::
+
+   Use :meth:`communicate` rather than ``.stdin.write()``, ``.stdout.read()`` or
+   ``.stderr.read`` to avoid deadlocks due to any of the other pipe buffers
+   filling up and blocking the child process.
+
+
 .. attribute:: Popen.stdin
 
    If the *stdin* argument is ``PIPE``, this attribute is a file object that
    provides input to the child process.  Otherwise, it is ``None``.
 
-   warning:: Use :meth:`communicate` rather than .stdin.write() to avoid
-   deadlocks due to any of the other pipe buffers filling up and blocking the
-   child process.
-
 
 .. attribute:: Popen.stdout
 
    If the *stdout* argument is ``PIPE``, this attribute is a file object that
    provides output from the child process.  Otherwise, it is ``None``.
 
-   warning:: Use :meth:`communicate` rather than .stdout.read() to avoid
-   deadlocks due to any of the other pipe buffers filling up and blocking the
-   child process.
-
 
 .. attribute:: Popen.stderr
 
    If the *stderr* argument is ``PIPE``, this attribute is file object that
    provides error output from the child process.  Otherwise, it is ``None``.
 
-   warning:: Use :meth:`communicate` rather than .stderr.read() to avoid
-   deadlocks due to any of the other pipe buffers filling up and blocking the
-   child process.
-
 
 .. attribute:: Popen.pid
 
-- 
2.40.0