Chapter 5 - GCC Pass 2: Add check for properly functioning PTYs.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2870 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

chapter05/gcc-pass2-inst.xml

@@ -3,13 +3,26 @@
 <sect2>
 <title>Re-installation of GCC</title>
 
-<para>The tools required to test GCC and Binutils are installed now
-(Expect, Tcl and DejaGnu). We can continue on rebuilding GCC and Binutils,
-link them against the new Glibc, and test them properly. One thing to note,
-however, is that these test suites are highly dependent on the features
-supported by your host distribution.  Most notably, a host distribution
-which does not properly support the devpts filesystem will cause most of
-these tests to fail.</para>
+<para>The tools required to test GCC and Binutils are installed now (Tcl, Expect
+and DejaGnu). We can continue on rebuilding GCC and Binutils, link them against
+the new Glibc, and test them properly. One thing to note, however, is that these
+test suites are highly dependent on properly functioning pseudo terminals (PTYs)
+which are provided by your host distribution. These days, PTYs are most commonly
+implemented via the <emphasis>devpts</emphasis> file system. You can quickly
+check if your host system is set up correctly in this regard by performing a
+simple test:</para>
+
+<para><screen><userinput>expect -c "spawn ls"</userinput></screen></para>
+
+<para>If you receive the message:</para>
+
+<para><screen>The system has no more ptys.  Ask your system administrator to create more.</screen></para>
+
+<para>Your host distribution is not set up for proper PTY operation. In this
+case there is no point in running the test suites for GCC and Binutils until you
+are able to resolve the issue. You can consult the LFS Wiki at
+<ulink url="http://wiki.linuxfromscratch.org"/> for more information on how to
+get PTYs working.</para>
 
 <note><para>It's worth pointing out that the GCC test suite we run in this
 section is considered not as critical as the one we run in Chapter 6.</para></note>