From: Berker Peksag <berker.peksag@gmail.com>
Date: Mon, 23 Jul 2018 05:37:47 +0000 (+0300)
Subject: bpo-940286: Fix pydoc to show cross refs correctly (GH-8390)
X-Git-Tag: v3.8.0a1~1340
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d04f46c59f1d07d9bcc0ba910741296ac88d370d;p=python

bpo-940286: Fix pydoc to show cross refs correctly (GH-8390)
---

diff --git a/Lib/pydoc.py b/Lib/pydoc.py
index 199745ca6f..8a6b27b16e 100644
--- a/Lib/pydoc.py
+++ b/Lib/pydoc.py
@@ -2028,14 +2028,15 @@ module "pydoc_data.topics" could not be found.
         except KeyError:
             self.output.write('no documentation found for %s\n' % repr(topic))
             return
-        pager(doc.strip() + '\n')
+        doc = doc.strip() + '\n'
         if more_xrefs:
             xrefs = (xrefs or '') + ' ' + more_xrefs
         if xrefs:
             import textwrap
             text = 'Related help topics: ' + ', '.join(xrefs.split()) + '\n'
             wrapped_text = textwrap.wrap(text, 72)
-            self.output.write('\n%s\n' % ''.join(wrapped_text))
+            doc += '\n%s\n' % '\n'.join(wrapped_text)
+        pager(doc)
 
     def _gettopic(self, topic, more_xrefs=''):
         """Return unbuffered tuple of (topic, xrefs).
diff --git a/Misc/NEWS.d/next/Library/2018-07-22-07-59-32.bpo-940286.NZTzyc.rst b/Misc/NEWS.d/next/Library/2018-07-22-07-59-32.bpo-940286.NZTzyc.rst
new file mode 100644
index 0000000000..678ac7a122
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2018-07-22-07-59-32.bpo-940286.NZTzyc.rst
@@ -0,0 +1,2 @@
+pydoc's ``Helper.showtopic()`` method now prints the cross references of a
+topic correctly.