From bb3746e44a01294f0f61964e8b57d2ba8dd8388b Mon Sep 17 00:00:00 2001
From: Gabor Pali <pgj@FreeBSD.org>
Date: Sat, 21 Jun 2008 07:37:52 +0000
Subject: [PATCH] Update Question 10.18: - Rewrite "lots of" as "lot of"
 (suggested by trhodes) - Mark up telnet, ssh, screen with <command> - Fix
 broken paragraphs (suggested by gabor) - Remove MAKEDEV(8) method - Update
 "pseudo-device" kernel option to "device" - Generalize answer - Note users
 have 256 ptys beginning from FreeBSD 6.3 and they   can create 256 more

Reviewed by:  trhodes, danger
Approved by:  gabor
---
 en_US.ISO8859-1/books/faq/book.sgml | 35 +++++++++++++----------------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 9a27832a1f..aa0ae60c49 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -6234,39 +6234,31 @@ options    SYSVMSG          # enable for messaging</programlisting>
 
         <answer>
 
-          <para>If you have lots of telnet, ssh, X, or screen users,
+          <para>If you have lot of <command>telnet</command>, <command>ssh</command>, X, or <command>screen</command> users,
             you will probably run out of pseudoterminals.  Here is how to
             add more:</para>
 
             <procedure>
               <step>
-                <para>Build and install a new kernel with the line</para>
+                <para>Build and install a new kernel with the line in
+                  the configuration file:</para>
 
-                <programlisting>pseudo-device pty 256</programlisting>
-
-                <para>in the configuration file.</para>
-              </step>
-
-              <step>
-                <para>Run the commands</para>
-
-                <screen>&prompt.root; <userinput>cd /dev</userinput>
-&prompt.root; <userinput>sh MAKEDEV pty{1,2,3,4,5,6,7}</userinput></screen>
-
-                <para>to make 256 device nodes for the new terminals.</para>
+                <programlisting>device pty <replaceable>N</replaceable></programlisting>
 
+                <para>where <replaceable>N</replaceable> is the number
+                  of requested pseudoterminals.</para>
               </step>
 
               <step>
                 <para>Edit <filename>/etc/ttys</filename> and add lines
-                for each of the 256 terminals. They should match the form
-                of the existing entries, i.e. they look like</para>
+                for each of the <replaceable>N</replaceable> terminals.  They should match the form
+                of the existing entries, i.e. they look like this:</para>
 
                 <programlisting>ttyqc none network</programlisting>
 
                 <para>The order of the letter designations is
-                  <literal>tty[pqrsPQRS][0-9a-v]</literal>, using a
-                  regular expression.  </para>
+                  <literal>tty[pqrsPQRSlmnoLMNO][0123456789abcdefghijklmnopqrstuv]</literal>, using a
+                  regular expression.</para>
               </step>
 
               <step>
@@ -6274,7 +6266,12 @@ options    SYSVMSG          # enable for messaging</programlisting>
                   ready to go.</para>
               </step>
             </procedure>
-        </answer>
+
+	  <note>
+	    <para>Using more than 256 (up to 512) &man.pty.4; devices requires
+	      &os;&nbsp;6.3 or later.</para>
+	  </note>
+       </answer>
       </qandaentry>
 
       <qandaentry>