From d1fb77970df2d58e56a6d4db7c06711101c0a9ac Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Mon, 17 May 1999 16:33:54 +0000
Subject: [PATCH] Document \e, \url. Add a few more comments about mkhowto.

Based on comments from Albert <hat@se-46.wpa.wtb.tue.nl>.
---
 Doc/doc/doc.tex | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/Doc/doc/doc.tex b/Doc/doc/doc.tex
index 9fbcc8137bd..2370a872b27 100644
--- a/Doc/doc/doc.tex
+++ b/Doc/doc/doc.tex
@@ -365,6 +365,11 @@ distribution, to create or maintain whole documents or sections.
       entries are generated.)
     \end{macrodesc}
 
+    \begin{macrodesc}{e}{}
+      Produces a backslash.  This is convenient in \macro{code} and
+      similar macros.
+    \end{macrodesc}
+
     \begin{macrodesc}{email}{\p{address}}
       An email address.  Note that this is \emph{not} hyperlinked in
       any of the possible output formats.
@@ -477,6 +482,17 @@ distribution, to create or maintain whole documents or sections.
       font.
     \end{macrodesc}
 
+    \begin{macrodesc}{url}{\p{url}}
+      A URL (or URN).  The URL will be presented as text.  In the HTML 
+      and PDF formatted versions, the URL will also be a hyperlink.
+      This can be used when referring to external resources.  Note
+      that many characters are special to \LaTeX{} and this macro
+      does not always do the right thing.  In particular, the tilde
+      character (\character{\~}) is mis-handled; encoding it as a
+      hex-sequence does work, use \samp{\%7e} in place of the tilde
+      character.
+    \end{macrodesc}
+
     \begin{macrodesc}{var}{\p{name}}
       The name of a variable or formal parameter in running text.
     \end{macrodesc}
@@ -688,7 +704,7 @@ distribution, to create or maintain whole documents or sections.
       This should be used in the document preamble if a ``Module
       Index'' is desired for a document containing reference material
       on many modules.  This causes a data file
-      \code{lib\macro{jobname}.idx} to be created from the
+      \code{lib\var{jobname}.idx} to be created from the
       \macro{declaremodule} macros.  This file can be processed by the
       \program{makeindex} program to generate a file which can be
       \macro{input} into the document at the desired location of the
@@ -911,6 +927,12 @@ distribution, to create or maintain whole documents or sections.
 	tree.  Use \program{mkhowto --help} for a list of command line 
 	options.
 
+        \program{mkhowto} can be used for both \code{howto} and
+        \code{manual} class documents.  (For the later, be sure to get 
+	the latest version from the Python CVS repository rather than
+        the version distributed in the \file{latex-1.5.2.tgz} source
+	archive.)
+
 	XXX  Need more here.
     \end{description}
 
@@ -987,6 +1009,7 @@ distribution, to create or maintain whole documents or sections.
     Comments and bug reports on the standard documents should be sent
     to \email{python-docs@python.org}.  This may include comments
     about formatting, content, grammatical and spelling errors, or
-    this document.
+    this document.  You can also send comments on this document
+    directly to the author at \email{fdrake@acm.org}.
 
 \end{document}