Add some information on the use of \verbatiminput to display sources from

an external file.

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 22757979e5e28307db99f028917bc1f0a4563504..c271e354222d9384599a5d857ed368804ed5b177 100644 (file)
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -611,6 +611,21 @@ This \UNIX\ is also followed by a space.
     non-Python code and non-code displays.  There should be no blank
     lines at the top or bottom of any \env{verbatim} display.
 
+    Longer displays of verbatim text may be included by storing the
+    example text in an external file containing only plain text.  The
+    file may be included using the standard \macro{verbatiminput}
+    macro; this macro takes a single argument naming the file
+    containing the text.  For example, to include the Python source
+    file \file{example.py}, use:
+
+\begin{verbatim}
+\verbatiminput{example.py}
+\end{verbatim}
+
+    Use of \macro{verbatiminput} allows easier use of special editing
+    modes for the included file.  The file should be placed in the
+    same directory as the \LaTeX{} files for the document.
+
     The Python Documentation Special Interest Group has discussed a
     number of approaches to creating pretty-printed code displays and
     interactive sessions; see the Doc-SIG area on the Python Web site