summaryrefslogtreecommitdiffstats
path: root/Doc/ref
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2001-11-28 07:26:15 (GMT)
committerFred Drake <fdrake@acm.org>2001-11-28 07:26:15 (GMT)
commitc37b65ee106352c00ab1615b2bac0a5b9a720137 (patch)
tree974c5881da81256b67ad9879435c80c2c739a83e /Doc/ref
parent00859c053857437b635ba9e813f46e884f3aecb4 (diff)
downloadcpython-c37b65ee106352c00ab1615b2bac0a5b9a720137.zip
cpython-c37b65ee106352c00ab1615b2bac0a5b9a720137.tar.gz
cpython-c37b65ee106352c00ab1615b2bac0a5b9a720137.tar.bz2
Clean up some markup cruft. A number of the macros that take no
parameters (like \UNIX) are commonly entered using an empty group to separate the markup from a following inter-word space; this is not needed when the next character is punctuation, or the markup is the last thing in the enclosing group. These cases were marked inconsistently; the empty group is now *only* used when needed.
Diffstat (limited to 'Doc/ref')
-rw-r--r--Doc/ref/ref1.tex2
-rw-r--r--Doc/ref/ref2.tex14
-rw-r--r--Doc/ref/ref3.tex6
3 files changed, 11 insertions, 11 deletions
diff --git a/Doc/ref/ref1.tex b/Doc/ref/ref1.tex
index d6bb8b2..4aae253 100644
--- a/Doc/ref/ref1.tex
+++ b/Doc/ref/ref1.tex
@@ -75,7 +75,7 @@ characters. A phrase between angular brackets (\code{<...>}) gives an
informal description of the symbol defined; e.g., this could be used
to describe the notion of `control character' if needed.
\index{lexical definitions}
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
Even though the notation used is almost the same, there is a big
difference between the meaning of lexical and syntactic definitions:
diff --git a/Doc/ref/ref2.tex b/Doc/ref/ref2.tex
index 8b96055..7faaf01 100644
--- a/Doc/ref/ref2.tex
+++ b/Doc/ref/ref2.tex
@@ -14,7 +14,7 @@ insert 8-bit characters in string literals is by using octal or
hexadecimal escape sequences.
The run-time character set depends on the I/O devices connected to the
-program but is generally a superset of \ASCII{}.
+program but is generally a superset of \ASCII.
\strong{Future compatibility note:} It may be tempting to assume that the
character set for 8-bit characters is ISO Latin-1 (an \ASCII{}
@@ -52,7 +52,7 @@ by following the explicit or implicit \emph{line joining} rules.
\subsection{Physical lines\label{physical}}
A physical line ends in whatever the current platform's convention is
-for terminating lines. On \UNIX{}, this is the \ASCII{} LF (linefeed)
+for terminating lines. On \UNIX, this is the \ASCII{} LF (linefeed)
character. On DOS/Windows, it is the \ASCII{} sequence CR LF (return
followed by linefeed). On Macintosh, it is the \ASCII{} CR (return)
character.
@@ -142,7 +142,7 @@ turn is used to determine the grouping of statements.
First, tabs are replaced (from left to right) by one to eight spaces
such that the total number of characters up to and including the
replacement is a multiple of
-eight (this is intended to be the same rule as used by \UNIX{}). The
+eight (this is intended to be the same rule as used by \UNIX). The
total number of spaces preceding the first non-blank character then
determines the line's indentation. Indentation cannot be split over
multiple physical lines using backslashes; the whitespace up to the
@@ -308,7 +308,7 @@ Literals are notations for constant values of some built-in types.
String literals are described by the following lexical definitions:
\index{string literal}
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
\begin{productionlist}
\production{stringliteral}
{[\token{stringprefix}](\token{shortstring} | \token{longstring})}
@@ -388,7 +388,7 @@ to those used by Standard C. The recognized escape sequences are:
\lineii{\e\var{ooo}} {\ASCII{} character with octal value \var{ooo}}
\lineii{\e x\var{hh}} {\ASCII{} character with hex value \var{hh}}
\end{tableii}
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
As in Standard C, up to three octal digits are accepted. However,
exactly two hex digits are taken in hex escapes.
@@ -596,7 +596,7 @@ sequence of three periods has a special meaning as an ellipsis in slices.
The second half of the list, the augmented assignment operators, serve
lexically as delimiters, but also perform an operation.
-The following printing ASCII characters have special meaning as part
+The following printing \ASCII{} characters have special meaning as part
of other tokens or are otherwise significant to the lexical analyzer:
\begin{verbatim}
@@ -606,7 +606,7 @@ of other tokens or are otherwise significant to the lexical analyzer:
The following printing \ASCII{} characters are not used in Python. Their
occurrence outside string literals and comments is an unconditional
error:
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
\begin{verbatim}
@ $ ?
diff --git a/Doc/ref/ref3.tex b/Doc/ref/ref3.tex
index c8edde5..9176ad1 100644
--- a/Doc/ref/ref3.tex
+++ b/Doc/ref/ref3.tex
@@ -279,14 +279,14 @@ read from a file.
\obindex{string}
\index{character}
\index{byte}
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
-(On systems whose native character set is not \ASCII{}, strings may use
+(On systems whose native character set is not \ASCII, strings may use
EBCDIC in their internal representation, provided the functions
\function{chr()} and \function{ord()} implement a mapping between \ASCII{} and
EBCDIC, and string comparison preserves the \ASCII{} order.
Or perhaps someone can propose a better rule?)
-\index{ASCII@\ASCII{}}
+\index{ASCII@\ASCII}
\index{EBCDIC}
\index{character set}
\indexii{string}{comparison}