Don't point readers to rand, point to random! And make it a hyperlink

while you're at it.

Also, when discussing order of reading, make it clear that chapter 2
is assumed background material for the remainder of the manual.
That's needed for terminology if nothing else!

diff --git a/Doc/lib/libintro.tex b/Doc/lib/libintro.tex
index cc0fd868d5357bda42eb4da0d47e35609f0a3a94..a4bc67e2e374a305da9ecc0c7492fe84ed3e6361 100644 (file)
--- a/Doc/lib/libintro.tex
+++ b/Doc/lib/libintro.tex
@@ -43,6 +43,10 @@ read it like a novel --- you can also browse the table of contents (in
 front of the manual), or look for a specific function, module or term
 in the index (in the back).  And finally, if you enjoy learning about
 random subjects, you choose a random page number (see module
-\module{rand}) and read a section or two.
+\refmodule{random}) and read a section or two.  Regardless of the
+order in which you read the sections of this manual, it helps to start 
+with chapter \ref{builtin}, ``Built-in Types, Exceptions and
+Functions,'' as the remainder of the manual assumes familiarity with
+this material.
 
 Let the show begin!