gh-65824: Improve the "less" prompt in pydoc (GH-116050)

serhiy-storchaka · web-flow · commit 0704166f9a9c · 2024-03-01T10:03:32.000+02:00
Output the line number, the percentage and the help about how to get help
or quit the pager.

Inspired by the GNU man.
diff --git a/Lib/pydoc.py b/Lib/pydoc.py
@@ -1685,8 +1685,17 @@ def plain(text):
 def pipepager(text, cmd):
     """Page through text by feeding it to another program."""
     import subprocess
+    env = os.environ.copy()
+    prompt_string = (
+        ' '
+        '?ltline %lt?L/%L.'
+        ':byte %bB?s/%s.'
+        '.'
+        '?e (END):?pB %pB\\%..'
+        ' (press h for help or q to quit)')
+    env['LESS'] = '-RmPm{0}$PM{0}$'.format(prompt_string)
     proc = subprocess.Popen(cmd, shell=True, stdin=subprocess.PIPE,
-                            errors='backslashreplace')
+                            errors='backslashreplace', env=env)
     try:
         with proc.stdin as pipe:
             try:
diff --git a/Misc/NEWS.d/next/Library/2024-02-28-17-04-28.gh-issue-65824.gG8KR1.rst b/Misc/NEWS.d/next/Library/2024-02-28-17-04-28.gh-issue-65824.gG8KR1.rst
@@ -0,0 +1 @@
+Improve the ``less`` prompt in :mod:`pydoc`.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+Improve the ``less`` prompt in :mod:`pydoc`.