- backport portions of SF patch #700798: fixes and cleanups for descriptor info

- use a TeX "tie" to prevent word-wrapping in "section x.y"-like text

diff --git a/Doc/ref/ref3.tex b/Doc/ref/ref3.tex
index 0ee6955cf84ec7cd27607059a57dfa2110b7eac2..3553c09d2ab98d95327ebd89d6f1a6b290cdb11c 100644 (file)
--- a/Doc/ref/ref3.tex
+++ b/Doc/ref/ref3.tex
@@ -388,7 +388,7 @@ comparison: if two numbers compare equal (e.g., \code{1} and
 dictionary entry.
 
 Dictionaries are mutable; they can be created by the
-\code{\{...\}} notation (see section \ref{dict}, ``Dictionary
+\code{\{...\}} notation (see section~\ref{dict}, ``Dictionary
 Displays'').
 
 The extension modules \module{dbm}\refstmodindex{dbm},
@@ -399,7 +399,7 @@ provide additional examples of mapping types.
 
 \item[Callable types]
 These\obindex{callable} are the types to which the function call
-operation (see section \ref{calls}, ``Calls'') can be applied:
+operation (see section~\ref{calls}, ``Calls'') can be applied:
 \indexii{function}{call}
 \index{invocation}
 \indexii{function}{argument}
@@ -408,7 +408,7 @@ operation (see section \ref{calls}, ``Calls'') can be applied:
 
 \item[User-defined functions]
 A user-defined function object is created by a function definition
-(see section \ref{function}, ``Function definitions'').  It should be
+(see section~\ref{function}, ``Function definitions'').  It should be
 called with an argument
 list containing the same number of items as the function's formal
 parameter list.
@@ -576,8 +576,8 @@ is a shorthand for \code{x.__call__(arguments)}.
 \end{description}
 
 \item[Modules]
-Modules are imported by the \keyword{import} statement (see section
-\ref{import}, ``The \keyword{import} statement'').
+Modules are imported by the \keyword{import} statement (see
+section~\ref{import}, ``The \keyword{import} statement'').
 A module object has a namespace implemented by a dictionary object
 (this is the dictionary referenced by the func_globals attribute of
 functions defined in the module).  Attribute references are translated
@@ -612,8 +612,8 @@ library file.
 \indexii{module}{namespace}
 
 \item[Classes]
-Class objects are created by class definitions (see section
-\ref{class}, ``Class definitions'').
+Class objects are created by class definitions (see
+section~\ref{class}, ``Class definitions'').
 A class has a namespace implemented by a dictionary object.
 Class attribute references are translated to
 lookups in this dictionary,
@@ -683,7 +683,7 @@ instance dictionary directly.
 
 Class instances can pretend to be numbers, sequences, or mappings if
 they have methods with certain special names.  See
-section \ref{specialnames}, ``Special method names.''
+section~\ref{specialnames}, ``Special method names.''
 \obindex{numeric}
 \obindex{sequence}
 \obindex{mapping}
@@ -833,7 +833,7 @@ for an exception handler unwinds the execution stack, at each unwound
 level a traceback object is inserted in front of the current
 traceback.  When an exception handler is entered, the stack trace is
 made available to the program.
-(See section \ref{try}, ``The \code{try} statement.'')
+(See section~\ref{try}, ``The \code{try} statement.'')
 It is accessible as \code{sys.exc_traceback}, and also as the third
 item of the tuple returned by \code{sys.exc_info()}.  The latter is
 the preferred interface, since it works correctly when the program is