FAQ

   1 #
   2 # Netris
   3 # Frequently asked questions
   4 #
   5 # $Id: FAQ,v 1.4 1999/05/16 06:56:21 mhw Exp $
   6 #
   7
   8 Questions
   9 =========
  10 [1] Where can I find the latest version?
  11 [2] The pieces look bizarre in my xterm window, and don't erase
  12     properly.  What's up?
  13 [3] If I drop a piece and then slide it off a cliff, shouldn't
  14     it automatically drop again?
  15 [4] When I try to play a networked game, it just hangs.
  16 [5] Is the game fair?  Is there an advantage to being the -w or the
  17     -c player?
  18 [6] I'm using a slow terminal, and the game response is sluggish.
  19     What can I do?
  20 [7] Why can't my terminal hide the cursor?
  21 [8] Occasionally when clearing a line, the display jerks, scrolling
  22     very awkwardly.  How can I fix it?
  23
  24 Answers
  25 =======
  26 [1] Where can I find the latest version?
  27
  28     ftp://ftp.netris.org/pub/netris/
  29
  30     The latest version is available via anonymous ftp from
  31     ftp.netris.org in /pub/netris.
  32
  33     Unfortunately this machine is currently on the far end of a
  34     14.4kbps modem connection, and may go away at any time without
  35     notice, but I'll do my best to keep it up.  If you have trouble
  36     contacting the ftp server, try mailing me at <mhw@netris.org>.
  37
  38 [2] The pieces look bizarre in my xterm window, and don't erase
  39     properly.  What's up?
  40
  41     Try disabling standout mode with the -S option.  If this fixes it,
  42     it's probably because the bold font on your xterm is set wrong.
  43     It's a good idea to fix it, since the blocks look much nicer when
  44     they're inverse.
  45
  46     If the blocks don't erase correctly and are drawn larger than normal
  47     characters, check your .Xdefaults file.  If you set the "font", make
  48     sure you also set the "boldFont" to something of the same size.  For
  49     example, I use 6x10 font for xterms, and here are the relevant lines
  50     from my xterm.
  51
  52     txterm*font:        6x10
  53     txterm*boldFont:    6x10
  54
  55     Make sure you capitalize the F in "boldFont"
  56
  57 [3] If I drop a piece and then slide it off a cliff, shouldn't
  58     it automatically drop again?
  59
  60     Try the -D option.
  61
  62 [4] When I try to play a networked game, it just hangs.
  63
  64     There are two possibilities.  First, versions 0.1d? are incompatible
  65     with current versions.  This is unfortunate, but remember, those were
  66     very developmental versions.  I needed to fix up the protocol, and
  67     I didn't want a whole bunch of messy compatibility code (at least
  68     not yet :-)  Ask your opponent to get the latest version.
  69
  70     The other possibility is that you've typed in the wrong hostname, or
  71     there's a port number mismatch, if either of you used the -p option.
  72
  73 [5] Is the game fair?  Is there an advantage to being the -w or the
  74     -c player?
  75
  76     The game is fair.  The game is completely symmetric once the
  77     connection is established.  Furthermore, a random number seed is
  78     exchanged at the start of the game, so both players will get the
  79     same pieces.
  80
  81     There is a built-in random number generator, so even if the C
  82     library on your system has a non-standard generator, both
  83     players will still get the same sequence.
  84
  85     There is no attempt to synchronize the start of the game
  86     accurately for networks with high latency.  This should be fixed
  87     at some point, but I doubt such a small head start makes much
  88     difference for a game lasting several minutes.
  89
  90 [6] I'm using a slow terminal, and the game response is sluggish.
  91     What can I do?
  92
  93     Try the -S option.  This disables use of standout mode (bold/inverse),
  94     which require control sequences to be sent twice (or more) per line.
  95     Standout mode makes the pieces look much more like blocks, but can
  96     make the game unplayable on a slow terminal.
  97
  98     Also, you can type 's' to toggle spying (updating your view of the
  99     opponent's board).
 100
 101 [7] Why can't my terminal hide the cursor?
 102
 103     Netris uses the termcap library to look up the "vi" and "ve"
 104     capabilities, which make the cursor invisible/visible
 105     respectively.  These capabilities aren't very consistently
 106     reported among un*xes, so I use compiled-in vt220 codes for
 107     several vt100-like terminals.  Most emulators probably won't
 108     support the codes, but they'll probably ignore them quietly.
 109
 110     Try setting the TERM environment variable to "vt100" or "vt220"
 111     before running Netris.  If that doesn't work, your terminal
 112     probably doesn't support cursor invisibility.
 113
 114 [8] Occasionally when clearing a line, the display jerks, scrolling
 115     very awkwardly.  How can I fix it?
 116
 117     You can try running ./Configure with the "--curses-hack" option
 118     and recompile.  This utilizes a non-portable hack which will only
 119     work with certain curses libraries, so it's disabled by default.
 120
 121     All screen updating is done by your curses library, which means
 122     it's not something that Netris can control.  Netris never tells
 123     curses to scroll, but curses does so automatically in order to
 124     optimize screen updates.  This hack modifies curses's internal
 125     variables, making it think that your terminal doesn't know how to
 126     region-scroll.
 127
 128
 129 # vi: tw=70 ai