New Q: "full screen apps on remote machines misbehave"; a short

lesson on the importance of TERM.

PR: 7012

FAQ/troubleshoot.sgml

@@ -1,4 +1,4 @@
-<!-- $Id: troubleshoot.sgml,v 1.3 1998-05-19 01:48:11 jkh Exp $ -->
+<!-- $Id: troubleshoot.sgml,v 1.4 1998-06-22 10:17:55 jkoshy Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
   <sect>
@@ -402,5 +402,25 @@
       usenet/news.answers/mail/sendmail-faq" as the body of the
       message.
 
+    <sect1>
+      <heading>Full screen applications on remote machines misbehave!
+      </heading>
+      <p>The remote machine may be setting your terminal type
+	to something other than the <tt>cons25</tt> terminal type used 
+	by the FreeBSD console.
+      <p>There are a number of work-arounds for this problem:
+	<itemize>
+	<item>After logging on to the remote machine, set your TERM shell 
+	  variable to either <tt>ansi</tt> or <tt>sco</tt>.
+	<item>Use a VT100 emulator like <htmlurl 
+	 url="http://www.freebsd.org/cgi/ports.cgi?screen-" name="screen"> 
+	 locally.  <tt>screen</tt> offers you the ability to run
+         multiple concurrent sessions from one terminal, and is a neat
+	 program in its own right.
+	<item>Install the <tt>cons25</tt> terminal database entry on 
+	  the remote machine.
+	<item>Fire up X and login to the remote machine from an 
+	  <tt>xterm</tt>.
+	</itemize>
   </sect>