Wrap some long lines.
Note that \file and \filenq do not work inside section titles.
diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 7b7f157..334dfdb 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -97,15 +97,24 @@
three-character names:
\begin{tableii}{p{.75in}|p{3in}}{filenq}{Directory}{Document Title}
- \lineii{api/}{\citetitle[../api/api.html]{The Python/C API}}
- \lineii{dist/}{\citetitle[../dist/dist.html]{Distributing Python Modules}}
- \lineii{doc/}{\citetitle[../doc/doc.html]{Documenting Python}}
- \lineii{ext/}{\citetitle[../ext/ext.html]{Extending and Embedding the Python Interpreter}}
- \lineii{inst/}{\citetitle[../inst/inst.html]{Installing Python Modules}}
- \lineii{lib/}{\citetitle[../lib/lib.html]{Python Library Reference}}
- \lineii{mac/}{\citetitle[../mac/mac.html]{Macintosh Module Reference}}
- \lineii{ref/}{\citetitle[../ref/ref.html]{Python Reference Manual}}
- \lineii{tut/}{\citetitle[../tut/tut.html]{Python Tutorial}}
+ \lineii{api/}
+ {\citetitle[../api/api.html]{The Python/C API}}
+ \lineii{dist/}
+ {\citetitle[../dist/dist.html]{Distributing Python Modules}}
+ \lineii{doc/}
+ {\citetitle[../doc/doc.html]{Documenting Python}}
+ \lineii{ext/}
+ {\citetitle[../ext/ext.html]{Extending and Embedding the Python Interpreter}}
+ \lineii{inst/}
+ {\citetitle[../inst/inst.html]{Installing Python Modules}}
+ \lineii{lib/}
+ {\citetitle[../lib/lib.html]{Python Library Reference}}
+ \lineii{mac/}
+ {\citetitle[../mac/mac.html]{Macintosh Module Reference}}
+ \lineii{ref/}
+ {\citetitle[../ref/ref.html]{Python Reference Manual}}
+ \lineii{tut/}
+ {\citetitle[../tut/tut.html]{Python Tutorial}}
\end{tableii}
\term{Format-Specific Output}
@@ -421,7 +430,7 @@
\begin{macrodesc}{e}{}
Produces a backslash. This is convenient in \macro{code} and
- similar macros, and is only defined there. The create a
+ similar macros, and is only defined there. To create a
backslash in ordinary text (such as the contents of the
\macro{file} macro), use the standard \macro{textbackslash} macro.
\end{macrodesc}
@@ -448,12 +457,16 @@
The name of a file or directory. In the PDF and PostScript
outputs, single quotes and a font change are used to indicate
the file name, but no quotes are used in the HTML output.
+ \strong{Warning:} The \macro{file} macro cannot be used in the
+ content of a section title due to processing limitations.
\end{macrodesc}
\begin{macrodesc}{filenq}{\p{file or dir}}
Like \macro{file}, but single quotes are never used. This can
be used in conjunction with tables if a column will only contain
file or directory names.
+ \strong{Warning:} The \macro{filenq} macro cannot be used in the
+ content of a section title due to processing limitations.
\end{macrodesc}
\begin{macrodesc}{function}{\p{name}}