code duplication
[netris.git] / FAQ
diff --git a/FAQ b/FAQ
index 9dd05196d016e19a15fcb1a78157412fcca56039..f526e91754a174ee68b3337b162f5d63cee431fc 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -2,11 +2,9 @@
 # Netris
 # Frequently asked questions
 #
 # Netris
 # Frequently asked questions
 #
-# $Id: FAQ,v 1.1 1995/07/11 07:50:43 mhw Exp $
-#
 
 
-Contents
-========
+Questions
+=========
 [1] Where can I find the latest version?
 [2] The pieces look bizarre in my xterm window, and don't erase
     properly.  What's up?
 [1] Where can I find the latest version?
 [2] The pieces look bizarre in my xterm window, and don't erase
     properly.  What's up?
@@ -17,22 +15,23 @@ Contents
     -c player?
 [6] I'm using a slow terminal, and the game response is sluggish.
     What can I do?
     -c player?
 [6] I'm using a slow terminal, and the game response is sluggish.
     What can I do?
+[7] Why can't my terminal hide the cursor?
+[8] Occasionally when clearing a line, the display jerks, scrolling
+    very awkwardly.  How can I fix it?
 
 Answers
 =======
 [1] Where can I find the latest version?
 
 
 Answers
 =======
 [1] Where can I find the latest version?
 
-    My machine doesn't currently have a constant hostname, but you can
-    usually find the hostname from `finger mhw@cs.brown.edu`, at least
-    until the Fall of 1995.
-
-    If you find my machine, you can get the latest version via
-    anonymous ftp from the /pub directory.  If anonymous ftp isn't
-    working, it's probably not my machine, so please don't badger it
-    with lots of retry attempts.
+    ftp://ftp.netris.org/pub/netris/
 
 
-    Unfortunately that is not a permanent site.  If that machine
-    doesn't exist, try mailing me.
+    The latest version is available via anonymous ftp from
+    ftp.netris.org in /pub/netris.
+    
+    Unfortunately this machine is currently on the far end of a
+    14.4kbps modem connection, and may go away at any time without
+    notice, but I'll do my best to keep it up.  If you have trouble
+    contacting the ftp server, try mailing me at <mhw@netris.org>.
 
 [2] The pieces look bizarre in my xterm window, and don't erase
     properly.  What's up?
 
 [2] The pieces look bizarre in my xterm window, and don't erase
     properly.  What's up?
@@ -48,15 +47,15 @@ Answers
     example, I use 6x10 font for xterms, and here are the relevant lines
     from my xterm.
 
     example, I use 6x10 font for xterms, and here are the relevant lines
     from my xterm.
 
-    txterm*font:       6x10
-    txterm*boldFont:   6x10
+    txterm*font:     6x10
+    txterm*boldFont: 6x10
 
     Make sure you capitalize the F in "boldFont"
 
 [3] If I drop a piece and then slide it off a cliff, shouldn't
     it automatically drop again?
 
 
     Make sure you capitalize the F in "boldFont"
 
 [3] If I drop a piece and then slide it off a cliff, shouldn't
     it automatically drop again?
 
-    Try the -D option.
+    Try the -d option.
 
 [4] When I try to play a networked game, it just hangs.
 
 
 [4] When I try to play a networked game, it just hangs.
 
@@ -91,7 +90,38 @@ Answers
 
     Try the -S option.  This disables use of standout mode (bold/inverse),
     which require control sequences to be sent twice (or more) per line.
 
     Try the -S option.  This disables use of standout mode (bold/inverse),
     which require control sequences to be sent twice (or more) per line.
-    This looks nice, but can make the game unplayable on a slow terminal.
+    Standout mode makes the pieces look much more like blocks, but can
+    make the game unplayable on a slow terminal.
 
     Also, you can type 's' to toggle spying (updating your view of the
     opponent's board).
 
     Also, you can type 's' to toggle spying (updating your view of the
     opponent's board).
+
+[7] Why can't my terminal hide the cursor?
+
+    Netris uses the termcap library to look up the "vi" and "ve"
+    capabilities, which make the cursor invisible/visible
+    respectively.  These capabilities aren't very consistently
+    reported among un*xes, so I use compiled-in vt220 codes for
+    several vt100-like terminals.  Most emulators probably won't
+    support the codes, but they'll probably ignore them quietly.
+
+    Try setting the TERM environment variable to "vt100" or "vt220"
+    before running Netris.  If that doesn't work, your terminal
+    probably doesn't support cursor invisibility.
+
+[8] Occasionally when clearing a line, the display jerks, scrolling
+    very awkwardly.  How can I fix it?
+
+    You can try running ./configure with the "--curses-hack" option
+    and recompile.  This utilizes a non-portable hack which will only
+    work with certain curses libraries, so it's disabled by default.
+
+    All screen updating is done by your curses library, which means
+    it's not something that Netris can control.  Netris never tells
+    curses to scroll, but curses does so automatically in order to
+    optimize screen updates.  This hack modifies curses's internal
+    variables, making it think that your terminal doesn't know how to
+    region-scroll.
+
+
+# vi: tw=70